Escolar Documentos
Profissional Documentos
Cultura Documentos
User Guide
Version 3.5
Copyright 2011 Dell, Inc. All rights reserved. EqualLogic is a registered trademark of Dell, Inc. Dell is a trademark of Dell, Inc. All trademarks and registered trademarks mentioned herein are the property of their respective owners. Information in this document is subject to change without notice. Reproduction in any manner whatsoever without written permission is strictly forbidden. January 2011
Table of Contents
1 Introduction to the PowerShell Tools Types of PowerShell cmdlets Syntax Conventions and Case-Sensitivity Inputs and Outputs for the cmdlets Common Parameters Getting Help on the PowerShell cmdlets 2 Installation Installing the PowerShell Tools on Windows Requirements for Using the PowerShell Interface To Get Started Using the PowerShell Tools: 3 Session cmdlets Connect-EqlGroup cmdlet Disconnect-EqlGroup cmdlet 4 Group Administration cmdlets Group Configuration cmdlets Get-EqlGroupID cmdlet Get-EqlGroupDefaults cmdlet Set-EqlGroupDefaults cmdlet Get-EqlGroupConfiguration cmdlet Set-EqlGroupConfiguration cmdlet Get-EqlMember cmdlet Set-EqlMember cmdlet Get-EqlNetInterface cmdlet Set-EqlNetInterface cmdlet Pool Configuration cmdlets New-EqlPool cmdlet Get-EqlPool cmdlet Set-EqlPool cmdlet 1 1 2 3 3 4 5 5 5 6 7 7 10 13 13 13 14 16 19 21 28 29 32 34 37 37 39 41
iii
Contents
Merge-EqlPool cmdlet Remove-EqlPool cmdlet Local CHAP Account cmdlets New-EqlChapUser cmdlet Get-EqlChapUser cmdlet Set-EqlChapUser cmdlet Remove-EqlChapUser cmdlet 5 Volume Administration Cmdlets Basic cmdlets New-EqlVolume cmdlet Get-EqlVolume cmdlet Set-EqlVolume cmdlet Remove-EqlVolume cmdlet New-EqlVolumeACL cmdlet Get-EqlVolumeACL cmdlet Remove-EqlVolumeACL cmdlet Advanced Volume Administration cmdlets New-EqlVolumeClone cmdlet ConvertTo-EqlTemplateVolume cmdlet ConvertFrom-EqlTemplateVolume cmdlet New-EqlThinClone cmdlet ConvertFrom-EqlThinClone cmdlet New-EqlReplica cmdlet 6 Snapshot Cmdlets New-EqlSnapshot cmdlet Get-EqlSnapshot cmdlet Set-EqlSnapshot cmdlet Restore-EqlSnapshot cmdlet
iv
Contents
Remove-EqlSnapshot cmdlet New-EqlSnapshotClone cmdlet 7 Replication Cmdlets Replication Configuration cmdlets New-EqlReplicationPartner cmdlet Get-EqlReplicationPartner cmdlet Set-EqlReplicationPartner cmdlet Remove-EqlReplicationPartner cmdlet New-EqlReplicaSet cmdlet Get-EqlReplicaSet cmdlet Set-EqlReplicaSet cmdlet Remove-EqlReplicaSet cmdlet Replication Management cmdlets Suspend-EqlReplication cmdlet Resume-EqlReplication cmdlet ConvertTo-EqlPromotedReplicaSet cmdlet ConvertTo-EqlDemotedReplicaSet cmdlet 8 Schedule Cmdlets New-EqlSchedule cmdlet Get-EqlSchedule cmdlet Set-EqlSchedule cmdlet Remove-EqlSchedule cmdlet
112 115 119 119 119 123 125 130 131 135 137 140 142 142 144 146 147 151 151 156 158 164
Preface
This guide provides installation and usage information about the PowerShell Tools.
Audience
The PowerShell Tools documentation is designed for administrators responsible for managing a PS Series group. Administrators are not required to have extensive network or storage system experience. However, it is helpful to understand: Windows PowerShell 2.0 cmdlet usage and scripting. Windows, Windows cluster, and Windows Server operating environment administration. iSCSI initiator operation Basic networking concepts Current network environment Application disk storage requirements
In addition, administrators may find it useful to understand the basic concepts for: Network topologies RAID configurations Disk storage management
Note: Although the PowerShellTools documentation provides examples of using PS
Series storage arrays in some common network configurations, detailed information about setting up a network is beyond its scope.
Organization
The organization of this guide is as follows: Chapter 1, Introduction to the PowerShell Tools provides an overview of the types of PowerShell cmdlets available, and general information regarding inputs, outputs, and common parameters. Chapter 2, Installation describes how to install the PowerShell interface. Chapter 3, Session cmdlets describes cmdlets that deal with creating or terminating a session to a PS Series group. Chapter 4, Group Administration cmdlets describes cmdlets that configure groups, pools, and local CHAP accounts. Chapter 5, Volume Administration Cmdlets describes cmdlets that manage volumes in a PS Series group.
vii
Preface
Chapter 6, Snapshot Cmdlets describes cmdlets that help you create, delete, and manage snapshots. Chapter 7, Replication Cmdlets describes cmdlets that help you configure and manage replication replication between two groups. Chapter 8, Schedule Cmdlets describes all the cmdlets that deal with creating and modifying schedules for taking snapshots and replicas of a volume.
PS Series Software
Firmware - Installed on each array, PS Series firmware allows you to manage your storage environment and provides capabilities such as volume snapshots, cloning, and replication to ensure data hosted on the arrays is protected in the event of an error or disaster. Group Manager GUI: Provides a graphical user interface for managing a group. Group Manager CLI: Provides a command line interface for managing a group.
Manual Transfer Utility (MTU) Runs on Windows and Linux systems and enables you to use physical media to securely transfer large amounts of data to a replication partner, facilitating replication and preventing network congestion.
viii
Preface
Remote Setup Wizard (RSW): Initializes new PS Series arrays, configures host connections to PS Series groups, and configures and manages multipathing. Multipath I/O Device Specific Module (MPIO DSM): Includes a connection awareness-module that understands PS Series network load balancing and facilitates host connections to PS Series volumes. VSS and VDS Provider Services: Allows 3rd party backup software vendors to perform off-host backups. Auto-Snapshot Manager/Microsoft Edition (ASM/ME): ASM/ME is a VSS requesting application that uses PS Series snapshots, cloning, and replication to provide point-in-time protection of critical data for supported applications, including SQL Server, Exchange Server, Hyper-V, and NTFS file shares.
SAN HeadQuarters (SANHQ): Provides centralized monitoring, historical performance trending, and event reporting for multiple PS Series groups.
Current Customers Please Note: You may not be running the latest versions of the tools and software listed above. If you are under a valid warranty or support agreement for your PS Series array, you are entitled to obtain the latest updates and new releases as they become available.
Related Documentation
For detailed information about PS Series arrays, groups, volumes, array software, and host software, see the following documentation:
ix
Preface
Contacting Dell
Dell provides several online and telephone-based support and service options. Availability varies by country and product, and some services might not be available in your area. For customers in the United States, call 800-945-3355. Note: If you do not have access to an Internet connection, contact information is printed on your invoice, packing slip, bill, or Dell product catalog.
Preface
Use the following procedure to contact Dell for sales, technical support, or customer service issues: 1. Visit support.dell.com or the Dell support URL specified in information provided with the Dell product. 2. Select your locale. Use the locale menu or click on the link that specifies your country or region. 3. Select the required service. Click the "Contact Us" link, or select the Dell support service from the list of services provided. 4. Choose your preferred method of contacting Dell support, such as e-mail or telephone.
Online Services
You can learn about Dell products and services using the following procedure: 1. Visit www.dell.com (or the URL specified in any Dell product information). 2. Use the locale menu or click on the link that specifies your country or region.
xi
Volume administration cmdlets Volume Administration cmdlets help manage the volumes in a PSSeries group. They are divided into the following subcategories: Basic: These cmdlets allow you to perform operations such as creating a new volume on a PS Series group, managing access control lists (ACLs) for a volume and its snapshots, retrieving or changing configuration information for volumes on a group, or deleting a volume and all its snapshots, schedules and access control lists (ACLs) from a group. Advanced: These cmdlets allow you to perform operations such as creating a replica or clone of a volume, converting a volume to a template volume, creating a thin clone from a template volume, converting a template volume to a regular volume, or detaching a thin clone volume from its template volume.
Snapshot management cmdlets The Snapshot Management cmdlets allow you to perform operations such as creating a new snapshot, deleting a snapshot, retrieving or changing settings for a snapshot, restoring a volume from a snapshot, and cloning a snapshot.
Snapshots created by the PowerShell Tools are crash consistent, and not application consistent. To create application consistent snapshots, use the Auto-Snapshot ManagerMicrosoft Edition (ASM/ME) console or the ASM CLI. The ASM CLI is a set of commands that you can execute at the Windows command prompt instead of using the ASM/ME GUI for Smart Copy operations. See the Auto-Snapshot Manager User Guide for more information. Replication cmdlets The Replication cmdlets are divided into the following subcategories: Replication Configuration: These cmdlets allow you to perform operations such as setting up replication between two PS Series groups, retrieving or changing the definition of a replication partnership between two groups, canceling a replication partnership between two groups, configuring replication of a volume to a replication site, retrieving or changing settings for a replica set of a volume, and deleting a replica set for a volume. Replication Management: These cmdlets allow you to perform operations such as suspending or resuming replication of a volume, promoting a replica set to a volume, and demoting a replica set to a normal replica set.
Schedule cmdlets The Schedule cmdlets allow you to perform operations such as creating or removing a schedule for taking snapshots or replicas of a specified volume, and changing or retrieving schedule information for a volume.
<string>
[parameter] >
Angle brackets indicate that a specific value (whatever data type is listed within the angle brackets) should be used. For example, <string> means that a character string should be used in the cmdlet syntax and <int> means that an integer should be used. Brackets indicate that the parameter within them is an optional parameter. A greater than symbol represents a Windows system prompt.
Names of volumes, groups, snapshots, pools, members, and schedules are case-sensitive. Further, some cmdlets support only IPv4 addresses while others support either IPv4 or IPv6. For each parameter, the following five properties are listed: Required? Whether or not the parameter is required. Named? Whether the parameter is positional or named. Currently, only named parameters are used. Default value? Whether or not the parameter has a default value. Whether or not the parameter accepts pipeline input.
Whether or not the parameter accepts wildcard characters. Currently, no parameters accept wildcard characters.
See the documentation for a specific cmdlet for more information about that cmdlet.
Common Parameters
All the PowerShell Tool cmdlets support the following parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, and OutVariable. For
more information, type get-help about_commonparameters. For further documentation on these parameters, see the Microsoft Windows PoweShell documentation.
2 Installation
The PowerShell Tools are included in the installation kit for Host Integration Tools 3.5 or later.
command prompt and enter powershell host. You can also launch the PowerShell console and enter host. You must be running a Windows operating system. See the section below for a list of supported Windows operating systems. You must be running PS Series firmware V4.2.0 or later. Some cmdlets may require later versions of the firmware. In order to enable communication between the PS Series group and the PowerShell Tools, you must create a new administrative account or reset the password for any existing administrative account (you can reuse the same password) on the PS Series group. This only needs to be done once for each set of credentials you want to use for each PS Series group.
2 Installation
3. To load the cmdlets into a regular or third-party PowerShell Console, launch the console and execute the PowerShell cmdlet
import-module -name <install path>\EqlPSTools.dll
5. To view the syntax and help with examples for a cmdlet, execute the PowerShell cmdlet
get-help <cmdletname> -full
6. To view the syntax for a cmdlet, execute the cmdlet with the parameter -? 7. Refer to chapters 3 through 8 for complete syntax and descriptive information for all of the cmdlets.
3 Session cmdlets
You must be connected to a PS Series Group to execute any of the cmdlets that require access to a PS Series group. You can use the Connect-EqlGroup and Disconnect-EqlGroup cmdlets to manage sessions to PS Series groups, and to switch between groups. You can also connect to more than one group. To do this, you can use the Connect-EqlGroupcmdlet and specify the group on which a cmdlet should execute. To specify the group, use the GroupName and GroupAddress parameters. If those parameters are not specified, the cmdlet will execute on the current group and not the group on which you want the cmdlets to execute. The current group is the most recent group explicitly specified in a previous cmdlet.
Connect-EqlGroup cmdlet
Creates a session to a PS Series group.
Command Syntax
Connect-EqlGroup -GroupAddress <string> [-Credential <System.Management.Automation.PSCredential>][-Username <string>] [-Password <string>] [-SMTPTimeoutSeconds <uint>] [-SMTPRetryAttempts <uint>][<CommonParameters>]
Command Description
The Connect-EqlGroup cmdlet creates a sessionin the current PowerShell runspaceto a PS Series group and makes it the current group. The group must be specified by its IP address. The administrator name and password must be specified using either the -Credential parameter or the Username and Password parameters. Any subsequent cmdlets in the current PowerShell runspace will perform actions on this group until the Disconnect-EqlGroup cmdlet is executed for this group, or until Connect-EqlGroup is used to connect to another group, or a group is specified for the cmdlet using either the GroupName or GroupAddress parameter.
Note: Using the same administration account username with different passwords to
connect to more than one group is not supported. For example, if you are connected to one group as an administrative user, and then try to connect to another group using the same username but a different password, the connection to the second group will fail with error -29421. To work around this issue, connect to the second group with a different administrative username or reset the password to be the same as on the first group. To change the account credentials, connect to the group using the Group Manager and click on the Administration tab.
Inputs
None. You cannot pipe objects to Connect-EqlGroup.
3 Session cmdlets
Outputs
None. Returns a string acknowledging the successful completion of the cmdlet action. This string includes the name of the group to which the connection was made.
Command Parameters
Parameter: GroupAddress <string>
Specifies the IP Address of a PS Series group for which the user has a valid administrator name and password. This parameter can be either IPv4 or IPv6.
Required?: true Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: Credential <System.Management.Automation.PSCredential>
Specifies a PSCredential object containing the name and password of an administrative user with access to the specified PS Series group. Refer to the PowerShell documentation for PSCredential for alternative methods for initializing the PSCredential object. The Password and Username parameters can be used instead of the Credential parameter.
Required?: true, unless Username and Password are specified. Position?: named Default value?: none Accept pipeline input?: false Accept wildcard characters?: false Parameter: Username <string>
Specifies the name of an administrative user with access to the specified PS Series group. The Credential parameter can be used instead of the Password and Username parameters.
Required?: true, unless Credential is specified. Position?: named Default value?: none Accept pipeline input?: false Accept wildcard characters?: false Parameter: Password <string>
Specifies the password of an administrative user with access to the specified PS Series group. The Credential parameter can be used instead of the Password and Username parameters.
Required?: true, unless Credential is specified. Position?: named Default value?: none Accept pipeline input?: false Accept wildcard characters?: false Parameter: SMTPTimeoutSeconds <uint>
3 Session cmdlets
Required?: false Position?: named Default value?: 60 Accept pipeline input?: false Accept wildcard characters?: false Parameter: SMTPRetryAttempts <uint>
Specifies the number of times to retry an SMTP request if it fails or times out.
Required?: false Position?: named Default value?: 1 Accept pipeline input?: false Accept wildcard characters?: false
Notes
Under some circumstances, especially the first time, you may get the following error when trying to connect to a PS Series Group:
Error -23035 - Group address, admin account, or password is invalid:
This error can be cause by several factors. Try the following corrective actions: 1. Verify that the parameters and values are correct. 2. Verify that you can log onto the Group Manager using these credentials. 3. Verify that all members of the group are runnning the minimum required firmware revision 4.2 or later. 4. Reset the admin account password using the Group Manager to force the reinitialization and clear this condition. You only need to do this once, and you can use the same password.
Examples
Example 1 This command uses the PowerShell Get-Credential cmdlet to pop up a dialog, prompt for a username and password, and create a session to the PS Series group using 10.100.100.10. All subsequent cmdlets in the current PowerShell runspace will execute on the specified group.
C:\PS>Connect-EqlGroup -GroupAddress 10.100.100.10 -Credential (Get-Credential)
Example 2 This command will create a session to the PS Series group using 10.100.100.10 if grpadmin has access to the group and mypassword is valid. All subsequent cmdlets in the current PowerShell runspace will execute on the specified group.
C:\PS>Connect-EqlGroup -GroupAddress 10.100.100.10 -Username grpadmin -Password mypassword
3 Session cmdlets
Related Commands
Disconnect-EqlGroup cmdlet
Disconnect-EqlGroup cmdlet
Terminates the session to a PS Series group to which a connection exists in the current PowerShell runspace.
Command Syntax
Disconnect-EqlGroup [-GroupName <string>] [-GroupAddress <string>] [<CommonParameters>]
Command Description
The Disconnect-EqlGroup cmdlet terminates a session to a PS Series group to which a connection exists in the current PowerShell runspace identified by the group name or its IP address. If you are connected to more than one group, you can specify the target group using either the GroupName or GroupAddress parameter. Any subsequent cmdlets will fail unless a connection to another group exists, or until the Connect-EqlGroup cmdlet is used to create a new group session.
Inputs
None. You cannot pipe objects to Disconnect-EqlGroup.
Outputs
None. Returns a string acknowledging the successful completion of the cmdlet action.
Command Parameters
Parameter: GroupName <string>
Specifies the name of a PS Series group for which a session was created from this PowerShell runspace. The GroupAddress parameter can be used instead of the GroupName parameter.
Required?: true, unless GroupAddress is specified Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: GroupAddress <string>
Specifies the IP address of a PS Series group for which a session was created from this PowerShell runspace. This parameter can be either IPv4 or IPv6. If this parameter is used, the GroupName parameter is not necessary.
10
3 Session cmdlets
Required?: true, unless GroupAddress is specified Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false
Examples
Example 1 This command will terminate the session to MyGroup. All subsequent cmdlets will fail until a new connection is created.
C:\PS>Disconnect-EqlGroup -GroupName MyGroup
Example 2 This command will terminate the session connected to the group at IP address 10.100.100.10. All subsequent cmdlets will fail until a new connection is created.
C:\PS>Disconnect-EqlGroup -GroupAddress 10.100.100.10
Related Commands
Connect-EqlGroup cmdlet
11
Get-EqlGroupID cmdlet
Retrieves the unique identifier for a PS Series group.
Syntax
Get-EqlGroupID [-GroupName <string>] [-GroupAddress <string>] [<CommonParameters>]
Command Description
The Get-EqlGroupID cmdlet retrieves the unique identifier for a PS Series group to which a connection exists in the current PowerShell runspace. If you are connected to more than one group, you can specify the target group using either the GroupName or GroupAddress parameter.
Inputs
None. You cannot pipe objects to Get-EqlGroupID.
Outputs
This command outputs a string containing a Group ID.
Command Parameters
Parameter: GroupName <string>
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. Either this parameter or the GroupName parameter can be used to identify a group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: GroupAddress <string>
13
Specifies the IP address of a PS Series group for which a session was exists in this PowerShell runspace. This parameter can be either IPv4 or IPv6. Either this parameter or the GroupName parameter can be used to identify a Group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false
Example
This command will return the unique Group ID for the group to which a connection exists in the current PowerShell runspace.
C:\PS>Get-EqlGroupID
Related Commands
Connect-EqlGroup cmdlet
Get-EqlGroupDefaults cmdlet
Retrieves the current default value settings for a PS Series group.
Syntax
Get-EqlGroupDefaults [-GroupName <string>] [-GroupAddress <string>][<CommonParameters>]
Command Description
The Get-EqlGroupDefaults cmdlet retrieves the current default value settings for a PS Series group to which a connection exists in the current PowerShell runspace. If you are connected to more than one group, you can specify the target group using either the GroupName or GroupAddress parameter. These defaults include snapshot reserve percent, snapshot warning percent, snapshot space recovery policy, thin provisioning warning percent, thin provisioning set volume offline percent, iSCSI Target name prefix, and use volume name for iSCSI alias. These defaults are used during volume creation if parameters for these values are not specified when the New-Volume cmdlet is executed.
Inputs
None.
Outputs
Interop.EqlPsaMgmtAPI.EQL_PSGROUP_DEFAULT_SPEC
14
You can pipe objects from Get-EqlGroupDefaults to other cmdlets, such as Set-EqlGroupDefaults. Pipe the objects through format-list to filter out parameters that you do not want to use.
Command Parameters
Parameter: GroupName <string>
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. Either this parameter or the GroupName parameter can be used to identify a group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: GroupAddress <string>
Specifies the IP address of a PS Series group for which a session was exists in this PowerShell runspace. This parameter can be either IPv4 or IPv6. Either this parameter or the GroupName parameter can be used to identify a Group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false
Examples
Example 1 This command will return the default values used for the PSSeries group to which a connection exists in the current PowerShell runspace.
C:\PS>Get-EqlGroupDefaults
When you execute the Get-GroupDefaults cmdlet, the names of the defaults and their values are output to the console. See the following for sample output:
UseVolumeNameForiSCSIAlias : yes ISCSITargetNamePrefix : iqn.2001-05.com.mycompany ThinProvisionWarningPercent : 60 ThinProvisionMaxGrowPercent : 100 SnapshotDeletionPolicy : delete_oldest SnapshotReservePercent : 100 SnapshotReserveWarnPercent : 90
Example 2 This command gets the group default values for GroupA and copies them to GroupB.
15
Related Commands
Connect-EqlGroup cmdlet Set-EqlGroupDefaults cmdlet
Set-EqlGroupDefaults cmdlet
Changes the current default value settings for a PS Series group.
Command Syntax
Set-EqlGroupDefaults [-GroupName <string>] [-GroupAddress <string>][-SnapshotReservePercent <uint>] [-UseVolumeNameForiSCSIAlias <string>] -ISCSITargetNamePrefix <string> [-SnapshotReserveWarnPercent <uint>] [-SnapshotDeletionPolicy <string>] [-ThinProvisionWarningPercentDefault <uint>] [-ThinProvisionMaxGrowPercent <uint>] [-PassThru [<SwitchParameter>]] [<CommonParameters>]
Command Description
The Set-EqlGroupDefaults cmdlet changes the current default value settings for a PS Series group to which a connection exists in the current PowerShell runspace. If you are connected to more than one group, you can specify the target group using either the GroupName or GroupAddress parameter. These defaults include snapshot reserve percent, snapshot warning percent, snapshot space recovery policy, thin provisioning warning perecent, thin provisioning set volume offline percent, iSCSI Target name prefix, and use volume name for iSCSI alias. These defaults are used during volume creation if parameters for these values are not specified when the New-EqlVolume cmdlet is executed.
Inputs
Interop.EqlPsaMgmtAPI.EQL_PSGROUP_DEFAULT_SPEC
You can pipe objects from Get-EqlGroupDefaults to Set-EqlGroupDefaults if you want to copy the defaults from one group to another. Pipe the objects through format-list to filter out parameters that you do not want to set.
Outputs
Returns a string acknowledging the successful completion of the cmdlet action, or an Interop.EqlPsaMgmtAPI.EQL_PSGROUP_DEFAULT_SPEC object if the PassThru parameter is present.
Command Parameters
Parameter: GroupName <string>
16
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. Either this parameter or the GroupName parameter can be used to identify a group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: GroupAddress <string>
Specifies the IP address of a PS Series group for which a session was exists in this PowerShell runspace. This parameter can be either IPv4 or IPv6. Either this parameter or the GroupName parameter can be used to identify a Group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: SnapshotReservePercent <uint>
Changes the default percent of the volume size set aside for snapshot reserve.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: UseVolumeNameForiSCSIAlias <string>
Changes whether to use the volume name as the default iSCSI alias. Enter (y)es to use the volume name or (n)o to not create a default iSCSI alias.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: ISCSITargetNamePrefix [<string>]
Specifies the default prefix to use when creating an iSCSI target name.
Required?:true Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: SnapshotReserveWarnPercent <uint>
Changes the default percent for the snapshot reserve that can be used before a low space warning is issued.
17
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: SnapshotDeletionPolicy <string>
Changes the default policy to apply when the snapshot reserve is insufficient to create snapshots of the volume. Enter (m)ake_volume_offline, (d)elete_oldest, or (s)top_snapshots for the policy.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: ThinProvisionWarningPercent <uint>
Changes the default percent of the requested volume size that can be used before a warning is issued. This only applies to thin provisioned volumes.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: ThinProvisionMaxGrowPercent <uint>
Changes the default percent of the requested volume size to which the volume can grow, before the total size of the volume must be increased if it is thin provisioned.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: PassThru [<SwitchParameter>]
Specifies that the cmdlet should return an EQL_PSGROUP_DEFAULT_SPEC object for the changed defaults on successful completion.
Required?: false Position?: named Default value?: false Accept pipeline input?: false Accept wildcard characters?: false
Examples
Example 1 This command will change the threshhold for thin provisioning warning events to 80 percent and the maximum grow percent to 95 percent for the group to which a connection exists in the
18
Example 2 This command gets the group default values for GroupA and copies them to GroupB.
C:\PS>Get-EqlGroupDefaults -GroupName GroupA | Set-EqlGroupDefaults -GroupName GroupB
Related Commands
Connect-EqlGroup cmdlet Get-EqlGroupDefaults cmdlet
Get-EqlGroupConfiguration cmdlet
Retrieves the current configuration settings for a PS Series group.
Syntax
Get-EqlGroupConfiguration [-GroupName <string>] [-GroupAddress <string>] [<CommonParameters>]
Command Description
The Get-EqlGroupConfiguration cmdlet retrieves the current configuration settings for a PS Series group to which a connection exists in the current PowerShell runspace. If you are connected to more than one group, you can specify the target group using either the GroupName or GroupAddress parameter.
Inputs
None.
Outputs
Interop.EqlPsaMgmtAPI.EQL_PSGROUP_SPEC
You can pipe objects from Get-EqlGroupConfiguration to other cmdlets, such as Set-EqlGroupConfiguration. Pipe the objects through format-list to filter out parameters that you do not want to use.
Command Parameters
Parameter: GroupName <string>
19
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. Either this parameter or the GroupName parameter can be used to identify a group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: GroupAddress <string>
Specifies the IP address of a PS Series group for which a session was exists in this PowerShell runspace. This parameter can be either IPv4 or IPv6. Either this parameter or the GroupName parameter can be used to identify a Group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false
Examples
Example 1 This command will return the current configuration settings for the PS Series group to which a connection exists in the current PowerShell runspace.
C:\PS>Get-EqlGroupConfiguration
When you execute the Get-EqlGroupConfiguration cmdlet, the names of the settings and their values is output to the console. See the following for sample output:
groupName : GroupB groupAddress : 10.100.100.5 ClientAccessSSH : enabled ClientAccessTelnet : enabled WebAccess : enabled WebAccessNoEncrypt : enabled ConnectionBalancing : enabled PerformanceBalancing : enabled GroupDate : 11/14/10 GroupTime : 06:34:06 GroupTimeZone : VAL_eqlGroupTimeZone_america_New_York GroupDescription : This is the database group for North America UseCHAPForDiscovery : disabled EmailHomeContact : SMTPServers : 10.100.100.1;10.100.100.2:80 EmailSender : emailSender@myCompany.com EmailSenderDomain : myCompany.com EmailSenderName : emailSender EmailRecipientList : FirstEmailRecipient@anotherCo.com;SecondEmailRecipient@myCompany.com EmailNotification : disabled FTPService : enabled UseLocalChapForIscsi : enabled GroupLocation : default MembershipPassword : ****************
20
Example 2 This command retrieves the group configuration settings for GroupA and copies them to GroupB.
C:\PS>Get-EqlGroupConfiguration -GroupName GroupA | Set-EqlGroupConfiguration -GroupName GroupB
Related Commands
Connect-EqlGroup cmdlet Set-EqlGroupConfiguration cmdlet
Set-EqlGroupConfiguration cmdlet
Changes the current configuration settings for a PS Series group.
Command Syntax
Set-EqlGroupConfiguration [-GroupName <string>] [-GroupAddress <string>] [-ClientAccessSSH <string>] [-ClientAccessTelnet <string>] [-WebAccess <string>] [-WebAccessNoEncrypt <string>] [-ConnectionBalancing <string>] [-PerformanceBalancing <string>] [-GroupDescription [<string>]] [-UseCHAPForDiscovery <string>] [-EmailHomeContact [<string>]] [-SMTPServers [<string>]] [-NTPServers [<string>]] [-EmailSender [<string>]] [-EmailRecipientList [<string>]] [-EmailNotification <string>] [-FTPService <string>] [-SendInfoMessages <string>] [-UseLocalChapForIscsi <string>] [-GroupLocation [<string>]] [-Credential <System.Management.Automation.PSCredential>] [-MembershipPassword [<string>]] [-SyslogNotification <string>] [-PassThru [<SwitchParameter>]] [<CommonParameters>]
Command Description
The Set-EqlGroupConfiguration cmdlet modifies the current configuration settings for a PS Series group to which a connection exists in the current PowerShell runspace. If you are connected to more than one group, you can specify the target group using either the GroupName or GroupAddress parameter.
Inputs
None.
Outputs
string or Interop.EqlPsaMgmtAPI.EQL_PSGROUP_SPEC
21
You can pipe objects from Get-EqlGroupConfiguration to Set-EqlGroupConfiguration if you want to copy the settings from one group to another. Pipe the objects through format-list to filter out parameters that you do not want to use.
Command Parameters
Parameter: GroupName <string>
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. Either this parameter or the GroupName parameter can be used to identify a group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: GroupAddress <string>
Specifies the IP address of a PS Series group for which a session was exists in this PowerShell runspace. This parameter can be either IPv4 or IPv6. Either this parameter or the GroupName parameter can be used to identify a Group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: ClientAccessSSH <string>
Changes whether the SSH service on the group is enabled or disabled. Enter (e)nabled to enable the service and allow SSH access to the group and its member arrays or (d)isabled to disable the service.
Required?: false Position?: named Default value?: enabled Accept pipeline input?: true Accept wildcard characters?: false Parameter: ClientAccessTelnet <string>
Changes whether the Telnet service on the group is enabled or disabled. Enter (e)nabled to enable the service and allow Telnet access to the group and its member arrays or (d)isabled to disable the service.
Required?: false Position?: named Default value?: enabled Accept pipeline input?: true Accept wildcard characters?: false Parameter: WebAccess <string>
22
Changes whether the use of standard HTTP Web connections (through port 80) to the Group Manager GUI is enabled or disabled. Enter (e)nabled to enable the standard HTTP Web connections to the Group Manager GUI, or(d)isabled to disable standard HTTP Web connections.
Required?:false Position?: named Default value?: enabled Accept pipeline input?: true Accept wildcard characters?: false Parameter: WebAccessNoEncrypt <string>
Changes whether the SSL encryption is required for access on the standard HTTP Web connection to the Group Mnager GUI. Enter (e)nabled to require SSL encryption, or enter (d)isabled so that SSL encryption is not required.
Required?: false Position?: named Default value?: disabled Accept pipeline input?: true Accept wildcard characters?: false Parameter: ConnectionBalancing <string>
Changes whether iSCSI connection load balancing across group members is enabled or disabled. Enter (e)nabled to enable iSCSI connection load balancing or (d)isabled to disable it.
Required?: false Position?: named Default value?: enabled Accept pipeline input?: true Accept wildcard characters?: false Parameter: PerformanceBalancing <string>
Changes whether performance load balancing based on optimal RAID level for a volume is enabled or disabled. Enter (e)nabled to enable performance load balancing or (d)isabled to disable it.
Required?: false Position?: named Default value?: enabled Accept pipeline input?: true Accept wildcard characters?: false
Changes the description of the group (up to a maximum of 63 characters). Enter the parameter without a value to remove a group description. If the description contains spaces, surround it with quotation marks.
Required?: false Position?: named
23
Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: UseCHAPForDiscovery <string>
Changes whether the requirement for iSCSI initiators trying to discover targets to provide CHAP credentials is enabled or disabled. Enter (e)nabled to require the use of CHAP for discovery or (d)isabled to disable the requirement.
Required?: false Position?: named Default value?: disabled Accept pipeline input?: true Accept wildcard characters?: false Parameter: EmailHomeContact [<string>]
Changes the local IP Address used as a destination for sending notifications of firmware updates and hardware failures. If an address is specified, the E-Mail Home feature is enabled to send the notifications to Dell Customer Support. An SMTP server IP Address must also be specified using the SMTPServer parameter. Optionally, a sender IP address can be specified using the EmailSender parameter.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false
Changes the IP Addresses and optional port numbers in the list of SMTP Servers used for e-mail messages with event notifications from the group. A maximum of three SMTP Servers can be specified in order of preference in this semicolon delimited list. SMTPServers can be IPv4 or IPv6 for the Set-EqlGroupConfiguration cmdlet.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false
Changes the IP Addresses and optional port numbers in the list of Network Time Protocol Servers used for setting a consistent time on all group members. A maximum of three NTP Servers can be specified in order of preference in this semicolon delimited list. NTPServers can be IPv4 or IPv6 for the Set-EqlGroupConfiguration cmdlet.
Required?: false
24
Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false
Changes the email address used as the sender of notification email messages. An SMTP server IP Address must also be specified using the SMTPServer parameter. Optionally, a semicolondelimited list of up to 5 destination email addresses can be specified using the EmailRecipientList parameter.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: EmailRecipientList <string>
Changes the email addresses used as the destination of e-mail messages with event notifications from the group. An SMTP server IP Address must also be specified using the SMTPServer parameter. Optionally, a sender email address can be specified using the EmailSender parameter.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: EmailNotification <string>
Changes whether e-mail notification of events is enabled or disabled for the group. Enter (e)nabled to send e-mail notification of events or (d)isabled to disable e-mail notification of events.
Required?: false Position?: named Default value?: disabled Accept pipeline input?: true Accept wildcard characters?: false Parameter: FTPService <string>
Changes whether the FTP server running on the group is enabled or disabled. Enter (e)nabled to enable the FTP server or (d)isabled to prevent FTP file transfers to and from the group.
Required?: false Position?: named Default value?: enabled Accept pipeline input?: true Accept wildcard characters?: false Parameter: SendInfoMessages <string>
25
Changes whether informational messages are sent to the console or Group Manager GUI. Enter (e)nabled to send informational messages or (d)isabled to not send informational messages.
Required?: false Position?: named Default value?: disabled Accept pipeline input?: true Accept wildcard characters?: false Parameter: UseLocalChapForIscsi <string>
Changes whether local CHAP accounts are used to authenticate iSCSI initiator access to volumes and snapshots. Enter (e)nabled to use local CHAP or (d)isabled to use external RADIUS authentication servers.
Required?: false Position?: named Default value?: disabled Accept pipeline input?: true Accept wildcard characters?: false Parameter: GroupLocation <string>
Changes the physical location information of the group (up to a maximum of 63 characters). Enter the parameter without a value to set the location to "default."
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: Credential <System.Management.Automation.PSCredential>
Changes the password required for adding members to the PS Series group to the password contained in a PSCredential object. The password must be between 3 and 16 alphanumeric characters and is case-sensitive. The username value from the PSCredential object is ignored. The MembershipPassword parameter can be used instead of the Credential parameter.
Required?: true, unless MembershipPassword is specified. Position?: named Default value?: Accept pipeline input?: false Accept wildcard characters?: false Parameter: MembershipPassword <string>
Changes the password required for adding members to a group. The password must be between 3 and 16 alphanumeric characters and is case-sensitive. The Credential parameter can be used instead of the MembershipPassword parameter.
Required?: true, unless Credential is specified. Position?: named Default value?: Accept pipeline input?: true
26
Changes whether event logging to remote syslog servers is enabled. Enter (e)nabled remote event logging or (d)isabled to disable it. To use syslog notification, you must also specify IP addresses for the syslog servers using the Group Manager.
Required?: false Position?: named Default value?: disabled Accept pipeline input?: true Accept wildcard characters?: false Parameter: PassThru [<SwitchParameter>]
Specifies that the cmdlet should return an EQL_PSGROUP_SPEC object for the new volume on successful completion.
Required?: false Position?: named Default value?: false Accept pipeline input?: false Accept wildcard characters?: false
Examples
Example 1 This command will enable informational messages to be sent to the Group Manager connected to the PS Series group to which a connection exists in the current PowerShell runspace. The command will use AdminUser@MyCompany.com as the sender for any email notifications sent by the group. Since the PassThru parameter is specified, it will also list all of the values (except for passwords) in the EQL_PSGROUP_SPEC object for the group reflecting the state after the command executes.
C:\PS>Set-EqlGroupConfiguration -SendInfoMessages yes -EmailSender AdminUser@MyCompany.com -PassThru
Example 2 This command retrieves the group configuration settings for GroupA and copies them to GroupB.
C:\PS>Get-EqlGroupConfiguration -GroupName GroupA | Set-EqlGroupConfiguration -GroupName GroupB
Related Commands
Connect-EqlGroup cmdlet Get-EqlGroupConfiguration cmdlet
27
Get-EqlMember cmdlet
Retrieves the current configuration settings for PS Series group member arrays.
Syntax
Get-EqlMember [-GroupName <string>] [-GroupAddress <string>] [-MemberName <string>] [<CommonParameters>]
Command Description
The Get-EqlMember cmdlet retrieves the current configuration settings for a specified array that is a member of a PS Series group to which a connection exists in the current PowerShell runspace. If a member name is not specified, this cmdlet retrieves configuration settings for all members of the array. If you are connected to more than one group, you can specify the target group using either the GroupName or GroupAddress parameter.
Inputs
None.
Outputs
Interop.EqlPsaMgmtAPI.EQL_MEMBER_SPEC
You can pipe objects from Get-EqlMember to other cmdlets, such as Set-EqlMember. Pipe the objects through format-list to filter out parameters that you do not want to use.
Command Parameters
Parameter: GroupName <string>
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. Either this parameter or the GroupName parameter can be used to identify a group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: GroupAddress <string>
Specifies the IP address of a PS Series group for which a session was exists in this PowerShell runspace. This parameter can be either IPv4 or IPv6. Either this parameter or the GroupName parameter can be used to identify a Group for this cmdlet.
Required?: false Position?: named
28
Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: MemberName <string>
Specifies the name of a member of a PS Series group that identifies the member to which this cmdlet applies. This name is case-sensitive.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false
Examples
Example 1 This command retrieves the configuration information for Member1 in a PSObject that contains the values from an Interop.EqlPsaMgmtAPI.EQL_MEMBER_SPEC.
C:\PS>Get-EqlMember -MemberName Member1
When you execute the Get-EqlMember cmdlet for Member1, a list of Member1 configuration settings and their values is output to the console. Sample output is as follows:
MemberName : Member1 MemberDescription : This is a member configured for RAID5 FirmwareVersion : Storage Array Firmware V5.0.2 (R138185) StoragePoolName : default RaidType : raid5
Example 2 This command retrieves the configuration information for all members of a group in a PSObject collection that contains the values from an Interop.EqlPsaMgmtAPI.EQL_MEMBER_SPEC.
C:\PS>Get-EqlGroupMember
Related Commands
Connect-EqlGroup cmdlet Set-EqlMember cmdlet Remove-EqlMember cmdlet
Set-EqlMember cmdlet
Modify configuration settings for an array that is a member of a PS Series Group.
Note: The Group Management gateway must be IPv4 for this cmdlet.
29
Command Syntax
Set-EqlMember [-GroupName <string>] [-GroupAddress <string>] -MemberName <string> [-NewMemberName <string>] [-MemberDescription <string>] [-StoragePoolName <string>] [-RaidType <string>] [-DefaultGateway <string>] [-PassThru [<SwitchParameter>]] [<CommonParameters>]
Command Description
The Set-EqlMember cmdlet modifies the current configuration settings for an array that is a member of a PS Series group to which a connection exists in the current PowerShell runspace. If you are connected to more than one group, you can specify the target group using either the GroupName or GroupAddress parameter. Use the Set-EqlNetInterface cmdlet to configure the network interfaces for a member.
Inputs
None.
Outputs
If the PassThru parameter is not specified, a string acknowledging the successful completion of the cmdlet action is returned. Otherwise, a Interop.EqlPsaMgmtAPI.EQL_MEMBER_SPEC object is returned. You can pipe objects from Set-EqlMember to other Set-EqlMember cmdlets. Pipe the objects through format-list to filter out parameters that you do not want to use.
Command Parameters
Parameter: GroupName <string>
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. Either this parameter or the GroupName parameter can be used to identify a group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: GroupAddress <string>
Specifies the IP address of a PS Series group for which a session was exists in this PowerShell runspace. This parameter can be either IPv4 or IPv6. Either this parameter or the GroupName parameter can be used to identify a Group for this cmdlet.
Required?: false
30
Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: MemberName <string>
Specifies the name of a member of a PS Series group that identifies the member to which this cmdlet applies. This name is case-sensitive.
Required?: true Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: NewMemberName <string>
Changes the name of the specified group member. This name is case-sensitive.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: MemberDescription <string>
Changes the description for the specified group member. This name is case-sensitive.
Required?:false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: StoragePoolName <string>
Changes the pool to which the specified group member belongs. This name is case-sensitive.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: RaidType <string>
Changes the RAID configuration of the member. The type is specified using one of the following values: raid5, raid5_nospares, raid6, raid6_nospares, raid6_accelerated, raid10, raid10_ nospares, raid50, raid50_nospares. Not all RAID types are valid for every RAID type. Specifying an unavailable RAID type will cause this command to fail. Refer to the technical documentation for your array to determine what values are allowed. There are limitations on which RAID configurations can be converted into other RAID types. The following conversions are supported:
31
Changes the IPv4 Address used for the default gateway and applies it to all of the configured interfaces on the member except the management network interface. Specify the parameter without a value to delete the default gateway.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: PassThru [<SwitchParameter>]
Specifies that the cmdlet should return an EQL_MEMBER_SPEC object for the group member on successful completion.
Required?: false Position?: named Default value?: false Accept pipeline input?: false Accept wildcard characters?: false
Example
This command changes the name of the storage pool in which the member is located and causes the member to be moved to the specified pool.
C:\PS>Set-EqlMember -MemberName Member1 -StoragePoolName PoolB -PassThru
Related Commands
Connect-EqlGroup cmdlet Get-EqlMember cmdlet
Get-EqlNetInterface cmdlet
Retrieves the current network interface settings for PS Series group member arrays.
32
Command Syntax
Get-EqlNetworkInterface [-MemberName <string>] [-InterfaceName <string>] [<CommonParameters>]
Command Description
The Get-EqlNetInterface cmdlet retrieves the specified network interface for a specified array that is a member of a PS Series group to which a connection exists in the current PowerShell runspace. If a network interface name is not specified, this cmdlet returns all of the network interfaces for the specified member array.
Inputs
None.
Outputs
Interop.EqlPsaMgmtAPI.EQL_MEMBER_NETWORK_INTERFACE
You can pipe objects from Get-EqlNetInterface to other cmdlets, such as Set-EqlNetInterface. Pipe the objects through format-list to filter out parameters that you do not want to use.
Command Parameters
Parameter: MemberName <string>
Specifies the name of a member of a PS Series Array Group that identifies the member to which this cmdlet applies. This name is case-sensitive.
Required?: true Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: InterfaceName <string>
Specifies the name of a network interface for a member of a PS Series group that identifies the network interface to which this cmdlet applies. This name is case-sensitive.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false
33
Examples
Example 1 This command retrieves the configuration information for eth0 to Member1 in a PSObject that contains the values from an Interop.EqlPsaMgmtAPI.EQL_MEMBER_NETWORK_ INTERFACE.
C:\PS>Get-EqlNetInterface -MemberName Member1 -InterfaceName eth0
Example 2 This command retrieves the configuration information for all of the network interfaces to the specified member of a group in a PSObject collection that contains the values from an Interop.EqlPsaMgmtAPI.EQL_MEMBER_NETWORK_INTERFACE.
C:\PS>Get-EqlNetInterface
Related Commands
Connect-EqlGroup cmdlet Set-EqlNetInterface cmdlet Set-EqlMember cmdlet Remove-EqlMember cmdlet
Set-EqlNetInterface cmdlet
Changes the configuration of the specified network interface to a PS Series group member array.
Command Syntax
Set-EqlNetInterface -MemberName <string> -InterfaceName <string> [-Description [<string>]] [-IPAddress <string>] [-SubnetMask [<string>]] [-PassThru [<SwitchParameter>]] [<CommonParameters>]
Command Description
The Set-EqlNetInterface cmdlet changes the specified network interface for a specified array that is a member of a PS Series group to which a connection exists in the current PowerShell
34
runspace.
Note: Management network IP addresses are IPv4 only and use the highest number port
available on an array (eth2 or eth3, depending on the array type). Other than the management port, the other interface ports can be either IPv4 or IPv6.
Inputs
None.
Outputs
Interop.EqlPsaMgmtAPI.EQL_MEMBER_NETWORK_INTERFACE
You can pipe objects from Set-EqlNetInterface to other cmdlets, such as Set-EqlNetInterface. Pipe the objects through format-list to filter out parameters that you do not want to use.
Command Parameters
Parameter: MemberName <string>
Specifies the name of a member of a PS Series Array Group that identifies the member to which this cmdlet applies. This name is case-sensitive.
Required?: true Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: InterfaceName <string>
Specifies the name of a network interface for a member of a PS Series group that identifies the network interface to which this cmdlet applies. This name is case-sensitive.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: Description [<string>]
Changes the description (up to a maximum of 127 alphanumeric characters) of the network interface. If the description contains spaces, surround it with quotes. Enter the parameter with an empty string ("") to delete the description.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false
35
Changes the IP Address for the network interface to the member. Enter the parameter with an empty string ("") to remove the IP Address.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: SubnetMask <string>
Changes the subnet mask for the network interface to the member. Can only be used if the IPAddress is IPv4. Enter the parameter with an empty string ("") to remove the subnet mask.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: PassThru [<SwitchParameter>]
Specifies that the cmdlet should return an EQL_MEMBER_NETWORK_INTERFACE object for the group member on successful completion.
Required?: false Position?: named Default value?: false Accept pipeline input?: false Accept wildcard characters?: false
Examples
Example 1 This command changes the IPAddress for eth1 to Member1 to 10.100.100.5.
C:\PS>Set-EqlNetInterface -MemberName Member1 -InterfaceName eth1 -IPAddress 10.100.100.5
Example 2 This command clears the description of eth1 to Member1 outputs a PSObject that contains the values from an Interop.EqlPsaMgmtAPI.EQL_MEMBER_NETWORK_INTERFACE for Member1.
C:\PS>Set-EqlNetInterface -MemberName Member1 -InterfaceName eth1 -Description -PassThru
Related Commands
Connect-EqlGroup cmdlet
36
New-EqlPool cmdlet
Creates a new pool in a PS group.
Command Syntax
New-EqlPool [-GroupName <string>] [-GroupAddress <string>] -StoragePoolName <string> [-PoolDescription <string>] [<CommonParameters>]
Command Description
The New-EqlPool cmdlet creates a pool with the specified by name on a PS Series group to which a connection exists in the current PowerShell runspace. If you are connected to more than one group, you can specify the target group using either the GroupName or GroupAddress parameter. Use the Set-EqlMember cmdlet to add arrays to a pool.
Inputs
None. You cannot pipe objects to New-EqlPool.
Outputs
Returns a string acknowledging the successful completion of the cmdlet action.
Command Parameters
Parameter: GroupName <string>
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. Either this parameter or the GroupName parameter can be used to identify a group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: GroupAddress <string>
37
Specifies the IP address of a PS Series group for which a session was exists in this PowerShell runspace. This parameter can be either IPv4 or IPv6. Either this parameter or the GroupName parameter can be used to identify a Group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: StoragePoolName <string>
Specifies the name (up to a maximum of 63 characters) for a new pool on a PS Series group. This name is case-sensitive and must be unique. The name must begin with a letter or number, and can contain letters, numbers, and hyphens.
Required?: true Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: PoolDescription <string>
Specifies the description (up to a maximum of 127 characters) for a pool on a PS Series group. If the description contains spaces, surround it with quotes.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false
Example
This command creates a new pool named PoolB. Use the New-EqlMember cmdlet to add storage space to the pool.
C:\PS>New-EqlPool -StoragePoolName PoolB
Related Commands
Connect-EqlGroup cmdlet Set-EqlPool cmdlet Get-EqlPool cmdlet Merge-EqlPool cmdlet Remove-EqlPool cmdlet Set-EqlMember cmdlet
38
Get-EqlPool cmdlet
Retrieves identifying and status info for a named pool or for every pool in a PS Series group.
Command Syntax
Get-EqlPool [-GroupName <string>] [-GroupAddress <string>] [-StoragePoolName <string>] [<CommonParameters>]
Command Description
The Get-EqlPool cmdlet retrieves the identifying and status information for a pool, specified by the pool name, on a PS Series group to which a connection exists in the current PowerShell runspace. If you are connected to more than one group, you can specify the target group using either the GroupName or GroupAddress parameter. If a pool name is not specified, data is returned for every pool in the group. The StoragePoolName in the output of this command can be used to identify a pool for volume and member cmdlets.
Inputs
None. You cannot pipe objects to Get-EqlPool.
Outputs
Interop.EqlPsaMgmtAPI.EQL_POOL_SPEC. This command outputs an array of PSObjects containing the identifying information and statistics for the named pool or all pools in the group.
Command Parameters
Parameter: GroupName <string>
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. Either this parameter or the GroupName parameter can be used to identify a group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: GroupAddress <string>
Specifies the IP address of a PS Series group for which a session was exists in this PowerShell runspace. This parameter can be either IPv4 or IPv6. Either this parameter or the GroupName parameter can be used to identify a Group for this cmdlet.
Required?: false Position?: named Default value?: none
39
Accept pipeline input?: true Accept wildcard characters?: false Parameter: StoragePoolName <string>
Specifies the name of a pool on a PS Series group. If this parameter is not specified, the cmdlet will get information for all pools on the group.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false
Examples
Example 1 This command will return a PSObject containing the identifying information and statistics for PoolB.
C:\PS>Get-EqlPool -StoragePoolName PoolB
When you execute the Get-EqlPool cmdlet for PoolB, a list of PoolB's statistics and their values is output to the console. Sample output is as follows:
StoragePoolName : PoolB OnlineMemberCount : 2 InUseMemberCount : 2 TotalSpaceMB : 5191500 FreeSpaceMB : 477675 UsedSpaceMB : 2480730 ThinProvisionFreeSpaceMB : 4776750 ISCSIConnectionCount : 90 VolumeSubscribedMB : 4003575 VolumeAllocatedMB : 2276130 VolumeCount : 97 OnlineVolumeCount : 84 InUseVolumeCount : 22 SnapshotReservedMB : 1617690 SnapshotReservedAvailableMB : 1609050 SnapshotSpaceUsedMB : 8640 SnapshotCount : 55 OnlineSnapshotCount : 2 InUseSnapshotCount : 0
Example 2 This command will return a PSObject containing the identifying information and statistics for every pool in the current group.
C:\PS>Get-EqlPool
40
Related Commands
Connect-EqlGroup cmdlet New-EqlVolume cmdlet Set-EqlVolume cmdlet Set-EqlMember cmdlet
Set-EqlPool cmdlet
Changes the name and description of a specified pool in a PS Series group.
Command Syntax
Set-EqlPool [-GroupName <string>] [-GroupAddress <string>] -StoragePoolName <string> [-NewStoragePoolName <string>] [-PoolDescription [<string>]] [<CommonParameters>]
Command Description
The Set-EqlPool cmdlet changes the name and description of pool specified by name on a PS Series group to which a connection exists in the current PowerShell runspace. If you are connected to more than one group, you can specify the target group using either the GroupName or GroupAddress parameter.
Inputs
None.
Outputs
Interop.EqlPsaMgmtAPI.EQL_POOL_SPEC
This command outputs an array of PSObjects containing the identifying information and statistics for the named pool or all pools in the group.
Command Parameters
Parameter: GroupName <string>
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. Either this parameter or the GroupName parameter can be used to identify a group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true
41
Specifies the IP address of a PS Series group for which a session was exists in this PowerShell runspace. This parameter can be either IPv4 or IPv6. Either this parameter or the GroupName parameter can be used to identify a Group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: StoragePoolName <string>
Specifies the name of a pool on a PS Series group that identifies the pool to which this cmdlet applies. This name is case-sensitive.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: NewStoragePoolName <string>
Specifies a new name (63 characters maximum) for a pool on a PS Series group. This name is case-sensitive and must be unique. The name must begin with a letter or number and can contain letters, numbers, and hyphens.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false
Changes the description (127 characters maximum) for a pool on a PS Series group. If the description contains spaces, surround it with quotes. Enter the parameter name without a value to delete a description.
Required?:false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false
Example
This command will change the name of the pool to PoolB2.
C:\PS>Set-EqlPool -StoragePoolName PoolB -NewStoragePoolName PoolB2
42
Related Commands
Connect-EqlGroup cmdlet New-EqlPool cmdlet Get-EqlPool cmdlet Merge-EqlPool cmdlet Remove-EqlPool cmdlet
Merge-EqlPool cmdlet
Moves the members and volumes from a source pool in a PS Series group to another pool and deletes the source pool.
Command Syntax
Merge-EqlPool [-GroupName <string>] [-GroupAddress <string>] -StoragePoolName <string> -DestinationPool <string> [-Force [<SwitchParameter>]] [<CommonParameters>]
Command Description
The Merge-EqlPool cmdlet moves the members and volumes from a source pool specified by name on a PS Series group to which a connection exists in the current PowerShell runspace, to another pool specified by name in the same group. If you are connected to more than one group, you can specify the target group using either the GroupName or GroupAddress parameter. The source pool is deleted after the merge is completed. This cmdlet will display a prompt to the console to confirm the merge. The -Force parameter can be used to suppress this prompt for scripts. The default pool cannot be specified as the source pool.
Inputs
None. You cannot pipe objects to Merge-EqlPool.
Outputs
Returns a string acknowledging the successful completion of the cmdlet action.
Command Parameters
Parameter: GroupName <string>
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. Either this parameter or the GroupName parameter can be used to identify a group for this cmdlet.
43
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: GroupAddress <string>
Specifies the IP address of a PS Series group for which a session was exists in this PowerShell runspace. This parameter can be either IPv4 or IPv6. Either this parameter or the GroupName parameter can be used to identify a Group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: StoragePoolName <string>
Specifies the name of a pool on a PS Series group that identifies the pool to which this cmdlet applies. This name is case-sensitive. The default pool cannot be specified for this parameter.
Required?: true Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: DestinationPool <string>
Specifies the name of the destination pool on a PS Series group that identifies the pool to which the source pool will be merged. This name is case sensitive.
Required?: true Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: Force [<SwitchParameter>]
Specifies that the cmdlet should bypass the confirmation prompt and merge the pool.
Required?: false Position?: named Default value?: false Accept pipeline input?: false Accept wildcard characters?: false
44
Examples
Example 1 This command will display a confirmation prompt to the console, merge the members and volumes from PoolB to PoolA if confirmed, and delete PoolB.
C:\PS>Merge-EqlPool -StoragePoolName PoolB -DestinationPool PoolA
Example 2 This command will merge member arrays and volumes from PoolB to PoolA and delete PoolB. It will not prompt for confirmation because -Force is specified.
C:\PS>Merge-EqlPool -StoragePoolName PoolB -Destination PoolA -Force
Related Commands
Connect-EqlGroup cmdlet New-EqlPool cmdlet Get-EqlPool cmdlet Set-EqlPool cmdlet Remove-EqlPool cmdlet
Remove-EqlPool cmdlet
Deletes a specified pool in a PS group and moves its member arrays to the default pool.
Command Syntax
Remove-EqlPool [-GroupName <string>] [-GroupAddress <string>] -StoragePoolName <string> [-Force [<SwitchParameter>]] [<CommonParameters>]
Command Description
The Remove-EqlPool cmdlet deletes the pool specified by name from a PS Series group to which a connection exists in the current PowerShell runspace. If you are connected to more than one group, you can specify the target group using either the GroupName or GroupAddress parameter. The array members in the pool are immediately moved to the default pool. Deletion of the default pool is not permitted. This cmdlet will display a prompt to the console to confirm the deletion. The -Force parameter can be used to suppress this prompt for scripts.
Inputs
None. You cannot pipe objects to Get-EqlPool.
45
Outputs
Returns a string acknowledging the successful completion of the cmdlet action.
Command Parameters
Parameter: GroupName <string>
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. Either this parameter or the GroupName parameter can be used to identify a group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: GroupAddress <string>
Specifies the IP address of a PS Series group for which a session was exists in this PowerShell runspace. This parameter can be either IPv4 or IPv6. Either this parameter or the GroupName parameter can be used to identify a Group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: StoragePoolName <string>
Specifies the name of a pool on a PS Series group that identifies the pool to which this cmdlet applies. This name is case-sensitive. Deletion of the default pool is not permitted.
Required?: true Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: Force [<SwitchParameter>]
Specifies that the cmdlet should bypass the confirmation prompt and delete the pool.
Required?: false Position?: named Default value?: false Accept pipeline input?: false Accept wildcard characters?: false
46
Example
Example 1 This command will display a confirmation prompt to the console, remove PoolB if confirmed, and move all of its member arrays to the default pool.
C:\PS>Remove-EqlPool -StoragePoolName PoolB
Example 2 This command will remove PoolB and move all of its member arrays to the default pool. It will not prompt for confirmation because -Force is specified.
C:\PS>Remove-EqlPool -StoragePoolName PoolB -Force
Related Commands
Connect-EqlGroup cmdlet New-EqlPool cmdlet Set-EqlPool cmdlet Get-EqlPool cmdlet Merge-EqlPool cmdlet
New-EqlChapUser cmdlet
Creates and adds a local CHAP user to the specified group.
Command Syntax
New-EqlChapUser [-GroupName <string>] [-GroupAddress <string>] [-Credential <System.Management.Automation.PSCredential>] [-Username <string> -Password <string>][<CommonParameters>]
Command Description
The New-EqlChapUser cmdlet creates a CHAP user with access to the PS Series group to which a connection exists in the current PowerShell runspace. If you are connected to more than one group, you can specify the target group using either the GroupName or GroupAddress parameter.
47
The CHAP user can be specified using either the Credential parameter or the Username and Password parameters. Use the Get-EqlChapUser cmdlet to list user names for all existing local CHAP accounts defined for the group.
Inputs
None.
Outputs
Returns a string acknowledging the successful completion of the cmdlet action.
Command Parameters
Parameter: GroupName <string>
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. Either this parameter or the GroupName parameter can be used to identify a group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: GroupAddress <string>
Specifies the IP address of a PS Series group for which a session was exists in this PowerShell runspace. This parameter can be either IPv4 or IPv6. Either this parameter or the GroupName parameter can be used to identify a Group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: Credential [{System.Management.Automation.PSCredential]}
Specifies a local CHAP user name (63 characters maximum) and valid password (3-16 alphanumeric characters) in a PSCredential object for the local CHAP user. The username and password are case-sensitive. The Username and Password parameters can be used instead of the Credential parameter.
Required?: true, unless Username and Password are specified. Position?: named Default value?: none Accept pipeline input?: false Accept wildcard characters?: false Parameter: Username <string>
Specifies a local CHAP username (63 characters maximum) to add for the group.
48
Required?: true, unless Credential is specified. Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: Password <string>
Specifies a valid password (3-16 alphanumeric characters) for the local CHAP user. The Credential parameter can be used instead of the Password parameter.
Required?: true, unless Credential is specified. Position?: named Default value?: Accept pipeline input?: Accept wildcard characters?: false
Examples
Example 1 This command adds a local CHAP user with the username and password from the PSCredential object created by the PowerShell Get-Credential cmdlet.
C:\PS> New-EqlChapUser -Credential (Get-Credential)
Example 2 This command adds a local CHAP user named "chapuser" with the password "chapsecret" to the local CHAP users for the group.
C:\PS>New-EqlChapUser -UserName chapuser -password chapsecret
Related Commands
Connect-EqlGroup cmdlet Set-EqlChapUser cmdlet Get-EqlChapUser cmdlet Remove-EqlChapUser cmdlet New-EqlVolumeACL cmdlet
Get-EqlChapUser cmdlet
Retrieves the names of local CHAP user accounts defined for a group.
Syntax
Get-EqlChapUser [-GroupName <string>] [-GroupAddress <string>] [<CommonParameters>]
49
Command Description
The Get-EqlChapUser cmdlet retrieves the usernames of the local CHAP accounts for a PS Series group to which a connection exists in the current PowerShell runspace. If you are connected to more than one group, you can specify the target group using either the GroupName or GroupAddress parameter. Use the New-EqlChapUser to add a local CHAP user and password to a group and Remove-EqlChapUser to delete an existing local CHAP user in a group.
Inputs
None.
Outputs
String. You can pipe objects from Get-EqlChapUser to other cmdlets, such as Set-EqlChapUser.
Command Parameters
Parameter: GroupName <string>
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. Either this parameter or the GroupName parameter can be used to identify a group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: GroupAddress <string>
Specifies the IP address of a PS Series group for which a session was exists in this PowerShell runspace. This parameter can be either IPv4 or IPv6. Either this parameter or the GroupName parameter can be used to identify a Group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false
Example
This command retrieves all of the CHAPusernames for the group.
C:\PS>Get-EqlChapUser
Related Commands
Connect-EqlGroup cmdlet New-EqlChapUser cmdlet
50
Set-EqlChapUser cmdlet
Changes the password for the specified local CHAP user.
Command Syntax
Set-EqlChapUser [-GroupName <string>] [-GroupAddress <string>] -UserName <string> [-Credential <System.Management.Automation.PSCredential>] [-Password <string>] [<CommonParameters>]
Command Description
The Set-EqlChapUser cmdlet changes the password for the specified local CHAP user on a PS Series group to which a connection exists in the current PowerShell runspace. If you are connected to more than one group, you can specify the target group using either the GroupName or GroupAddress parameter. Use the Get-EqlChapUser cmdlet to retrieve the names of the local CHAP users on the group.
Inputs
None.
Outputs
Returns a string acknowledging the successful completion of the cmdlet action.
Command Parameters
Parameter: GroupName <string>
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. Either this parameter or the GroupName parameter can be used to identify a group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: GroupAddress <string>
Specifies the IP address of a PS Series group for which a session was exists in this PowerShell runspace. This parameter can be either IPv4 or IPv6. Either this parameter or the GroupName parameter can be used to identify a Group for this cmdlet.
51
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: UserName <string>
Specifies the name of a CHAP user account on a PS Series group that identifies the CHAP user to which this cmdlet applies.
Required?: true Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: Credential [<System.Management.Automation.PSCredential>]
Changes the password for the local CHAP user to the value in a PSCredential object. The username value in the PSCredential object is ignored. The new password must be 3-16 alphanumeric characters and is case sensitive. The Password parameter can be used instead of the Credential parameter.
Required?: true, unless Password is specified. Position?: named Default value?: Accept pipeline input?: false Accept wildcard characters?: false Parameter: Password <string>
Changes the password for the local CHAP user. The new password must be 3-16 alphanumeric characters and is case-sensitive. The Credential parameter can be used instead of the Password parameter.
Required?: true, unless Credential is specified. Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false
Examples
Example 1 This command displays a dialog for entry of a password and changes the password for chapuser to the password value entered in the PSCredential object.
C:\PS>Set-ChapUser -Username chapuser -Credential (Get-Credential)
52
Related Commands
Connect-EqlGroup cmdlet New-EqlChapUser cmdlet Get-EqlChapUser cmdlet Remove-EqlChapUser cmdlet
Remove-EqlChapUser cmdlet
Removes the specified local CHAP user from a PS Series group.
Command Syntax
Remove-EqlChapUser [-GroupName <string>] [-GroupAddress <string>] -UserName <string> [-Force [<SwitchParameter>]] [<CommonParameters>]
Command Description
The Remove-EqlChapUser cmdlet removes the local CHAP user identified by name from a PS Series group to which a connection exists in the current PowerShell runspace. If you are connected to more than one group, you can specify the target group using either the GroupName or GroupAddress parameter. Use the Get-EqlChapUser cmdlet to get the names of CHAP users defined for the group.
Inputs
None.
Outputs
Returns a string acknowledging the successful completion of the cmdlet action.
Command Parameters
Parameter: GroupName <string>
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. Either this parameter or the GroupName parameter can be used to identify a group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: GroupAddress <string>
53
Specifies the IP address of a PS Series group for which a session was exists in this PowerShell runspace. This parameter can be either IPv4 or IPv6. Either this parameter or the GroupName parameter can be used to identify a Group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: UserName <string>
Specifies the name of a local CHAP user on a PS Series group that identifies the local CHAP user to which this cmdlet applies. This name is case-sensitive.
Required?: true Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: Force [<SwitchParameter>]
Specifies that the cmdlet should bypass the confirmation prompt and delete the local CHAP account.
Required?: false Position?: named Default value?: false Accept pipeline input?: false Accept wildcard characters?: false
Example
This command removes the local CHAP user chapuser from the group.
C:\PS>Remove-EqlChapUser -UserName chapuser
Related Commands
Connect-EqlGroup cmdlet New-EqlChapUser cmdlet Set-EqlChapUser cmdlet Get-EqlChapUser cmdlet
54
Basic cmdlets
These cmdlets allow you to manage volume creation and configuration of volumes on PS Series groups and for controlling access to the volumes using access control lists (ACLs).
New-EqlVolume cmdlet
Creates a new volume on a PS Series group.
Command Syntax
New-EqlVolume [-GroupName <string>] [-GroupAddress <string>] -VolumeName <string> -VolumeSizeMB <uint> [-SnapshotReservePercent <uint>] [-StoragePoolName <string>] [-DiskSpeedPreference <string>] [-AccessType <string>] [-DriveTypePreference <string>] [-LoadBalance <string>] [-iSCSIAlias [<string>]] [-OnlineStatus <string>] [-RAIDTypePreference <string>] [-AllowMultipleInitiators <string>] [-VolumeDescription [<string>]] [-SnapshotReserveWarnPercent <uint>] [-SnapshotDeletionPolicy <string>] [-ThinProvision] [-ThinProvisionMinReservePercent <uint>] [-ThinProvisionWarningPercent <uint>] [-ThinProvisionMaxGrowPercent <uint>] [-PassThru [<SwitchParameter>]] [{Common Parameters}]
Command Description
The New-EqlVolume cmdlet creates a volume on a PS Series group to which a connection exists in the current PowerShell runspace with the name, size in MB, and snapshot reserve specified. Additional options for configuring the volume, such as thin provisioning, can be specified at creation time. If you are connected to more than one group, you can specify the target group using either the GroupName or GroupAddress parameter. If an optional parameter is not specified, the value will be set to the default values configured for the group. The Get-EqlGroupDefaults cmdlet can be used to review these default values. The Set-EqlGroupDefaults cmdlet can be used to change them. Access control lists (ACLs) can be created and added to this volume using the New-EqlVolumeACL cmdlet. Schedules can be created for this volume using the New-EqlSchedule cmdlet. Initial values set at creation time can be changed later using the Set-EqlVolume cmdlet. To delete this volume use the Remove-EqlVolume cmdlet.
Inputs
Interop.EqlPsaMgmtAPI.EQL_VOLUME_SPEC
55
Outputs
If the PassThru parameter is present, this cmdlet returns an Interop.EqlPsaMgmtAPI.EQL_ VOLUME_SPEC object. It also returns a string acknowledging the successful completion of the cmdlet action.
Command Parameters
Parameter: GroupName <string>
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. Either this parameter or the GroupName parameter can be used to identify a group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: GroupAddress <string>
Specifies the IP address of a PS Series group for which a session was exists in this PowerShell runspace. This parameter can be either IPv4 or IPv6. Either this parameter or the GroupName parameter can be used to identify a Group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: VolumeName <string>
Specifies the name for the volume to be created on a PS Series group. This name must be unique on the PS Group and is case-sensitive.
Required?: true Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: VolumeSizeMB <uint>
56
Specifies the percent of the volume size that should be set aside for snapshot reserve.
Required?: false Position?: named Default value?: 100 Accept pipeline input?: true Accept wildcard characters?: false Parameter: StoragePoolName <string>
Specifies the name of the pool in which the new volume should be created. If this is not specified, the volume will be created in the default pool.
Required?: false Position?: named Default value?: default Accept pipeline input?: true Accept wildcard characters?: false Parameter: DiskSpeedPreference <string>
Specifies the preferred speed for selecting a drive in the group on which to create the new volume. If specifying a preference, enter 5400, 7200, 10000, or 15000 for the preferred drive RPM level. Otherwise, skip this parameter or enter 0 or (n)o_disk_speed_preference.
Required?: false Position?: named Default value?: no_disk_speed_preference Accept pipeline input?: true Accept wildcard characters?: false Parameter: AccessType <string>
Specifies the type of access to the new volume. Enter (r)ead_only or read_(w)rite for the access type.
Required?: false Position?: named Default value?: read_write Accept pipeline input?: true Accept wildcard characters?: false Parameter: DriveTypePreference <string>
Specifies the preferred drive type when selecting a drive on which to create the new volume. If specifying a preference, enter SAS or SATA for the drive type. Otherwise, skip this parameter or enter (n)o_drive_type_preference.
Required?: false Position?: named Default value?: no_drive_type_preference Accept pipeline input?: true Accept wildcard characters?: false Parameter: LoadBalance <string>
57
Specifies whether load balancing should be enabled or disabled for the new volume. Enter (y)es to enable or (n)o to disable load balancing.
Required?: false Position?: named Default value?: yes Accept pipeline input?: true Accept wildcard characters?: false Parameter: iSCSIAlias [<string>]
Specifies an alias for the iSCSI identifier used for the volume.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: OnlineStatus <string>
Specifies whether the new volume should be set online or offline. Enter (on)line to set it online or (off)line to set it offline.
Required?: false Position?: named Default value?: online Accept pipeline input?: true Accept wildcard characters?: false Parameter: RAIDTypePreference <string>
Specifies the preferred RAID type when selecting a drive on which to create the new volume. If specifying a preference for the RAIDtype, enter 5 for RAID5, 6 for RAID6, 10 for RAID10, or 50 for RAID50. Otherwise, skip this parameter or enter 0 or (n)o_raid_type_preference.
Required?: false Position?: named Default value?: no_raid_type_preference Accept pipeline input?: true Accept wildcard characters?: false Parameter: AllowMultipleInitiators <string>
Specifies whether to allow iSCSI connections from more than one initiator for the new volume. Enter (y)es to allow or (n)o to not allow sharing of the volume.
Required?: false Position?: named Default value?: no Accept pipeline input?: true Accept wildcard characters?: false Parameter: VolumeDescription [<string>]
58
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: SnapshotReserveWarnPercent <uint>
Specifies the percent of the snapshot reserve that can be used before a low space warning is issued.
Required?: false Position?: named Default value?: 80 Accept pipeline input?: true Accept wildcard characters?: false Parameter: SnapshotDeletionPolicy <string>
Specifies the policy to apply when the snapshot reserve is insufficient to create snapshots of the new volume. Enter (m)ake_volume_offline, (d)elete_oldest, or (s)top_snapshots for the policy.
Required?: false Position?: named Default value?: delete_oldest Accept pipeline input?: true Accept wildcard characters?: false Parameter: ThinProvision <string>
Specifies whether the new volume should be thin provisioned. Enter (y)es to thin provision the new volume or (n)o to allocate space for the full requested size of the new volume.
Required?: false Position?: named Default value?: no Accept pipeline input?: true Accept wildcard characters?: false Parameter: ThinProvisionMinReservePercent <uint>
Specifies the percent of the requested volume size to reserve for the new volume when it is created (minimum 10 percent).
Required?: false Position?: named Default value?: 10 Accept pipeline input?: true Accept wildcard characters?: false Parameter: ThinProvisionWarningPercent <uint>
Specifies the percent of the requested volume size that can be used before a warning is issued.
Required?: false Position?: named
59
Default value?: 60 Accept pipeline input?: true Accept wildcard characters?: false Parameter: ThinProvisionMaxGrowPercent <uint>
Specifies the percent of the requested volume size to which the new volume can grow before the total size specified for the volume must be increased.
Required?: false Position?: named Default value?: 100 Accept pipeline input?: true Accept wildcard characters?: false Parameter: PassThru [<SwitchParameter>]
Specifies that the cmdlet should return an EQL_VOLUME_SPEC object for the new volume on successful completion.
Required?: false Position?: named Default value?: false Accept pipeline input? false Accept wildcard characters?: false
Examples
Example 1 This command creates a 10GB (10000MB) volume named MyVolume on the current PS Group in this runspace with a snapshot reserve of 20GB (200 percent of the volume size) with the default values for all optional parameters.
C:\PS>New-EqlVolume -VolumeName MyVolume -VolumeSizeMB 10000 -SnapshotReservePercent 200
Example 2 This command creates a 10GB (2 GB initial size), writable, thin-provisioned volume named MyVolume on the current PS Series group in this runspace. The snapshot reserve is 4GB (200 percent of the initial volume size), and for all other optional parameters, the defaul value will be set.
C:\PS>New-EqlVolume -VolumeName MyVolume -VolumeSizeMB 10000 -SnapshotReservePercent 200 -ThinProvision yes -ThinProvisonMinReservePercent 20 -AccessType read_write
Example 3 This command creates a volume named MyVolume2 on the current PS Group in this runspace with the same settings as MyVolume1.
C:\PS>Get-EqlVolume -VolumeName MyVolume1 | New-EqlVolume -VolumeName MyVolume2
60
Related Commands
Connect-EqlGroup cmdlet Get-EqlVolume cmdlet Set-EqlVolume cmdlet Remove-EqlVolume cmdlet Get-EqlPool cmdlet New-EqlVolumeACL cmdlet Get-EqlVolumeACL cmdlet Remove-EqlVolumeACL cmdlet
Get-EqlVolume cmdlet
Retrieves the configuration and current statistics for one or more volumes on a PS Series group.
Command Syntax
Get-EqlVolume [-GroupName <string>] [-GroupAddress <string>] [-VolumeName <string>] [-MemberIndex <uint>] [-VolumeIndex <uint>] [-UseIndex [<SwitchParameter>]][<CommonParameters>]
Command Description
The Get-EqlVolume cmdlet retrieves the configuration and statistics for a volume identified by name on a PS Series group to which a connection exists in the current PowerShell runspace. If you are connected to more than one group, you can specify the target group using either the GroupName or GroupAddress parameter. If a volume name is not specified, this command will retrieve the information for all volumes on a PS Series group to which the connected administrative user has access. The information retrieved by this command can be piped into other cmdlets that act on volumes, such as New-EqlVolume, New-EqlVolumeACL or New-EqlReplica. Use Get-EqlVolumeACL to retrieve access control lists for a volume.
Inputs
None.
Outputs
Interop.EqlPsaMgmtAPI.EQL_VOLUME_SPEC.
You can pipe objects from Get-EqlVolume to other cmdlets, such as Set-EqlVolume. Pipe the objects through format-list to filter out parameters that you do not want to use.
61
Command Parameters
Parameter: GroupName <string>
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. Either this parameter or the GroupName parameter can be used to identify a group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: GroupAddress <string>
Specifies the IP address of a PS Series group for which a session was exists in this PowerShell runspace. This parameter can be either IPv4 or IPv6. Either this parameter or the GroupName parameter can be used to identify a Group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: VolumeName <string>
Specifies the name of a volume on a PS Series group that identifies the volume to which this cmdlet applies. This name is case-sensitive.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: MemberIndex <uint>
Specifies the member index that is used with the volume index to uniquely identify a volume.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: VolumeIndex <uint>
Specifies the volume index that is used with the member index to uniquely identify a volume.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false
62
Specifies that the cmdlet should use the MemberIndex and VolumeIndex parameter values to identify a volume instead of the volume name. This is a faster method for getting access to the volume.
Required?: false Position?: named Default value?: false Accept pipeline input?: false Accept wildcard characters?: false
Examples
Example 1 This command retrieves the configuration and current statistics for MyVolume.
C:\PS>Get-EqlVolume -VolumeName MyVolume
When you execute the Get-EqlVolume cmdlet for MyVolume, a list of MyVolume's properties, statistics, and values is output to the console. Sample output is as follows:
volumeName : MyVolume VolumeSizeMB : 100 DiskSpeedPreference : no_disk_speed_preference StoragePoolName : default AccessType : read_write DriveTypePreference : no_drive_type_preference LoadBalance : yes iSCSIAlias : ThinProvision : no ThinProvisionMinReservePercent : 0 ThinProvisionWarningPercent : 0 ThinProvisionMaxGrowPercent : 0 OnlineStatus : online VolumeDescription : RaidTypePreference : no_raid_type_preference AllowMultipleInitiators : no SnapshotDeletionPolicy : delete_oldest SnapshotReservePercent : 100 SnapshotReserveWarnPercent : 80 PSVID : 6-090A06-8407663B8-62C1548A8C10F23E PSVIDAsGuid : 68A09060-7640-B863-62C1-548A8C10F23E ISCSITargetName : iqn.2001-05.com.equallogic:0-8a0906-b863764063ef2108c8a54c162-MyVolume DynamicThinReserveMB : 0 TemplateVolume : no ThinClone : no CloneSourcePsvid : 00000000-0000-0000-0000-000000000000 AllocatedMB : 0 SnapshotReserveAvailableMB : 105 OperationalStatus : available SnapshotReserveMB : 105 SnapshotCount : 3 ISCSIConnectionCount : 0 SpannedMemberCount : 1 ReplicaCount : 0
63
Example 2 This command gets the configuration and current statistics for every volume on a PS Series group.
C:\PS>Get-EqlVolume
Example 3 This command gets the configuration and current statistics for every volume on a PS Series group, and then pipes the output to the PowerShell Sort-Object cmdlet, which then pipes the sorted data to the PowerShell Format-Table cmdlet. The below command outputs a table sorted by VolumeSizeMB in descending order, and shows the VolumeName, VolumeSize, and AccessType for each volume on the PS Series group.
C:\PS>Get-EqlVolume | Sort-object volumesizeMB -descending | format-table -autosize volumeName, volumesizeMB, accessType
---------------------- ------------------- -------------AcceleratorTest 1572864 AcceleratorTest2 307200 AcceleratorTest3 307200 gh-rhel6-v1 gh-v1 am-vol5 am-vol4 COMPUTE-6 COMPUTE-3 COMPUTE-4 COMPUTE-5 COMPUTE-2 COMPUTE-7 COMPUTE-9 COMPUTE-14 COMPUTE-13 COMPUTE-3-BASE COMPUTE-15 COMPUTE-11 COMPUTE-10 COMPUTE-8 COMPUTE-12 COMPUTE-2-BASE 122880 81920 51200 40960 40000 40000 40000 40000 40000 40000 40000 40000 40000 40000 40000 40000 40000 40000 40000 40000 read_write read_write read_write read_write read_write read_write read_write read_write read_write read_write read_write read_write read_write read_write read_write read_write read_only read_write read_write read_write read_write read_write read_only
64
VolumeName
VolumeSizeMB
AccessType
---------------------- ------------------- -------------FIRST-BASE-BASE 40000 am-vol3 wintest wintest2 Volume1-PD 30720 20480 20480 20480 read_write read_write read_write read_write read_write
Example 4 This command gets the member and volume indices for every volume on a PS Series group, pipes the output to the New-EqlSnapshot cmdlet to create a new snapshot for every volume. The UseIndex parameter causes the New-EqlSnapshot cmdlet to identify the volume using the MemberIndex and VolumeIndex parameters piped from the Get-EqlVolume cmdlet. This results in significantly faster execution on arrays that have many volumes.
C:\PS>Get-EqlVolume | New-EqlSnapshot -UseIndex
Related Commands
Connect-EqlGroup cmdlet New-EqlVolume cmdlet Set-EqlVolume cmdlet Remove-EqlVolume cmdlet New-EqlVolumeACL cmdlet Get-EqlVolumeACL cmdlet Remove-EqlVolumeACL cmdlet
Set-EqlVolume cmdlet
Changes the settings of a volume on a PS Series group.
Command Syntax
Set-EqlVolume [-GroupName <string>] [-GroupAddress <string>] -VolumeName <string> [-NewVolumeName <string>] [-MemberIndex <uint>] [-VolumeIndex <uint>] [-UseIndex [<SwitchParameter>]][-VolumeSizeMB <uint>] [-SnapshotReservePercent <uint>] [-StoragePoolName <string>] [-AccessType <string>] [-LoadBalance <string>] [-iSCSIAlias [<string>]] [-OnlineStatus <string>] [-RAIDTypePreference <string>] [-AllowMultipleInitiators <string>] [-VolumeDescription [<string>]] [-SnapshotReserveWarnPercent <uint>] [-SnapshotDeletionPolicy <string>] [-ThinProvision <string>] [-ThinProvisionMinReservePercent <uint>]
65
Command Description
The Set-EqlVolume cmdlet modifies the configuration of a volume identified by name on a PS Series group to which a connection exists in the current PowerShell runspace. If you are connected to more than one group, you can specify the target group using either the GroupName or GroupAddress parameter. One or more parameters, such as the AccessType, VolumeName, VolumeSizeMB, or ThinProvision parameter, can be specified in a single call to Set-EqlVolume. Use the New-EqlVolumeACL and Remove-EqlVolumeACL cmdlets to modify access control lists for a volume. To delete a volume, use the Remove-EqlVolume cmdlet.
Inputs
Interop.EqlPsaMgmtAPI.EQL_VOLUME_SPEC
You can pipe objects from Get-EqlVolume to Set-EqlVolume. Pipe the objects through format-list to filter out parameters that you do not want to set.
Outputs
Returns a string acknowledging the successful completion of the cmdlet action, or an Interop.EqlPsaMgmtAPI.EQL_VOLUME_SPEC object if the PassThru parameter is present.
Command Parameters
Parameter: GroupName <string>
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. Either this parameter or the GroupName parameter can be used to identify a group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: GroupAddress <string>
Specifies the IP address of a PS Series group for which a session was exists in this PowerShell runspace. This parameter can be either IPv4 or IPv6. Either this parameter or the GroupName parameter can be used to identify a Group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: VolumeName <string>
66
Specifies the name of a volume on a PS Series group that identifies the volume to which this cmdlet applies. This name is case-sensitive.
Required?: true Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: NewVolumeName <string>
Changes the name for an existing volume. This name must be unique on the PS Group and is case-sensitive.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: MemberIndex <uint>
Specifies the member index that is used with the volume index to uniquely identify a volume.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: VolumeIndex <uint>
Specifies the volume index that is used with the member index to uniquely identify a volume.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: UseIndex [<SwitchParameter>]
Specifies that the cmdlet should use the MemberIndex and VolumeIndex parameter values to identify a volume instead of the volume name. This is a faster method for getting access to the volume.
Required?: false Position?: named Default value?: false Accept pipeline input?: false Accept wildcard characters?: false Parameter: VolumeSizeMB <uint>
67
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: SnapshotReservePercent <uint>
Changes the percent of the volume size set aside for snapshot reserve.
Required?: false Position?: named Default value?: 100 Accept pipeline input?: true Accept wildcard characters?: false Parameter: StoragePoolName <string>
Specifies the name of a new pool to which the volume should be moved. The name is case-sensitive.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: AccessType <string>
Changes the type of access to the volume. Enter (r)ead_only or read_(w)rite for the access type. The volume must be offline to change the AccessType. Use the OnlineStatus parameter to set the volume offline, if necessary.
Required?: false Position?: named Default value?: read_write Accept pipeline input?: true Accept wildcard characters?: false Parameter: LoadBalance <string>
Changes whether load balancing is enabled or disabled for the volume. Enter (y)es to enable or (n)o to disable load balancing.
Required?: false Position?: named Default value?: yes Accept pipeline input?: true Accept wildcard characters?: false Parameter: iSCSIAlias [<string>]
Changes the alias for the iSCSI identifier used for the volume. Enter the parameter without a value to clear the alias.
Required?: false
68
Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: OnlineStatus <string>
Changes whether the volume is online or offline. Enter (on)line to set it online or (off)line to set it offline.
Required?: false Position?: named Default value?: online Accept pipeline input?: true Accept wildcard characters?: false Parameter: RAIDTypePreference <string>
Changes the preferred RAID type when selecting a drive to which to move the volume. If specifying a preference for RAID type, enter 5 for RAID5, 6 for RAID6, 10 for RAID10, or 50 for RAID50. Otherwise, enter 0 or (n)o_raid_type_preference to clear a previous value.
Required?: false Position?: named Default value?: no_raid_type_preference Accept pipeline input?: true Accept wildcard characters?: false Parameter: AllowMultipleInitiators <string>
Changes whether to allow iSCSI connections from more than one initiator for the volume. Enter (y)es to allow or (n)o to not allow sharing of the volume.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: VolumeDescription [<string>]
Changes the description of the volume (up to a maximum of 255 characters). Use this parameter without a value to clear the description.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: SnapshotReserveWarnPercent <uint>
Changes the percent of the snapshot reserve that can be used before a low space warning is issued.
Required?: false
69
Position?: named Default value?: 100 Accept pipeline input?: true Accept wildcard characters?: false Parameter: SnapshotDeletionPolicy <string>
Changes the policy to apply when the snapshot reserve is insufficient to create snapshots of the volume. Enter (m)ake_volume_offline, (d)elete_oldest, or (s)top_snapshots for the policy.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: ThinProvision <string>
Changes whether the new volume is thin provisioned. Enter (y)es to thin provision the volume or (n)o to allocate space for the full requested size of the volume.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: ThinProvisionMinReservePercent <uint>
Changes the percent of the requested volume size to reserve for the volume if it is thin provisioned (minimum 10 percent).
Required?: false Position?: named Default value?: 10 Accept pipeline input?: true Accept wildcard characters?: false Parameter: ThinProvisionWarningPercent <uint>
Changes the percent of the requested volume size that can be used before a warning is issued if it is thin provisioned.
Required?: false Position?: named Default value?: 60 Accept pipeline input?: true Accept wildcard characters?: false Parameter: ThinProvisionMaxGrowPercent <uint>
Changes the percent of the requested volume size to which the volume can grow before the total size of the volume must be increased if it is thin provisioned.
Required?: false Position?: named
70
Default value?: 100 Accept pipeline input?: true Accept wildcard characters?: false Parameter: PassThru [<SwitchParameter>]
Specifies that the cmdlet should return an EQL_VOLUME_SPEC object for the changed volume on successful completion.
Required?: false Position?: named Default value?: false Accept pipeline input?: false Accept wildcard characters?: false
Examples
Example 1 This command renames MyVolume to MyBiggerVolume, sets the size to 20GB (20000MB), sets the access to read-only, and places the volume offline. The volume must be set offline to change the AccessType.
C:\PS>Set-EqlVolume -VolumeName MyVolume -NewVolumeName MyBiggerVolume -VolumeSizeMB 20000 -AccessType read_only -OnlineStatus offline
Example 2 This command change MyVolume to thin-provisioned volume with a minimum size of 20 percent of the original volume size and makes the volume writable.
C:\PS>Set-EqlVolume -VolumeName MyVolume -ThinProvision yes -ThinProvisonMinReservePercent 20 -AccessType read_write
Related Commands
Connect-EqlGroup cmdlet New-EqlVolume cmdlet Get-EqlVolume cmdlet Remove-EqlVolume cmdlet Get-EqlPool cmdlet New-EqlVolumeACL cmdlet Get-EqlVolumeACL cmdlet Remove-EqlVolumeACL cmdlet
Remove-EqlVolume cmdlet
Deletes a specified volume and its snapshots, schedules, and ACLs from a PS Series group.
71
Command Syntax
Remove-EqlVolume [-GroupName <string>] [-GroupAddress <string>] -VolumeName <string> [-MemberIndex <uint>] [-VolumeIndex <uint>] [-UseIndex [<SwitchParameter>]][-Force [<SwitchParameter>]] [<CommonParameters>]
Command Description
The Remove-EqlVolume cmdlet deletes a volume identified by name and all of its snapshots, schedules, and ACLs from a PS Series group. If you are connected to more than one group, you can specify the target group using either the GroupName or GroupAddress parameter. This cmdlet will display a prompt to the console to confirm the deletion. The -Force parameter can be used to suppress this prompt for scripts. Use the Remove-EqlVolumeACL to delete access control lists for a volume. Use Remove-EqlSnapshot to delete snapshots of a volume.
Inputs
None.
Outputs
None. Returns a string acknowledging the successful completion of the cmdlet action.
Command Parameters
Parameter: GroupName <string>
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. Either this parameter or the GroupName parameter can be used to identify a group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: GroupAddress <string>
Specifies the IP address of a PS Series group for which a session was exists in this PowerShell runspace. This parameter can be either IPv4 or IPv6. Either this parameter or the GroupName parameter can be used to identify a Group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: VolumeName <string>
72
Specifies the name of a volume on a PS Series group that identifies the volume to which this cmdlet applies. This name is case-sensitive.
Required?: true Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: MemberIndex <uint>
Specifies the member index that is used with the volume index to uniquely identify a volume.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: VolumeIndex <uint>
Specifies the volume index that is used with the member index to uniquely identify a volume.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: UseIndex [<SwitchParameter>]
Specifies that the cmdlet should use the MemberIndex and VolumeIndex parameter values to identify a volume instead of the volume name. This is a faster method for getting access to the volume.
Required?: false Position?: named Default value?: false Accept pipeline input?: false Accept wildcard characters?: false Parameter: Force [<SwitchParameter>]
Specifies that the cmdlet should bypass the confirmation prompt and delete the volume.
Required?: false Position?: named Default value?: false Accept pipeline input?: false Accept wildcard characters?: false
73
Examples
Example 1 This command displays a dialog requesting confirmation, and if confirmed, deletes MyVolume, all of its ACLs, all of its schedules, and all of its snapshots.
C:\PS>Remove-EqlVolume -VolumeName MyVolume
Example 2 This command deletes MyVolume, all of its ACLs, all of its schedules, and all of its snapshots without asking for confirmation.
C:\PS>Remove-EqlVolume -VolumeName MyVolume -Force
Related Commands
Connect-EqlGroup cmdlet New-EqlVolume cmdlet Get-EqlVolume cmdlet Set-EqlVolume cmdlet New-EqlVolumeACL cmdlet Get-EqlVolumeACL cmdlet Remove-EqlVolumeACL cmdlet
New-EqlVolumeACL cmdlet
Creates and adds an access control list to the specified volume.
Command Syntax
New-EqlVolumeACL [-GroupName <string>] [-GroupAddress <string>] -VolumeName <string> [-MemberIndex <uint>] [-VolumeIndex <uint>] [-UseIndex [<SwitchParameter>]] [-InitiatorName <string>] [-InitiatorIpAddress <string>] [-InitiatorIpMask <string>] [-Username <string>] -AclTargetType <string> [<CommonParameters>]
Command Description
The New-EqlVolumeACL cmdlet creates an ACLs for a volume identified by name on a PS Series group. If you are connected to more than one group, you can specify the target group using either the GroupName or GroupAddress parameter. Each ACL consists of at least one of the following: InitiatorName, Username (CHAP user), and InitiatorIpAddress/InitiatorIpMask. The new ACL will also apply to any existing or new snapshots of the volume if the AclTargetType is set to
74
snapshots_only or volumes_and_snapshots. Use the Get-EqlVolumeACL cmdlet to list the access control lists for a volume. Use the Remove-EqlVolumeACL cmdlet to delete one or more ACLs from a volume.
Inputs
Interop.EqlPsaMgmtAPI.EQL_ACL_SPEC
The output of Get-EqlVolumeACL for a volume can be piped to New-EqlVolumeACL to copy the ACLs from one volume to another.
Outputs
None. Returns a string acknowledging the successful completion of the cmdlet action.
Command Parameters
Parameter: GroupName <string>
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. Either this parameter or the GroupName parameter can be used to identify a group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: GroupAddress <string>
Specifies the IP address of a PS Series group for which a session was exists in this PowerShell runspace. This parameter can be either IPv4 or IPv6. Either this parameter or the GroupName parameter can be used to identify a Group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: VolumeName <string>
Specifies the name of a volume on a PS Series group that identifies the volume to which this cmdlet applies. This name is case-sensitive.
Required?: true Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: MemberIndex <uint>
Specifies the member index that is used with the volume index to uniquely identify a volume.
75
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: VolumeIndex <uint>
Specifies the volume index that is used with the member index to uniquely identify a volume.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: UseIndex [<SwitchParameter>]
Specifies that the cmdlet should use the MemberIndex and VolumeIndex parameter values to identify a volume instead of the volume name. This is a faster method for getting access to the volume.
Required?: false Position?: named Default value?: false Accept pipeline input?: false Accept wildcard characters?: false Parameter: InitiatorName <string>
Specifies the IQN of an iSCSI initiator which is being granted access to the specified volume.
Required? false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: InitiatorIpAddress <string>
Specifies the IP Address of a host machine which is being granted access to the specified volume. This parameter must be IPv4. Asterisks can be used to specify a subnet. If asterisks are used in the IP Address, do not use the InitiatorIPMask parameter.
Required? false Position?: named Default value?: 0.0.0.0 Accept pipeline input?: true Accept wildcard characters?: true Parameter: InitiatorIpMask <string>
Specifies the IP Address Mask to be used with the InitiatorIpAddress to identify a subnet which is being granted access to the specified volume. This parameter must be IPv4. If you use asterisks in the InitiatorIPAddress to indicate a subnet, do not use this parameter.
76
Required? false Position?: named Default value?: 255.255.255.255 Accept pipeline input?: true Accept wildcard characters?: false Parameter: Username <string>
Specifies a CHAP username which is being granted access to the specified volume.
Required? false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: AclTargetType <string>
Specifies whether access is granted to volumes, snapshots, or both. Enter (v)olume_only, (s)napshot_only, or volume_(a)nd_snapshot to indicate the access granted.
Required?: true Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false
Examples
Example 1 This command grants volume only access to MyVolume to the host machine with iqn.1991-05.com.microsoft:mycomputer.mydomain.com.
C:\PS>New-EqlVolumeACL -VolumeName MyVolume -InitiatorName iqn.1991-05.com.microsoft:mycomputer.mydomain.com -ACLTargetType volume_only
Example 2 Both of the following two commands grant access to MyVolume and its snapshots to host machines in the 10.100.100.1/255.255.255.0 subnet.
C:\PS>New-EqlVolumeACL -VolumeName MyVolume -InitiatorIpAddress 10.100.100.1 -InitiatorIpMask 255.255.255.0 -ACLTargetType volume_and_snapshot C:\PS>New-EqlVolumeACL -VolumeName MyVolume -InitiatorIpAddress 10.100.100.* -ACLTargetType volume_and_snapshot
Example 3 This command copies the access control lists from MyVolume1 to MyVolume2.
C:\PS>Get-EqlVolumeACL -VolumeName MyVolume1 | New-EqlVolumeACL -VolumeName MyVolume2
77
Example 4 This command grants access to MyVolume and its snapshots to host machines in the 10.100.100.1/255.255.255.0 subnet using the * as a wildcard in the IP Address to indicate the subnet.
C:\PS>New-EqlVolumeACL -VolumeName MyVolume -InitiatorIpAddress 10.100.100.* -ACLTargetType volume_and_snapshot
Example 5 This command gets the member and volume indices for every volume on a PS Series group, pipes the output to the New-EqlVolumeACL cmdlet to add an ACL that provides access to the volumes and their snapshots to any host in the 10.200.*.* subnet. The UseIndex parameter causes the New-EqlVolumeACL cmdlet to identify the volume using the MemberIndex and VolumeIndex parameters piped from the Get-EqlVolume cmdlet. This results in significantly faster execution on arrays that have many volumes.
C:\PS>Get-EqlVolume | New-EqlVolumeACL -UseIndex -InitiatorIpAddress 10.200.*.* -ACLTargetType volumes_and_snapshots
Related Commands
Connect-EqlGroup cmdlet New-EqlVolume cmdlet Set-EqlVolume cmdlet Remove-EqlVolume cmdlet Get-EqlVolumeACL cmdlet Remove-EqlVolumeACL cmdlet
Get-EqlVolumeACL cmdlet
Retrieves the ACLs for the specified volume.
Command Syntax
Get-EqlVolumeACL [-GroupName <string>] [-GroupAddress <string>] -VolumeName <string> [-MemberIndex <uint>] [-VolumeIndex <uint>] [-UseIndex [<SwitchParameter>]] [<CommonParameters>]
Command Description
The Get-EqlVolumeACL cmdlet retrieves all of the ACLs for a volume identified by name on a PS Series group. If you are connected to more than one group, you can specify the target group using either the GroupName or GroupAddress parameter. Each ACL consists of at least one of the following: InitiatorName, Username (CHAP user), and InitiatorIpAddress. The information
78
retrieved by this command can be piped into the New-EqlVolumeACL command to copy the access control lists from one volume to another. Use the New-EqlVolumeACL to add an access control list to a volume. Use the Remove-EqlVolumeACL cmdlet to delete one or more ACLs from a volume.
Inputs
None.
Outputs
Interop.EqlPsaMgmtAPI.EQL_ACL_SPEC.
You can pipe objects from Get-EqlVolumeACL to other cmdlets, such as Set-EqlVolumeACL. Pipe the objects through format-list to filter out parameters that you do not want to set.
Command Parameters
Parameter: GroupName <string>
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. Either this parameter or the GroupName parameter can be used to identify a group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: GroupAddress <string>
Specifies the IP address of a PS Series group for which a session was exists in this PowerShell runspace. This parameter can be either IPv4 or IPv6. Either this parameter or the GroupName parameter can be used to identify a Group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: VolumeName <string>
Specifies the name of a volume on a PS Series group that identifies the volume to which this cmdlet applies. This name is case-sensitive.
Required?: true Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: MemberIndex <uint>
Specifies the member index that is used with the volume index to uniquely identify a volume.
79
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: VolumeIndex <uint>
Specifies the volume index that is used with the member index to uniquely identify a volume.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: UseIndex [<SwitchParameter>]
Specifies that the cmdlet should use the MemberIndex and VolumeIndex parameter values to identify a volume instead of the volume name. This is a faster method for getting access to the volume.
Required?: false Position?: named Default value?: false Accept pipeline input?: false Accept wildcard characters?: false
Example
This command gets all of the ACLs for MyVolume.
C:\PS>Get-EqlVolumeACL -VolumeName MyVolume
Related Commands
Connect-EqlGroup cmdlet New-EqlVolume cmdlet Set-EqlVolume cmdlet Remove-EqlVolume cmdlet New-EqlVolumeACL cmdlet Remove-EqlVolumeACL cmdlet
Remove-EqlVolumeACL cmdlet
Removes one or all ACLs from the specified volume.
80
Command Syntax
Remove-EqlVolumeACL [-GroupName <string>] [-GroupAddress <string>] -VolumeName <string> [-MemberIndex <uint>] [-VolumeIndex <uint>] [-UseIndex [<SwitchParameter>]] -AclIndex <uint> [<CommonParameters>]
Command Description
The Remove-EqlVolumeACL cmdlet removes the ACL with the specified index from a volume identified by name on a PS Series group to which a connection exists in the current PowerShell runspace. If you are connected to more than one group, you can specify the target group using either the GroupName or GroupAddress parameter. If an index is not specified, all ACLs are removed from the volume. Use the Get-EqlVolumeACL cmdlet to get the index for each of the ACLs on a volume.
Inputs
None.
Outputs
Returns a string acknowledging successful completion of the cmdlet action.
Command Parameters
Parameter: GroupName <string>
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. Either this parameter or the GroupName parameter can be used to identify a group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: GroupAddress <string>
Specifies the IP address of a PS Series group for which a session was exists in this PowerShell runspace. This parameter can be either IPv4 or IPv6. Either this parameter or the GroupName parameter can be used to identify a Group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: VolumeName <string>
81
Specifies the name of a volume on a PS Series group that identifies the volume to which this cmdlet applies. This name is case-sensitive.
Required?: true Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: MemberIndex <uint>
Specifies the member index that is used with the volume index to uniquely identify a volume.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: VolumeIndex <uint>
Specifies the volume index that is used with the member index to uniquely identify a volume.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: UseIndex [<SwitchParameter>]
Specifies that the cmdlet should use the MemberIndex and VolumeIndex parameter values to identify a volume instead of the volume name. This is a faster method for getting access to the volume.
Required?: false Position?: named Default value?: false Accept pipeline input?: false Accept wildcard characters?: false Parameter: AclIndex <uint>
Specifies the index of the ACL to be removed from the specified volume. If no index is specified, all ACLs are removed from the volume.
Required?: true Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false
Example
This command removes the ACL with an AclIndex of 1 from MyVolume.
C:\PS>Remove-EqlVolumeACL -VolumeName MyVolume -AclIndex 1
82
Related Commands
Connect-EqlGroup cmdlet New-EqlVolume cmdlet Set-EqlVolume cmdlet Remove-EqlVolume cmdlet New-EqlVolumeACL cmdlet
New-EqlVolumeClone cmdlet
Creates a clone of the specified volume on a PS Series group.
Command Syntax
New-EqlVolumeClone [-GroupName <string>] [-GroupAddress <string>] -VolumeName <string> [-MemberIndex <uint>] [-VolumeIndex <uint>] [-UseIndex [<SwitchParameter>]] -CloneName <string> [-StoragePoolName <string>] [-CloneDescription <string>] [<CommonParameters>]
Command Description
The New-EqlVolumeClone cmdlet creates a clone of a volume identified by name on a PS Series group to which a connection exists in the current PowerShell runspace. If you are connected to more than one group, you can specify the target group using either the GroupName or GroupAddress parameter. The clone can be created in a specified pool. Additional actions can be performed on the newly created clone using volume cmdlets.
Inputs
None.
Outputs
None. Returns a string acknowledging the successful completion of the cmdlet action.
Command Parameters
Parameter: GroupName <string>
83
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. Either this parameter or the GroupName parameter can be used to identify a group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: GroupAddress <string>
Specifies the IP address of a PS Series group for which a session was exists in this PowerShell runspace. This parameter can be either IPv4 or IPv6. Either this parameter or the GroupName parameter can be used to identify a Group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: VolumeName <string>
Specifies the name of a volume on a PS Series group that identifies the volume to which this cmdlet applies. This name is case-sensitive.
Required?: true Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: MemberIndex <uint>
Specifies the member index that is used with the volume index to uniquely identify a volume.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: VolumeIndex <uint>
Specifies the volume index that is used with the member index to uniquely identify a volume.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: UseIndex [<SwitchParameter>]
84
Specifies that the cmdlet should use the MemberIndex and VolumeIndex parameter values to identify a volume instead of the volume name. This is a faster method for getting access to the volume.
Required?: false Position?: named Default value?: false Accept pipeline input?: false Accept wildcard characters?: false Parameter: CloneName <string>
Specifies the name of the pool in which the clone should be created.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: CloneDescription <string>
Examples
Example 1 This command creates a clone of MyVolume named MyVolumeClone with the same settings as MyVolume.
C:\PS>New-EqlVolumeClone -VolumeName MyVolume -CloneName MyVolumeClone
Example 2 This command creates a clone of MyVolume named MyVolumeClone in MyPool with the same settings as MyVolume.
85
Related Commands
Connect-EqlGroup cmdlet Get-EqlVolume cmdlet Set-EqlVolume cmdlet Remove-EqlVolume cmdlet New-EqlVolumeACL cmdlet Get-EqlVolumeACL cmdlet Remove-EqlVolumeACL cmdlet Set-EqlSnapshot cmdlet Get-EqlSnapshot cmdlet Remove-EqlSnapshot cmdlet
ConvertTo-EqlTemplateVolume cmdlet
Converts a volume on a PS Series group to a template volume.
Command Syntax
ConvertTo-EqlTemplateVolume [-GroupName <string>] [-GroupAddress <string>] -VolumeName <string> [-MemberIndex <uint>] [-VolumeIndex <uint>] [-UseIndex [<SwitchParameter>]] [-TimeoutSeconds <int>] [<CommonParameters>]
Command Description
The ConvertTo-EqlTemplateVolume cmdlet changes the volume identified by name on a PS Series group to a template volume that can be used for creating thin clones. If you are connected to more than one group, you can specify the target group using either the GroupName or GroupAddress parameter. The specified volume will be taken offline, set to read-only access, and thin provisioned as part of the conversion. This conversion is an asynchronous operation. Use the Get-EqlVolume cmdlet to verify that the TemplateVolume property equals yes before trying to use the template volume to create thin clones. Use the ConvertFrom-EqlTemplateVolume cmdlet to convert a TemplateVolume back to a normal volume.
Inputs
None.
86
Outputs
None. Returns a string acknowledging the successful completion of the cmdlet action.
Command Parameters
Parameter: GroupName <string>
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. Either this parameter or the GroupName parameter can be used to identify a group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: GroupAddress <string>
Specifies the IP address of a PS Series group for which a session was exists in this PowerShell runspace. This parameter can be either IPv4 or IPv6. Either this parameter or the GroupName parameter can be used to identify a Group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: VolumeName <string>
Specifies the name of a volume on a PS Series group that identifies the volume to which this cmdlet applies. This name is case-sensitive.
Required?: true Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: MemberIndex <uint>
Specifies the member index that is used with the volume index to uniquely identify a volume.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: VolumeIndex <uint>
Specifies the volume index that is used with the member index to uniquely identify a volume.
87
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: UseIndex [<SwitchParameter>]
Specifies that the cmdlet should use the MemberIndex and VolumeIndex parameter values to identify a volume instead of the volume name. This is a faster method for getting access to the volume.
Required?: false Position?: named Default value?: false Accept pipeline input?: false Accept wildcard characters?: false Parameter: TimeoutSeconds <int>
Specifies the number of seconds to wait while the volume is prepared for conversion.
Required?: false Position?: named Default value?: 0 Accept pipeline input?: true Accept wildcard characters?: false
Examples
Example 1 This command converts MyVolume to a template volume. MyVolume is offline, read-only and thin-provisioned after the conversion is completed.
C:\PS>ConvertTo-EqlTemplateVolume -VolumeName MyVolume
Example 2 This command converts MyVolume to a template volume. MyVolume is offline, read-only and thin-provisioned after the conversion is completed. If the conversion is not completed in 300 seconds, the cmdlet reports an error.
C:\PS>ConvertTo-EqlTemplateVolume -VolumeName MyVolume -TimeoutSeconds 300
Related Commands
Connect-EqlGroup cmdlet Get-EqlVolume cmdlet ConvertFrom-EqlTemplateVolume cmdlet New-EqlThinClone cmdlet
88
ConvertFrom-EqlTemplateVolume cmdlet
Converts a template volume to a regular volume on a PS Series Group.
Command Syntax
ConvertFrom-EqlTemplateVolume [-GroupName <string>] [-GroupAddress <string>] -VolumeName <string> [-MemberIndex <uint>] [-VolumeIndex <uint>] [-UseIndex [<SwitchParameter>]] [<CommonParameters>]
Command Description
The ConvertFrom-EqlTemplateVolume cmdlet changes the template volume identified by name on a PS Series group to a regular volume. If you are connected to more than one group, you can specify the target group using either the GroupName or GroupAddress parameter. If any thin clones created from the template are still attached to the template volume, this cmdlet will fail. Use the ConvertFrom-EqlThinClone cmdlet for each attached clone to detach it before using this cmdlet. Use the Set-EqlVolume cmdlet to change the AccessType, OnlineStatus, and ThinProvision properties to revert the changes made when the original volume was converted to a template volume.
Inputs
None.
Outputs
None. Returns a string acknowledging the successful completion of the cmdlet action.
Command Parameters
Parameter: GroupName <string>
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. Either this parameter or the GroupName parameter can be used to identify a group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: GroupAddress <string>
Specifies the IP address of a PS Series group for which a session was exists in this PowerShell runspace. This parameter can be either IPv4 or IPv6. Either this parameter or the GroupName parameter can be used to identify a Group for this cmdlet.
Required?: false
89
Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: VolumeName <string>
Specifies the name of a template volume on a PS Series group that identifies the volume to which this cmdlet applies. This name is case-sensitive.
Required?: true Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: MemberIndex <uint>
Specifies the member index that is used with the volume index to uniquely identify a volume.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: VolumeIndex <uint>
Specifies the volume index that is used with the member index to uniquely identify a volume.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: UseIndex [<SwitchParameter>]
Specifies that the cmdlet should use the MemberIndex and VolumeIndex parameter values to identify a volume instead of the volume name. This is a faster method for getting access to the volume.
Required?: false Position?: named Default value?: false Accept pipeline input?: false Accept wildcard characters?: false
Example
This command changes the template volume MyVolume back to a regular volume. MyVolume is left offline, read-only and thin-provisioned after the conversion is completed.
C:\PS>ConvertFrom-EqlTemplateVolume -VolumeName MyVolume
90
Related Commands
Connect-EqlGroup cmdlet Get-EqlVolume cmdlet ConvertTo-EqlTemplateVolume cmdlet ConvertFrom-EqlThinClone cmdlet
New-EqlThinClone cmdlet
Creates a thin clone of the specified template volume.
Command Syntax
New-EqlThinClone [-GroupName <string>] [-GroupAddress <string>] -VolumeName <string> [-MemberIndex <uint>] [-VolumeIndex <uint>] [-UseIndex [<SwitchParameter>]] -CloneName <string> [-CloneDescription <string>] [<CommonParameters>]
Command Description
The New-EqlThinClone cmdlet creates a clone of a template volume identified by name on a PS Series group to which a connection exists in the current PowerShell runspace. If you are connected to more than one group, you can specify the target group using either the GroupName or GroupAddress parameter. Additional actions can be performed on the newly created thin clone using volume cmdlets. Use the ConvertFrom-EqlThinClone cmdlet to detach the thin clone from its template.
Inputs
None.
Outputs
None. Returns a string acknowledging the successful completion of the cmdlet action.
Command Parameters
Parameter: GroupName <string>
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. Either this parameter or the GroupName parameter can be used to identify a group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true
91
Specifies the IP address of a PS Series group for which a session was exists in this PowerShell runspace. This parameter can be either IPv4 or IPv6. Either this parameter or the GroupName parameter can be used to identify a Group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: VolumeName <string>
Specifies the name of a template volume on a PS Series group that identifies the template volume to which this cmdlet applies. This name is case-sensitive.
Required?: true Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: MemberIndex <uint>
Specifies the member index that is used with the volume index to uniquely identify a volume.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: VolumeIndex <uint>
Specifies the volume index that is used with the member index to uniquely identify a volume.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: UseIndex [<SwitchParameter>]
Specifies that the cmdlet should use the MemberIndex and VolumeIndex parameter values to identify a volume instead of the volume name. This is a faster method for getting access to the volume.
Required?: false Position?: named Default value?: false Accept pipeline input?: false Accept wildcard characters?: false
92
Specifies the name to be used for the thin clone. This name must be unique in the PS Group and is case-sensitive.
Required?: true Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: CloneDescription <string>
Example
This command creates a thin clone of MyTemplateVolume named MyThinClone.
C:\PS>New-EqlThinClone -VolumeName MyTemplateVolume -CloneName MyThinClone
Related Commands
Connect-EqlGroup cmdlet Get-EqlVolume cmdlet Set-EqlVolume cmdlet Remove-EqlVolume cmdlet New-EqlVolumeACL cmdlet New-EqlSnapshot cmdlet Set-EqlSnapshot cmdlet Get-EqlSnapshot cmdlet Remove-EqlSnapshot cmdlet
ConvertFrom-EqlThinClone cmdlet
Detaches a thin clone from its template volume.
Command Syntax
ConvertFrom-EqlThinClone [-GroupName <string>] [-GroupAddress <string>] -CloneName <string> [<CommonParameters>]
93
Command Description
The ConvertFrom-EqlThinClone cmdlet detaches a thin clone from its template volume. If you are connected to more than one group, you can specify the target group using either the GroupName or GroupAddress parameter.
Inputs
None.
Outputs
None. Returns a string acknowledging the successful completion of the cmdlet action.
Command Parameters
Parameter: GroupName <string>
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. Either this parameter or the GroupName parameter can be used to identify a group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: GroupAddress <string>
Specifies the IP address of a PS Series group for which a session was exists in this PowerShell runspace. This parameter can be either IPv4 or IPv6. Either this parameter or the GroupName parameter can be used to identify a Group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: CloneName <string>
Specifies the name of the thin clone to be detached. This name is case-sensitive.
Required?: true Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false
Example
This command detaches the thin clone named MyThinClone from its template volume.
94
Related Commands
Connect-EqlGroup cmdlet Set-EqlVolume cmdlet Get-EqlVolume cmdlet Remove-EqlVolume cmdlet ConvertFrom-EqlTemplateVolume cmdlet New-EqlThinClone cmdlet
New-EqlReplica cmdlet
Creates a replica of the specified volume on a PS Series group.
Command Syntax
New-EqlReplica [-GroupName <string>] [-GroupAddress <string>] -VolumeName <string> [-MemberIndex <uint>] [-VolumeIndex <uint>] [-UseIndex [<SwitchParameter>]] -ReplicationSite <string> [<CommonParameters>]
Command Description
The New-EqlReplica cmdlet creates a replica of a volume identified by name on a PS Series group. If you are connected to more than one group, you can specify the target group using either the GroupName or GroupAddress parameter. The volume must be configured for replication. Use the New-ReplicationPartner cmdlet to create a replication partnership between this group and another group. Use the New-ReplicaSet cmdlet to configure a specific volume for replication to a replication partner. Additional actions can be performed on the newly created replica using replica cmdlets.
Inputs
None.
Outputs
None. Returns a string acknowledging the successful completion of the cmdlet action.
Command Parameters
Parameter: GroupName <string>
95
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. Either this parameter or the GroupName parameter can be used to identify a group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: GroupAddress <string>
Specifies the IP address of a PS Series group for which a session was exists in this PowerShell runspace. This parameter can be either IPv4 or IPv6. Either this parameter or the GroupName parameter can be used to identify a Group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: VolumeName <string>
Specifies the name of a volume on a PS Series group that identifies the volume to which this cmdlet applies. This name is case-sensitive. The volume must be configured for replication. Replication is a time consuming process and the replica will not be available for use immediately after the cmdlet completes.
Required?: true Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: MemberIndex <uint>
Specifies the member index that is used with the volume index to uniquely identify a volume.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: VolumeIndex <uint>
Specifies the volume index that is used with the member index to uniquely identify a volume.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: UseIndex [<SwitchParameter>]
96
Specifies that the cmdlet should use the MemberIndex and VolumeIndex parameter values to identify a volume instead of the volume name. This is a faster method for getting access to the volume.
Required?: false Position?: named Default value?: false Accept pipeline input?: false Accept wildcard characters?: false Parameter: ReplicationSite <string>
Specifies the name of a PS Series group that has been configured as the replication partner for the specified volume.
Required?: true Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false
Example
This command creates a replica of MyVolume on MyPartnerGroup.
C:\PS>New-EqlReplica -VolumeName MyVolume -ReplicationSite MyPartnerGroup
Related Commands
Connect-EqlGroup cmdlet Get-EqlVolume cmdlet Suspend-EqlReplication cmdlet Resume-EqlReplication cmdlet ConvertTo-EqlPromotedReplicaSet cmdlet ConvertTo-EqlDemotedReplicaSet cmdlet Remove-EqlReplicaSet cmdlet New-EqlReplicationPartner cmdlet Get-EqlReplicationPartner cmdlet New-EqlReplicaSet cmdlet Get-EqlReplicaSet cmdlet
97
6 Snapshot Cmdlets
New-EqlSnapshot cmdlet
Creates a snapshot of the specified volume.
Note: Snapshots created by the PowerShell Tools are crash consistent, and not
application consistent. To create application consistent snapshots, use the Auto-Snapshot Manager-Microsoft Edition (ASM/ME) console or the ASM CLI. The ASM CLI is a set of commands that you can execute at the Windows command prompt instead of using the ASM/ME GUI for Smart Copy operations. See the Auto-Snapshot Manager User Guide for more information.
Command Syntax
New-EqlSnapshot [-GroupName <string>] [-GroupAddress <string>] -VolumeName <string> [-MemberIndex <uint>] [-VolumeIndex <uint>] [-UseIndex [<SwitchParameter>]] [-SnapshotDescription <string>] [-AccessType <string>] [-OnlineStatus <string>] [-AllowMultipleInitiators <string>] [-PassThru [<SwitchParameter>]] [<CommonParameters>]
Command Description
The New-EqlSnapshot cmdlet creates a snapshot of a volume identified by name on a PS Series group to which a connection exists in the current PowerShell runspace. If you are connected to more than one group, you can specify the target group using either the GroupName or GroupAddress parameter. The snapshot can be created with a specified access type, online status, multiple initiator access, and description. Use the Get-EqlVolume cmdlet to list the snapshot reserve available for a volume. Use the Set-EqlSnapshot cmdlet to change or set any of the optional parameters that were not set at creation time.
Inputs
Interop.EqlPsaMgmtAPI.EQL_SNAPSHOT_SPEC
The output of Get-EqlSnapshot for any volume can be piped to New-EqlSnapshot to copy the snapshot parameters from one volume to another.
Outputs
Returns a string acknowledging the successful completion of the cmdlet action, or an Interop.EqlPsaMgmtAPI.EQL_SNAPSHOT_SPEC object if the PassThru parameter is present.
99
6 Snapshot Cmdlets
Command Parameters
Parameter: GroupName <string>
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. Either this parameter or the GroupName parameter can be used to identify a group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: GroupAddress <string>
Specifies the IP address of a PS Series group for which a session was exists in this PowerShell runspace. This parameter can be either IPv4 or IPv6. Either this parameter or the GroupName parameter can be used to identify a Group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: VolumeName <string>
Specifies the name of a volume on a PS Series group that identifies the volume to which this cmdlet applies. This name is case-sensitive.
Required?: true Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: MemberIndex <uint>
Specifies the member index that is used with the volume index to uniquely identify a volume.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: VolumeIndex <uint>
Specifies the volume index that is used with the member index to uniquely identify a volume.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false
100
6 Snapshot Cmdlets
Specifies that the cmdlet should use the MemberIndex and VolumeIndex parameter values to identify a volume instead of the volume name. This is a faster method for getting access to the volume.
Required?: false Position?: named Default value?: false Accept pipeline input?: false Accept wildcard characters?: false Parameter: SnapshotDescription <string>
Specifies whether multiple initiators will be allowed to connect to the snapshot at the same time. Enter (y)es to enable multiple initiator access or (n)o to disable it.
Required?: false Position?: named Default value?: no Accept pipeline input?: true Accept wildcard characters?: false Parameter: PassThru [<SwitchParameter>]
Specifies that the cmdlet should return an EQL_SNAPSHOT_SPEC object for the new snapshot on successful completion.
101
6 Snapshot Cmdlets
Required?: false Position?: named Default value?: false Accept pipeline input? false Accept wildcard characters?: false
Examples
Example 1 This command creates a snapshot of MyVolume with the default settings (read-write, offline, not-shared).
C:\PS>New-EqlSnapshot -VolumeName MyVolume
Example 2 This command creates a read-only snapshot of MyVolume that is online and allows connections from multiple initiators.
C:\PS>New-EqlSnapshot -VolumeName MyVolume -AllowMultipleInitiators yes -OnlineStatus online -AccessType read_only
Example 3 This command gets the member and volume indices for every volume on a PS Series group, pipes the output to the New-EqlSnapshot cmdlet to create a new snapshot for every volume. The UseIndex parameter causes the New-EqlSnapshot cmdlet to identify the volume using the MemberIndex and VolumeIndex parameters piped from the Get-EqlVolume cmdlet. This results in significantly faster execution on arrays that have many volumes.
C:\PS>Get-EqlVolume | New-EqlSnapshot -UseIndex
Related Commands
Connect-EqlGroup cmdlet New-EqlVolume cmdlet Set-EqlVolume cmdlet Remove-EqlVolume cmdlet New-EqlVolumeACL cmdlet Set-EqlSnapshot cmdlet Get-EqlSnapshot cmdlet Remove-EqlSnapshot cmdlet
102
6 Snapshot Cmdlets
Get-EqlSnapshot cmdlet
Retrieves information for one or more snapshots of the specified volume.
Command Syntax
Get-EqlSnapshot [-GroupName <string>] [-GroupAddress <string>] -VolumeName <string> [-MemberIndex <uint>] [-VolumeIndex <uint>] [-UseIndex [<SwitchParameter>]] [-SnapshotName <string>] [<CommonParameters>]
Inputs
None.
Outputs
Interop.EqlPsaMgmtAPI.EQL_SNAPSHOT_SPEC
You can pipe objects from Get-EqlSnapshot to other cmdlets, such as New-EqlSnapshot or Remove-EqlSnapshot. If you are connected to more than one group, you can specify the target group using either the GroupName or GroupAddress parameter. Pipe the objects through format-list to filter out parameters that you do not want to set.
Command Description
The Get-EqlSnapshot cmdlet retrieves the specified snapshot of a volume identified by name on a PS Series group to which a connection exists in the current PowerShell runspace. If a snapshot name is not specified, the information for all snapshots of the specified volume is retrieved. The information retrieved by this command can be piped into the New-EqlSnapshot command to copy the snapshot parameters from one volume snapshot to another.
Command Parameters
Parameter: GroupName <string>
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. Either this parameter or the GroupName parameter can be used to identify a group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: GroupAddress <string>
Specifies the IP address of a PS Series group for which a session was exists in this PowerShell runspace. This parameter can be either IPv4 or IPv6. Either this parameter or the GroupName parameter can be used to identify a Group for this cmdlet.
103
6 Snapshot Cmdlets
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: VolumeName <string>
Specifies the name of a volume on a PS Series group that identifies the volume to which this cmdlet applies. This name is case-sensitive.
Required?: true Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: MemberIndex <uint>
Specifies the member index that is used with the volume index to uniquely identify a volume.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: VolumeIndex <uint>
Specifies the volume index that is used with the member index to uniquely identify a volume.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: UseIndex [<SwitchParameter>]
Specifies that the cmdlet should use the MemberIndex and VolumeIndex parameter values to identify a volume instead of the volume name. This is a faster method for getting access to the volume.
Required?: false Position?: named Default value?: false Accept pipeline input?: false Accept wildcard characters?: false Parameter: SnapshotName <string>
Specifies the name of the snapshot of the specified volume to which this cmdlet applies. This name is case-sensitive.
Required?: false Position?: named
104
6 Snapshot Cmdlets
Default value?: none Accept pipeline input?: true Accept wildcard characters?: false
Examples
Example 1 This command retrieves information for all snapshots of MyVolume.
C:\PS>Get-EqlSnapshot -VolumeName MyVolume
This command outputs a PSObject with the values from an Interop.EqlPsaMgmtAPI.EQL_SNAPSHOT_SPEC. The following is the output:
SnapshotName : MyVolume-2010-06-10-08:00:00.1234 volumeName : MyVolume ISCSITargetName : iqn.2001-05.com.equallogic:0-290c06-711c90f74012000000294cd92-MyVolume-2010-06-10-08:00:00.1234 iSCSIAlias : MyVolume-2010-06-10-08:00:00.1234 AccessType : read_write SnapshotDescription : AllowMultipleInitiators : no OnlineStatus : online SnapshotSizeMB : 200 SnapshotPsvid : 6-0C0904-2F7901C71-92CD940200002001 SnapshotPsvidAsGuid : 4290C060-90F7-711C-92CD-940200002001 CreationTimeStamp : 06/10/10 08:00:00
Related Commands
Connect-EqlGroup cmdlet Get-EqlVolume cmdlet Remove-EqlVolume cmdlet New-EqlVolumeACL cmdlet Get-EqlVolumeACL cmdlet New-EqlSnapshot cmdlet Set-EqlSnapshot cmdlet Remove-EqlSnapshot cmdlet
105
6 Snapshot Cmdlets
Set-EqlSnapshot cmdlet
Changes the settings on a snapshot of the specified volume.
Command Syntax
Set-EqlSnapshot [-GroupName <string>] [-GroupAddress <string>] -VolumeName <string> [-MemberIndex <uint>] [-VolumeIndex <uint>] [-UseIndex [<SwitchParameter>]] -SnapshotName <string> [-NewSnapshotName <string>] [-iSCSIAlias <string>] [-SnapshotDescription [<string>]] [-AccessType <string>] [-OnlineStatus <string>] [-AllowMultipleInitiators <string>] [-PassThru [<SwitchParameter>]] [<CommonParameters>]
Command Description
The Set-EqlSnapshot cmdlet changes settings for a snapshot of a volume identified by name on a PS Series group to which a connection exists in the current PowerShell runspace. If you are connected to more than one group, you can specify the target group using either the GroupName or GroupAddress parameter. The snapshot name, iSCSI target alias, access type, online status, multiple initiator access, and description can be changed with this cmdlet. Use the Get-EqlVolume cmdlet to list the snapshot reserve available for a volume. Use the Set-EqlSnapshot cmdlet to change or set any of the optional parameters that were not set at creation time.
Inputs
Interop.EqlPsaMgmtAPI.EQL_SNAPSHOT_SPEC The output of Get-EqlSnapshot for any volume can be piped to Set-EqlSnapshot to copy the snapshot parameters from one snapshot to another.
Outputs
Returns a string acknowledging the successful completion of the cmdlet action, or an Interop.EqlPsaMgmtAPI.EQL_SNAPSHOT_SPEC object if the PassThru parameter is present.
Command Parameters
Parameter: GroupName <string>
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. Either this parameter or the GroupName parameter can be used to identify a group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true
106
6 Snapshot Cmdlets
Specifies the IP address of a PS Series group for which a session was exists in this PowerShell runspace. This parameter can be either IPv4 or IPv6. Either this parameter or the GroupName parameter can be used to identify a Group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: VolumeName <string>
Specifies the name of a volume on a PS Series group that identifies the volume to which this cmdlet applies. This name is case-sensitive.
Required?: true Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: MemberIndex <uint>
Specifies the member index that is used with the volume index to uniquely identify a volume.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: VolumeIndex <uint>
Specifies the volume index that is used with the member index to uniquely identify a volume.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: UseIndex [<SwitchParameter>]
Specifies that the cmdlet should use the MemberIndex and VolumeIndex parameter values to identify a volume instead of the volume name. This is a faster method for getting access to the volume.
Required?: false Position?: named Default value?: false Accept pipeline input?: false Accept wildcard characters?: false
107
6 Snapshot Cmdlets
Specifies the name of the snapshot of the specified volume to which this cmdlet applies. This name is case-sensitive.
Required?: true Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: NewSnapshotName <string>
Changes the name of the snapshot of the specified volume. This name must be unique for the volume and is case-sensitive.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: iSCSIAlias <string>
Changes whether the snapshot allows read-only or read-write access. The snapshot must be offline to change its access type. Use the OnlineStatus parameter to set the snapshot offline, if necessary.
Required?: false Position?: named Default value?: read-write Accept pipeline input?: true Accept wildcard characters?: false Parameter: OnlineStatus <string>
108
6 Snapshot Cmdlets
Required?: false Position?: named Default value?: offline Accept pipeline input?: true Accept wildcard characters?: false Parameter: AllowMultipleInitiators <string>
Changes whether multiple initiators are allowed to connect to the snapshot at the same time. Enter (y)es to enable multiple initiator access or (n)o to disable it.
Required?: false Position?: named Default value?: no Accept pipeline input?: true Accept wildcard characters?: false Parameter: PassThru [<SwitchParameter>]
Specifies that the cmdlet should return an EQL_SNAPSHOT_SPEC object for the changed snapshot on successful completion.
Required?: false Position?: named Default value?: false Accept pipeline input? false Accept wildcard characters?: false
Example
This command changes the settings of the snapshot named MyVolume-2010-06-10-08:00:00.1234 of MyVolume to read-write and online.
C:\PS>Set-EqlSnapshot -VolumeName MyVolume -SnapshotName MyVolume-2010-06-10-08:00:00.1234 -OnlineStatus online -AccessType read_write
Related Commands
Connect-EqlGroup cmdlet New-EqlVolume cmdlet Set-EqlVolume cmdlet Remove-EqlVolume cmdlet New-EqlVolumeACL cmdlet Get-EqlSnapshot cmdlet Remove-EqlSnapshot cmdlet
109
6 Snapshot Cmdlets
Restore-EqlSnapshot cmdlet
Restores a volume from a snapshot of the specified volume.
Caution: If you use this cmdlet to restore from a snapshot that was created through the
ASM/ME console or the ASM CLI, the restore will not be performed in an application-aware manner. Therefore, before performing the restore operation, you should perform all necessary actions (for example, taking an SQL databases offline, or putting clustered volumes in maintenance mode) using the appropriate cmdlets provided for SQL or failover clusters.
Command Syntax
Restore-EqlSnapshot [-GroupName <string>] [-GroupAddress <string>] -VolumeName <string> [-MemberIndex <uint>] [-VolumeIndex <uint>] [-UseIndex [<SwitchParameter>]] -SnapshotName <string> [<CommonParameters>]
Command Description
The Restore-EqlSnapshot cmdlet restores a volume, identified by name, from a specified snapshot of that volume. If you are connected to more than one group, you can specify the target group using either the GroupName or GroupAddress parameter. The volume must reside on a PS Series group to which a connection exists in the current PowerShell runspace. Both the volume and its snapshot will be taken offline, if they are online when the cmdlet is invoked. Both will be restored to their original online state after the restore action completes. If you want to leave either the volume or snapshot offline after the command completes, use the Set-EqlVolume or Set-EqlSnapshot cmdlet to set the online status to offline before using the Restore-EqlSnapshot cmdlet.
Inputs
None. The output of Get-EqlSnapshot for any volume can be piped through a filter to select a snapshot to pipe to Restore-EqlSnapshot from which to restore a volume.
Outputs
None. Returns a string acknowledging the successful completion of the cmdlet action.
Command Parameters
Parameter: GroupName <string>
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. Either this parameter or the GroupName parameter can be used to identify a group for this cmdlet.
Required?: false Position?: named Default value?: none
110
6 Snapshot Cmdlets
Accept pipeline input?: true Accept wildcard characters?: false Parameter: GroupAddress <string>
Specifies the IP address of a PS Series group for which a session was exists in this PowerShell runspace. This parameter can be either IPv4 or IPv6. Either this parameter or the GroupName parameter can be used to identify a Group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: VolumeName <string>
Specifies the name of a volume on a PS Series group that identifies the volume to which this cmdlet applies. This name is case-sensitive.
Required?: true Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: MemberIndex <uint>
Specifies the member index that is used with the volume index to uniquely identify a volume.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: VolumeIndex <uint>
Specifies the volume index that is used with the member index to uniquely identify a volume.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: UseIndex [<SwitchParameter>]
Specifies that the cmdlet should use the MemberIndex and VolumeIndex parameter values to identify a volume instead of the volume name. This is a faster method for getting access to the volume.
Required?: false Position?: named Default value?: false Accept pipeline input?: false
111
6 Snapshot Cmdlets
Specifies the name of the snapshot of the specified volume to which this cmdlet applies. This name is case-sensitive.
Required?: true Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false
Examples
This command restores MyVolume from the snapshot MyVolume-2010-06-30-12:00:00.1
C:\PS>Restore-EqlSnapshot -VolumeName MyVolume -SnapshotName MyVolume-2010-06-30-12:00:00.1
Related Commands
Connect-EqlGroup cmdlet Get-EqlVolume cmdlet New-EqlSnapshot cmdlet Get-EqlSnapshot cmdlet
Remove-EqlSnapshot cmdlet
Removes one or more of the snapshots of the specified volume.
Command Syntax
Remove-EqlSnapshot [-GroupName <string>] [-GroupAddress <string>] -VolumeName <string> [-MemberIndex <uint>] [-VolumeIndex <uint>] [-UseIndex [<SwitchParameter>]] [-SnapshotName <string>] [<CommonParameters>]
Command Description
The Remove-EqlSnapshot cmdlet removes the snapshot with the specified name of a volume identified by name on a PS Series group to which a connection exists in the current PowerShell runspace. If you are connected to more than one group, you can specify the target group using either the GroupName or GroupAddress parameter. If a snapshot name is not specified, all snapshots of the volume are removed. Use the Get-EqlSnapshot cmdlet to get the name for each of the snapshots of a volume.
Inputs
None.
112
6 Snapshot Cmdlets
Outputs
None. Returns a string acknowledging the successful completion of the cmdlet action.
Command Parameters
Parameter: GroupName <string>
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. Either this parameter or the GroupName parameter can be used to identify a group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: GroupAddress <string>
Specifies the IP address of a PS Series group for which a session was exists in this PowerShell runspace. This parameter can be either IPv4 or IPv6. Either this parameter or the GroupName parameter can be used to identify a Group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: VolumeName <string>
Specifies the name of a volume on a PS Series group that identifies the volume to which this cmdlet applies. This name is case-sensitive.
Required?: true Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: MemberIndex <uint>
Specifies the member index that is used with the volume index to uniquely identify a volume.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: VolumeIndex <uint>
Specifies the volume index that is used with the member index to uniquely identify a volume.
113
6 Snapshot Cmdlets
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: UseIndex [<SwitchParameter>]
Specifies that the cmdlet should use the MemberIndex and VolumeIndex parameter values to identify a volume instead of the volume name. This is a faster method for getting access to the volume.
Required?: false Position?: named Default value?: false Accept pipeline input?: false Accept wildcard characters?: false Parameter: SnapshotName <string>
Specifies the name of the snapshot of the specified volume to which this cmdlet applies. This name is case-sensitive. If this parameter is not specified, all snapshots of the volume will be deleted.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false
Examples
Example 1 This command deletes all of the snapshots of MyVolume.
C:\PS>Remove-EqlSnapshot -VolumeName MyVolume
Related Commands
Connect-EqlGroup cmdlet Get-EqlVolume cmdlet Remove-EqlVolume cmdlet New-EqlSnapshot cmdlet Get-EqlSnapshot cmdlet
114
6 Snapshot Cmdlets
New-EqlSnapshotClone cmdlet
Creates a clone of the specified snapshot of a volume on a PS Series group.
Command Syntax
New-EqlSnapshotClone [-GroupName <string>] [-GroupAddress <string>] -VolumeName <string> [-MemberIndex <uint>] [-VolumeIndex <uint>] [-UseIndex [<SwitchParameter>]] -SnapshotName <string> -CloneName <string> [<CommonParameters>]
Command Description
The New-EqlSnapshotClone cmdlet creates a clone of a snapshot identified by name of a volume identified by name on a PS Series group to which a connection exists in the current PowerShell runspace. If you are connected to more than one group, you can specify the target group using either the GroupName or GroupAddress parameter. Additional actions can be performed on the newly created clone using volume cmdlets. For example, you can use the New-EqlVolumeACL cmdlet to set ACLs on the clone.
Inputs
None. You cannot pipe objects to New-EqlSnapshotClone.
Outputs
None. Returns a string acknowledging the successful completion of the cmdlet action.
Command Parameters
Parameter: GroupName <string>
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. Either this parameter or the GroupName parameter can be used to identify a group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: GroupAddress <string>
Specifies the IP address of a PS Series group for which a session was exists in this PowerShell runspace. This parameter can be either IPv4 or IPv6. Either this parameter or the GroupName parameter can be used to identify a Group for this cmdlet.
Required?: false Position?: named
115
6 Snapshot Cmdlets
Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: VolumeName <string>
Specifies the name of a volume on a PS Series group that identifies the volume to which this cmdlet applies. This name is case-sensitive.
Required?: true Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: MemberIndex <uint>
Specifies the member index that is used with the volume index to uniquely identify a volume.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: VolumeIndex <uint>
Specifies the volume index that is used with the member index to uniquely identify a volume.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: UseIndex [<SwitchParameter>]
Specifies that the cmdlet should use the MemberIndex and VolumeIndex parameter values to identify a volume instead of the volume name. This is a faster method for getting access to the volume.
Required?: false Position?: named Default value?: false Accept pipeline input?: false Accept wildcard characters?: false Parameter: SnapshotName <string>
Specifies the name of a snapshot on a PS Series group that identifies the snapshot to which this cmdlet applies. This name is case-sensitive.
Required?: false Position?: named Default value?: Accept pipeline input?: true
116
6 Snapshot Cmdlets
Example
This command creates a clone of snapshot MyVolume-2010-01-01-00:00:00.1 named MySnapshotClone with the same settings as MyVolume.
C:\PS>New-EqlSnapshotClone -VolumeName MyVolume -SnapshotName MyVolume-2010-01-01-00:00:00.1 -CloneName MySnapshotClone
Related Commands
Connect-EqlGroup cmdlet Get-EqlVolume cmdlet Set-EqlVolume cmdlet Remove-EqlVolume cmdlet New-EqlVolumeACL cmdlet Get-EqlVolumeACL cmdlet Remove-EqlVolumeACL cmdlet Set-EqlSnapshot cmdlet Get-EqlSnapshot cmdlet Remove-EqlSnapshot cmdlet
117
7 Replication Cmdlets
New-EqlReplicationPartner cmdlet
Creates a replication partnership between two PS Series Groups.
Command Syntax
New-EqlReplicationPartner [-GroupName <string>] [-GroupAddress <string>] -PartnerName <string> -PartnerIPAddress <string> [-InboundCredential <System.Management.Automation.PSCredential>] [-InboundPassword <string>] [-PartnerDescription <string>] [-ContactName <string>] [-ContactEmailAddress <string>] [-ContactPhone <string>] [-ContactMobile <string>] [-OutboundCredential <System.Management.Automation.PSCredential>] [-OutboundPassword <string>] [-DelegatedSpaceMB <uint>] [-ReplicationStatus <string>] [-PassThru [<SwitchParameter>]] [<CommonParameters>]
Command Description
The New-EqlReplicationPartner cmdlet creates a replication partnership between a PS Series group to which a connection exists in the current PowerShell runspace and another PS Series Group. If you are connected to more than one group, you can specify the target group using either the GroupName or GroupAddress parameter. To complete the creation of the partnership, you must connect to the partner group and execute this cmdlet specifying the first group as the partner.
Inputs
None.
Outputs
If the PassThru parameter is not specified, a string acknowledging the successful completion of the cmdlet action is returned. Otherwise, an Interop.EqlPsaMgmtAPI.EQL_PARTNER_SPECobject is returned. You can pipe objects from New-EqlReplicationPartner to Set-EqlReplicationPartner. Pipe the objects through format-list to filter out parameters that you do not want to use.
119
7 Replication Cmdlets
Command Parameters
Parameter: GroupName <string>
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. Either this parameter or the GroupName parameter can be used to identify a group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: GroupAddress <string>
Specifies the IP address of a PS Series group for which a session was exists in this PowerShell runspace. This parameter can be either IPv4 or IPv6. Either this parameter or the GroupName parameter can be used to identify a Group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: PartnerName <string>
Specifies the name of the group to which replication will be performed from a PS Series group. This name is case-sensitive.
Required?: true Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: PartnerIPAddress <string>
Specifies the IP Address for the group to which replication will done. This address can be IPv4 or IPv6.
Required?: true Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: InboundCredential <System.Management.Automation.PSCredential>
Specifies a PSCredential object containing the password (16 alphanumeric characters maximum) for access by the PS Series group specified as the value for the PartnerName parameter. The InboundPassword parameter can be used instead of the InboundCredential parameter.
Required?:true, unless InboundPassword is specified.
120
7 Replication Cmdlets
Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: InboundPassword <string>
Specifies the password (16 alphanumeric characters maximum) for access by the PS Series group specified as the value for the PartnerName parameter. The InboundCredential parameter can be used instead of the InboundPassword parameter.
Required?: true, unless InboundCredential is specified. Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: PartnerDescription <string>
121
7 Replication Cmdlets
Specifies a PSCredential object containing the password (16 alphanumeric characters maximum) for access to the PS Series group specified as the value for the PartnerName parameter. The OutboundPassword parameter can be used instead of the OutboundCredentialparameter.
Required?: true, unless OutboundPassword is specified. Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: OutboundPassword <string>
Specifies the password (16 alphanumeric characters maximum) for access to the PS Series group specified as the value for the PartnerNameparameter. The OutboundCredential parameter can be used instead of the OutboundPasswordparameter.
Required?: true, unless OutboundCredential is specified. Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: DelegatedSpaceMB <uint>
Specifies the number of MB set aside on the outbound group for inbound replication from the replication site.
Required?: false Position?: named Default value?: 0 Accept pipeline input?: true Accept wildcard characters?: false Parameter: ReplicationStatus <string>
Specifies whether the replication partnership is enabled for use when it is created. Enter (e)nabled to enable replication, (d)isabled disable replication.
Required?: false Position?: named Default value?: enabled Accept pipeline input?: true Accept wildcard characters?: false Parameter: PassThru [<SwitchParameter>]
122
7 Replication Cmdlets
Specifies that the cmdlet should return an EQL_PARTNER_SPEC object for the group member on successful completion.
Required?: false Position?: named Default value?: false Accept pipeline input?: false Accept wildcard characters?: false
Example
This command, executed when connected to GroupA, will create a replication partnership with GroupB using IP address 10.100.100.10. The outbound password password2 will be used for authentication for access to GroupB. The inbound password password1 will be used for authentication for access by GroupB. 10GB of space will be delegated for storing partner replica sets. Since the PassThru parameter is specified, it will also list all of the values in the EQL_ PARTNER_SPEC object, except for passwords, for the new partnership. To complete the creation of the partnership, you must also connect to GroupB and execute this command, specifying GroupA for PartnerName, GroupA's IP Address for PartnerIPAddress, password2 for InboundPassword, and password1 for OutboundPassword.
C:\PS>New-EqlReplicationPartner -PartnerName GroupB -PartnerIPAddress 10.100.100.10 -InboundPassword password1 -OutboundPassword password2 -Delegate dSpaceMB 10000 -ReplicationStatus enabled -PassThru
Related Commands
Connect-EqlGroup cmdlet Get-EqlReplicationPartner cmdlet Set-EqlReplicationPartner cmdlet Remove-EqlReplicationPartner cmdlet
Get-EqlReplicationPartner cmdlet
Retrieves the definition of a specified replication partnership or all replication partnerships for a group.
Command Syntax
Get-EqlReplicationPartner [-GroupName <string>] [-GroupAddress <string>] [-PartnerName <string>] [<CommonParameters>]
Command Description
The Get-EqlReplicationPartner cmdlet retrieves the definition for a replication partnership between a group identified by name and a PS Series group to which a connection exists in the current PowerShell runspace. If you are connected to more than one group, you can specify the target group using either the GroupName or GroupAddress parameter. If a partner name is not
123
7 Replication Cmdlets
specified, then this cmdlet retrieves the definitions for all replication partnerships on a PS Series group to which the connection exists in the current PowerShell runspace.
Inputs
None.
Outputs
Interop.EqlPsaMgmtAPI.EQL_MEMBER_SPEC
You can pipe objects from Get-EqlReplicationPartner to other cmdlets, such as New-EqlReplicationPartner. Pipe the objects through format-list to filter out parameters that you do not want to use.
Command Parameters
Parameter: GroupName <string>
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. Either this parameter or the GroupName parameter can be used to identify a group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: GroupAddress <string>
Specifies the IP address of a PS Series group for which a session was exists in this PowerShell runspace. This parameter can be either IPv4 or IPv6. Either this parameter or the GroupName parameter can be used to identify a Group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: PartnerName <string>
Specifies the name of the group to which replication is performed from a PS Series group to identify the partnership to which this cmdlet applies. This name is case-sensitive.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false
124
7 Replication Cmdlets
Example
This command will return a PSObject containing all of the values in the EQL_PARTNER_SPEC object, except for passwords, for the partnership with GroupB.
C:\PS>Get-EqlReplicationPartner -PartnerName GroupB
Related Commands
Connect-EqlGroup cmdlet New-EqlReplicationPartner cmdlet Set-EqlReplicationPartner cmdlet Remove-EqlReplicationPartner cmdlet
Set-EqlReplicationPartner cmdlet
Changes the definition of a replication partnership between two PS Series groups.
Command Syntax
Set-EqlReplicationPartner [-GroupName <string>] [-GroupAddress <string>] -PartnerName <string> [-NewPartnerName <string>] [-PartnerIPAddress <string>] [-InboundCredential {System.Management.Automation.PSCredential}] [-InboundPassword <string>] [-PartnerDescription [<string>]] [-ContactName <string>] [-ContactEmailAddress <string>] [-ContactPhone <string>] [-ContactMobile <string>] [-OutboundCredential <System.Management.Automation.PSCredential>] [-OutboundPassword <string>] [-DelegatedSpaceMB <uint>] [-ReplicationStatus <string>] [-PassThru [<SwitchParameter>]] [<CommonParameters>]
Command Description
The Set-EqlReplicationPartner cmdlet changes a replication partnership between a PS Series group to which a connection exists in the current PowerShell runspace and another PS Series group. If you are connected to more than one group, you can specify the target group using either the GroupName or GroupAddress parameter.
Inputs
None.
Outputs
If the PassThru parameter is not specified, a string acknowledging the successful completion of the cmdlet action is returned.
125
7 Replication Cmdlets
Otherwise, an Interop.EqlPsaMgmtAPI.EQL_PARTNER_SPECobject is returned. You can pipe objects from Get-EqlReplicationPartner to Set-EqlReplicationPartner to copy settings from one replication partner to another. Pipe the objects through format-list to filter out parameters that you do not want to use.
Command Parameters
Parameter: GroupName <string>
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. Either this parameter or the GroupName parameter can be used to identify a group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: GroupAddress <string>
Specifies the IP address of a PS Series group for which a session was exists in this PowerShell runspace. This parameter can be either IPv4 or IPv6. Either this parameter or the GroupName parameter can be used to identify a Group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: PartnerName <string>
Specifies the name of the group to which replication will be performed from a PS Series group to identify the partnership to which this cmdlet applies. This name is case-sensitive.
Required?: true Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: NewPartnerName <string>
Specifies a new name for the group to which replication will be performed from a PS Series group. This name is case-sensitive. This parameter should only be used if the replication partner's group name has changed.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false
126
7 Replication Cmdlets
Changes the IP Address used to connect to the group to which replication will done. This address can be IPv4 or IPv6.
Required?:false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: InboundCredential <System.Management.Automation.PSCredential>
Changes the password using a PSCredential object containing the new password (16 alphanumeric characters maximum) for access by the PS Series group specified as the value for the PartnerName parameter. The InboundPassword parameter can be used instead of the InboundCredentialparameter.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: InboundPassword <string>
Changes the password (16 alphanumeric characters maximum) for access by the PS Series group specified as the value for the PartnerNameparameter. The InboundCredential parameter can be used instead of the InboundPassword parameter.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: PartnerDescription <string>
Changes the description for the replication partnership. If the description contains spaces, surround it with quotation marks.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: ContactName <string>
127
7 Replication Cmdlets
Changes the email address for the contact at the replication site.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: ContactPhone <string>
Changes the phone number for the contact at the replication site.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: ContactMobile <string>
Changes the mobile phone number for the contact at the replication site.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: OutboundCredential <System.Management.Automation.PSCredential>
Changes the password using a PSCredential object containing the new password (16 alphanumeric characters maximum) for access to the PS Series group specified as the value for the PartnerName parameter. The OutboundPassword parameter can be used instead of the OutboundCredential parameter.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: OutboundPassword <string>
Changes the password (16 alphanumeric characters maximum) for access to the PS Series group specified as the value for the PartnerNameparameter. The OutboundCredential parameter can be used instead of the OutboundPassword parameter.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: DelegatedSpaceMB <uint>
128
7 Replication Cmdlets
Changes the number of MB set aside on the outbound group for inbound replication from the replication site.
Required?: false Position?: named Default value?: 0 Accept pipeline input?: true Accept wildcard characters?: false Parameter: ReplicationStatus <string>
Changes whether the replication partnership is enabled for use when it is created. Enter (e)nabled to enable replication, (d)isabled disable replication.
Required?: false Position?: named Default value?: enabled Accept pipeline input?: true Accept wildcard characters?: false Parameter: PassThru [<SwitchParameter>]
Specifies that the cmdlet should return an EQL_PARTNER_SPEC object for the replication partnership on successful completion.
Required?: false Position?: named Default value?: false Accept pipeline input?: false Accept wildcard characters?: false
Example
This command will change the replication partnership between GroupB and the group to which a connection exists in the current PowerShell runspace. The inbound password used for authentication for access by GroupB will be changed to password3. The space delegated for storing partner replica sets will be increased to 20GB. Since the PassThru parameter is specified, it will also list all of the values (except for passwords)in the EQL_PARTNER_SPEC object for the partnership with the new values for changes made. For values that apply to both sides of the partnership, execute the Set-EqlReplicationPartner cmdlet on the partner group to keep them synchronized.
C:\PS>Set-EqlReplicationPartner -PartnerName GroupB -InboundPassword password3 -DelegatedSpaceMB 20000 -PassThru
Related Commands
Connect-EqlGroup cmdlet New-EqlReplicationPartner cmdlet Get-EqlReplicationPartner cmdlet Remove-EqlReplicationPartner cmdlet
129
7 Replication Cmdlets
Remove-EqlReplicationPartner cmdlet
Breaks the relationship between a PS Series group and its replication partner.
Command Syntax
Remove-EqlReplicationPartner [-GroupName <string>] [-GroupAddress <string>] -PartnerName <string> [-Force [<SwitchParameter>]] [<CommonParameters>]
Command Description
The Remove-EqlReplicationPartner cmdlet deletes a replication partnership between a PS Series group to which a connection exists in the current PowerShell runspace and another specified PS Series group. If you are connected to more than one group, you can specify the target group using either the GroupName or GroupAddress parameter. This cmdlet will display a prompt to the console to confirm the deletion. The -Force parameter can be used to suppress this prompt for scripts.
Inputs
None.
Outputs
Returns a string acknowledging the successful completion of the cmdlet action.
Command Parameters
Parameter: GroupName <string>
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. Either this parameter or the GroupName parameter can be used to identify a group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: GroupAddress <string>
Specifies the IP address of a PS Series group for which a session was exists in this PowerShell runspace. This parameter can be either IPv4 or IPv6. Either this parameter or the GroupName parameter can be used to identify a Group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true
130
7 Replication Cmdlets
Specifies the name of the group with which a replication partnership exists to identify the partnership to which this cmdlet applies. This name is case-sensitive.
Required?: true Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: Force [<SwitchParameter>]
Specifies that the cmdlet should bypass the confirmation prompt and delete the partnership.
Required?: false Position?: named Default value?: false Accept pipeline input?: false Accept wildcard characters?: false
Example
Example 1 This command will prompt for confirmation and delete the replication partnership between GroupB and the group to which a connection exists in the current PowerShell runspace.
C:\PS>Remove-EqlReplicationPartner -PartnerName GroupB
Example 2 This command will delete the replication partnership between GroupB and the group to which a connection exists in the current PowerShell runspace without prompting for confirmation.
C:\PS>Remove-EqlReplicationPartner -PartnerName GroupB -Force
Related Commands
Connect-EqlGroup cmdlet New-EqlReplicationPartner cmdlet Get-EqlReplicationPartner cmdlet Set-EqlReplicationPartner cmdlet
New-EqlReplicaSet cmdlet
Configures replication of a volume to a replication site.
131
7 Replication Cmdlets
Command Syntax
New-EqlReplicaSet [-GroupName <string>] [-GroupAddress <string>] -VolumeName <string> -ReplicationSite <string> [-PartnerReservePercent <uint>] [-LocalReservePercent <uint>] [-BorrowLocalFreeSpace <string>] [-KeepLocalFailback <string>] [-CreateReplica [<SwitchParameter>]] [-PassThru [<SwitchParameter>]] [<CommonParameters>]
Command Description
The New-EqlReplicaSet cmdlet configures replication of a volume on a PS Series group to which a connection exists in the current PowerShell runspace to a specified replication site. If you are connected to more than one group, you can specify the target group using either the GroupName or GroupAddress parameter. The volume and replication site are specified by name. Use the New-EqlReplicationPartner cmdlet to configure the partnership with the replication site before using this cmdlet.
Inputs
None.
Outputs
Returns a string acknowledging the successful completion of the cmdlet action , or an Interop.EqlPsaMgmtAPI.EQL_REPLICA_SET_SPEC object if the PassThru parameter is present.
Command Parameters
Parameter: GroupName <string>
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. Either this parameter or the GroupName parameter can be used to identify a group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: GroupAddress <string>
Specifies the IP address of a PS Series group for which a session was exists in this PowerShell runspace. This parameter can be either IPv4 or IPv6. Either this parameter or the GroupName parameter can be used to identify a Group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true
132
7 Replication Cmdlets
Specifies the name of a volume on a PS Series group that identifies the volume to which this cmdlet applies. This name is case-sensitive.
Required?: true Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: ReplicationSite <string>
Specifies the name of a PS Group that identifies the replication partner to which this cmdlet applies. This name is case-sensitive.
Required?: true Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: PartnerReservePercent <uint>
Specifies the portion of delegated space allocated for storing the replica set specified as a percent of the replica volume reserve. The minimum value is 105 percent.
Required?:false Position?: named Default value?: 200 Accept pipeline input?: true Accept wildcard characters?: false Parameter: LocalReservePercent <uint>
Specifies the local replication reserve, which is used during replication and optionally for storing the failback snapshot. It is specified as a percent of the volume reserve. The minimum value is 5 percent.
Required?: false Position?: named Default value?: 100 Accept pipeline input?: true Accept wildcard characters?: false Parameter: BorrowLocalFreeSpace <string>
Specifies whether to temporarily use free pool space if the local reserve space is insufficient. Enter (e)nabled to allow the temporary use of local free space, enter (d)isabled to prevent it.
Required?: false Position?: named Default value?: enabled Accept pipeline input?: true
133
7 Replication Cmdlets
Specifies whether a failback snapshot is kept in the local replication reserve. Enter (e)nabled to keep a failback snapshot, enter (d)isabled to not keep a local failback snapshot.
Required?: false Position?: named Default value?: disabled Accept pipeline input?: true Accept wildcard characters?: false Parameter: CreateReplica [<SwitchParameter>]
Specifies that the cmdlet should launch creation of the initial replica after the replica set is configured.
Required?: false Position?: named Default value?: false Accept pipeline input?: false Accept wildcard characters?: false Parameter: PassThru [<SwitchParameter>]
Specifies that the cmdlet should return an EQL_REPLICA_SET_SPEC object for the new replica set on successful completion.
Required?: false Position?: named Default value?: false Accept pipeline input?: false Accept wildcard characters?: false
Examples
Example 1 This command configures replication of MyVolume to PSGroupB, enables the option to keep a local failback snapshot, and sets the local reserve space to 100 percent of volume reserve.
C:\PS>New-EqlReplicaSet -VolumeName MyVolume -ReplicationSite PSGroupB -KeepLocalFailback enabled -LocalReservePercent 100
Example 2 This command configures replication of MyVolume to PSGroupB and launches creation of the initial replica.
C:\PS>New-EqlReplicaSet -VolumeName MyVolume -ReplicationSite PSGroupB -CreateReplica
134
7 Replication Cmdlets
Related Commands
Connect-EqlGroup cmdlet New-EqlReplica cmdlet Set-EqlReplicaSet cmdlet Get-EqlReplicaSet cmdlet Remove-EqlReplicaSet cmdlet Suspend-EqlReplication cmdlet Resume-EqlReplication cmdlet ConvertTo-EqlPromotedReplicaSet cmdlet ConvertTo-EqlDemotedReplicaSet cmdlet
Get-EqlReplicaSet cmdlet
Retrieves information for a replica set for a volume on the specified replication site.
Command Syntax
Get-EqlReplicaSet [-GroupName <string>] [-GroupAddress <string>] [-VolumeName <string>] [-ReplicationSite <string>] [<CommonParameters>]
Command Description
The Get-EqlReplicaSet cmdlet retrieves information for a replica set identified by volume name and replication partner name on a PS Series group to which a connection exists. If you are connected to more than one group, you can specify the target group using either the GroupName or GroupAddress parameter. If volume name and replication partner name are not specified, information for all replica sets configured on the group will be returned.
Inputs
None.
Outputs
Returns a collection of PSObjects for an Interop.EqlPsaMgmtAPI.EQL_REPLICA_SET_SPEC. The output of the Get-EqlReplicaSet cmdlet can be piped to other cmdlets, such as Set-EqlReplicaSet.
Command Parameters
Parameter: GroupName <string>
135
7 Replication Cmdlets
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. Either this parameter or the GroupName parameter can be used to identify a group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: GroupAddress <string>
Specifies the IP address of a PS Series group for which a session was exists in this PowerShell runspace. This parameter can be either IPv4 or IPv6. Either this parameter or the GroupName parameter can be used to identify a Group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: VolumeName <string>
Specifies the name of a volume on a PS Series group that identifies the volume to which this cmdlet applies. This name is case-sensitive.
Required?: false, unless PartnerName is specified. Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: ReplicationSite <string>
Specifies the name of a PS Series group that identifies the replication partner to which this cmdlet applies. This name is case-sensitive.
Required?: false, unless VolumeName is specified. Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false
Examples
Example 1 This command retrieves the configuration of all of the replica sets on this group.
C:\PS>Get-EqlReplicaSet
136
7 Replication Cmdlets
Example 2 This command retrieves the configuration of the replica set of MyVolume from PSGroupB.
C:\PS>Get-EqlReplicaSet -VolumeName MyVolume -ReplicationSite PSGroupB
Related Commands
Connect-EqlGroup cmdlet New-EqlReplica cmdlet New-EqlReplicaSet cmdlet Set-EqlReplicaSet cmdlet Remove-EqlReplicaSet cmdlet Suspend-EqlReplication cmdlet Resume-EqlReplication cmdlet ConvertTo-EqlPromotedReplicaSet cmdlet ConvertTo-EqlDemotedReplicaSet cmdlet
Set-EqlReplicaSet cmdlet
Changes settings for a replica set of a volume on the specified replication site.
Command Syntax
Set-EqlReplicaSet [-GroupName <string>] [-GroupAddress <string>] -VolumeName <string> -ReplicationSite <string> [-PartnerReservePercent <uint>] [-LocalReservePercent <uint>] [-BorrowLocalFreeSpace <string>] [-KeepLocalFailback <string>] [-PassThru [<SwitchParameter>]] [<CommonParameters>]
Command Description
The Set-EqlReplicaSet cmdlet changes settings for a replica set identified by volume name and replication site on a PS Series group to which a connection exists in the current PowerShell runspace. If you are connected to more than one group, you can specify the target group using either the GroupName or GroupAddress parameter.
Inputs
None.
137
7 Replication Cmdlets
Outputs
Returns a string acknowledging the successful completion of the cmdlet action, or an Interop.EqlPsaMgmtAPI.EQL_REPLICA_SET_SPEC object if the PassThru parameter is present.
Command Parameters
Parameter: GroupName <string>
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. Either this parameter or the GroupName parameter can be used to identify a group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: GroupAddress <string>
Specifies the IP address of a PS Series group for which a session was exists in this PowerShell runspace. This parameter can be either IPv4 or IPv6. Either this parameter or the GroupName parameter can be used to identify a Group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: VolumeName <string>
Specifies the name of a volume on a PS Series group that identifies the volume to which this cmdlet applies. This name is case-sensitive.
Required?: true Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: ReplicationSite <string>
Specifies the name of a PS Series group that identifies the replication site to which this cmdlet applies. This name is case-sensitive.
Required?: true Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: PartnerReservePercent <uint>
138
7 Replication Cmdlets
Changes the portion of delegated space allocated for storing the replica set specified as a percent of the replica volume reserve. The minimum value is 105 percent.
Required?:false Position?: named Default value?: 200 Accept pipeline input?: true Accept wildcard characters?: false Parameter: LocalReservePercent <uint>
Changes the local replication reserve which is used during replication and optionally for storing the failback snapshot. It is specified as a percent of the volume reserve. The minimum value is 5 percent.
Required?:false Position?: named Default value?: 100 Accept pipeline input?: true Accept wildcard characters?: false Parameter: BorrowLocalFreeSpace <string>
Changes whether to temporarily use free pool space if the local reserve space is insufficient. Enter (e)nabled to allow the temporary use of local free space, or enter (d)isabled to prevent it.
Required?:false Position?: named Default value?: enabled Accept pipeline input?: true Accept wildcard characters?: false Parameter: KeepLocalFailback <string>
Changes whether a failback snapshot is kept in the local replication reserve. Enter (e)nabled to keep a failback snapshot, or enter (d)isabled if you do not want to keep a local failback snapshot.
Required?:false Position?: named Default value?: disabled Accept pipeline input?: true Accept wildcard characters?: false Parameter: PassThru [<SwitchParameter>]
Specifies that the cmdlet should return an EQL_REPLICA_SET_SPEC object for the changed replica set on successful completion.
Required?:false Position?: named Default value?: false Accept pipeline input?: false Accept wildcard characters?: false
139
7 Replication Cmdlets
Example
This command enables the option to keep a local failback snapshot and changes the local reserve space to 100 percent of volume reserve when replicating MyVolume to PSGroupB.
C:\PS>Set-EqlReplicaSet -VolumeName MyVolume -ReplicationSite PSGroupB -KeepLocalFailback enabled -LocalReservePercent 100
Related Commands
Connect-EqlGroup cmdlet New-EqlReplica cmdlet New-EqlReplicaSet cmdlet Get-EqlReplicaSet cmdlet Suspend-EqlReplication cmdlet Resume-EqlReplication cmdlet ConvertTo-EqlPromotedReplicaSet cmdlet ConvertTo-EqlDemotedReplicaSet cmdlet
Remove-EqlReplicaSet cmdlet
Deletes the replica set for a volume on the specified replication site.
Command Syntax
Remove-EqlReplicaSet [-GroupName <string>] [-GroupAddress <string>] -VolumeName <string> -ReplicationSite <string> [-Force] [<CommonParameters>]
Command Description
The Remove-EqlReplicaSet cmdlet deletes a replica set on a PS Series group to which a connection exists that was created for the volume identified by name on the specified replication site. If you are connected to more than one group, you can specify the target group using either the GroupName or GroupAddress parameter. Replication of the volume to the replication site is disabled by the deletion of the replica set.
Inputs
None.
Outputs
None. Returns a string acknowledging the successful completion of the cmdlet action.
140
7 Replication Cmdlets
Command Parameters
Parameter: GroupName <string>
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. Either this parameter or the GroupName parameter can be used to identify a group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: GroupAddress <string>
Specifies the IP address of a PS Series group for which a session was exists in this PowerShell runspace. This parameter can be either IPv4 or IPv6. Either this parameter or the GroupName parameter can be used to identify a Group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: VolumeName <string>
Specifies the name of a volume on a PS Series group that identifies the volume to which this cmdlet applies. This name is case-sensitive.
Required?: true Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: ReplicationSite <string>
Specifies the name of a PS Series group that identifies the replication site to which this cmdlet applies. This name is case-sensitive.
Required?: true Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: Force [<SwitchParameter>]
Specifies that the cmdlet should bypass the confirmation prompt and delete the replica set.
Required?: false Position?: named Default value?: false
141
7 Replication Cmdlets
Example
This command displays a prompt requesting confirmation, and if the user confirms the action, it removes the replica set of MyVolume from PSGroupB.
C:\PS>Remove-EqlReplicaSet -VolumeName MyVolume -ReplicationSite PSGroupB
Related Commands
Connect-EqlGroup cmdlet New-EqlReplica cmdlet Suspend-EqlReplication cmdlet Resume-EqlReplication cmdlet ConvertTo-EqlPromotedReplicaSet cmdlet ConvertTo-EqlDemotedReplicaSet cmdlet
Suspend-EqlReplication cmdlet
Suspends replication of a volume to the specified replication partner. Use Resume-EqlReplication to resume replication of the suspended replica set.
Command Syntax
Suspend-EqlReplication [-GroupName <string>] [-GroupAddress <string>] -VolumeName <string> -ReplicationSite <string> [<CommonParameters>]
Command Description
The Suspend-EqlReplication cmdlet suspends replication of a volume identified by name from a PS Series group to which a connection exists in the current PowerShell runspace to the specified replication site. If you are connected to more than one group, you can specify the target group using either the GroupName or GroupAddress parameter.
Inputs
None.
142
7 Replication Cmdlets
Outputs
None. Returns a string acknowledging the successful completion of the cmdlet action.
Command Parameters
Parameter: GroupName <string>
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. Either this parameter or the GroupName parameter can be used to identify a group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: GroupAddress <string>
Specifies the IP address of a PS Series group for which a session was exists in this PowerShell runspace. This parameter can be either IPv4 or IPv6. Either this parameter or the GroupName parameter can be used to identify a Group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: VolumeName <string>
Specifies the name of a volume on a PS Series group that identifies the volume to which this cmdlet applies. This name is case-sensitive.
Required?: true Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: ReplicationSite <string>
Specifies the name of a PS Series group that identifies the replication partner to which this cmdlet applies. This name is case-sensitive.
Required?: true Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false
Example
This command suspends replication of MyVolume to PSGroupB.
143
7 Replication Cmdlets
Related Commands
Connect-EqlGroup cmdlet Get-EqlVolume cmdlet Remove-EqlVolume cmdlet Resume-EqlReplication cmdlet New-EqlReplica cmdlet ConvertTo-EqlPromotedReplicaSet cmdlet ConvertTo-EqlDemotedReplicaSet cmdlet Remove-EqlReplicaSet cmdlet
Resume-EqlReplication cmdlet
Resumes replication of a volume to the specified replication site.
Command Syntax
Resume-EqlReplication [-GroupName <string>] [-GroupAddress <string>] -VolumeName <string> -ReplicationSite <string> [<CommonParameters>]
Command Description
The Resume-EqlReplication cmdlet resumes replication of a volume identified by name from a PS Series group to which a connection exists in the current PowerShell runspace to the specified Replication Site. If you are connected to more than one group, you can specify the target group using either the GroupName or GroupAddress parameter.
Inputs
None.
Outputs
None. Returns a string acknowledging the successful completion of the cmdlet action.
Command Parameters
Parameter: GroupName <string>
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. Either this parameter or the GroupName parameter can be used to identify a group for this cmdlet.
144
7 Replication Cmdlets
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: GroupAddress <string>
Specifies the IP address of a PS Series group for which a session was exists in this PowerShell runspace. This parameter can be either IPv4 or IPv6. Either this parameter or the GroupName parameter can be used to identify a Group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: VolumeName <string>
Specifies the name of a volume on a PS Series group that identifies the volume to which this cmdlet applies. This name is case-sensitive.
Required?: true Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: ReplicationSite <string>
Specifies the name of a PS Series group that identifies the replication partner to which this cmdlet applies. This name is case-sensitive.
Required?: true Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false
Example
This command resumes replication of MyVolume to PSGroupB.
C:\PS>Resume-EqlReplication -VolumeName MyVolume -ReplicationSite PSGroupB
Related Commands
Connect-EqlGroup cmdlet Get-EqlVolume cmdlet Remove-EqlVolume cmdlet Suspend-EqlReplication cmdlet New-EqlReplica cmdlet
145
7 Replication Cmdlets
ConvertTo-EqlPromotedReplicaSet cmdlet
Promotes a replica set to a volume.
Command Syntax
ConvertTo-EqlPromotedReplicaSet [-GroupName <string>] [-GroupAddress <string>] -ReplicaSetName <string> -SourceSite <string> [<CommonParameters>]
Command Description
The ConvertTo-EqlPromotedReplicaSet cmdlet promotes a replica set on a PS Series group to which a connection exists in the current PowerShell runspace to a volume. If you are connected to more than one group, you can specify the target group using either the GroupName or GroupAddress parameter. The group to which the connection exists must be the group to which the original volume is replicated. The source site parameter is the name of the PS Series group where the original volume is located.
Inputs
None.
Outputs
None. Returns a string acknowledging the successful completion of the cmdlet action.
Command Parameters
Parameter: GroupName <string>
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. Either this parameter or the GroupName parameter can be used to identify a group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: GroupAddress <string>
Specifies the IP address of a PS Series group for which a session was exists in this PowerShell runspace. This parameter can be either IPv4 or IPv6. Either this parameter or the GroupName parameter can be used to identify a Group for this cmdlet.
146
7 Replication Cmdlets
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: ReplicaSetName <string>
Specifies the name of a replica set on the PS Series group to which a connection exists in this PowerShell runspace that identifies the replica set to which this cmdlet applies. This name is case-sensitive.
Required?: true Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: SourceSite <string>
Specifies the name of a PS Series group that identifies the replication partner to which this cmdlet applies. This name is case-sensitive.
Required?: true Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false
Example
This command promotes a replica set created from MyVolume on PSGroupB to a volume when invoked on the replication partner of PSGroupB.
C:\PS>ConvertTo-EqlPromotedReplicaSet -VolumeName MyVolume -FromSite PSGroupB
Related Commands
Connect-EqlGroup cmdlet New-EqlReplica cmdlet Suspend-EqlReplication cmdlet Resume-EqlReplication cmdlet ConvertTo-EqlDemotedReplicaSet cmdlet Remove-EqlReplicaSet cmdlet
ConvertTo-EqlDemotedReplicaSet cmdlet
Demotes a promoted replica set to a normal replica set.
147
7 Replication Cmdlets
Command Syntax
ConvertTo-EqlDemotedReplicaSet [-GroupName <string>] [-GroupAddress <string>] -VolumeName <string> [<CommonParameters>]
Command Description
The ConvertTo-EqlDemotedReplicaSet cmdlet demotes a promoted replica set for a volume to a normal replica set. If you are connected to more than one group, you can specify the target group using either the GroupName or GroupAddress parameter. The converted volume is identified by name, and should reside on a PS Series group to which a connection exists in the current PowerShell runspace.
Inputs
None.
Outputs
None. Returns a string acknowledging the successful completion of the cmdlet action.
Command Parameters
Parameter: GroupName <string>
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. Either this parameter or the GroupName parameter can be used to identify a group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: GroupAddress <string>
Specifies the IP address of a PS Series group for which a session was exists in this PowerShell runspace. This parameter can be either IPv4 or IPv6. Either this parameter or the GroupName parameter can be used to identify a Group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: VolumeName <string>
Specifies the name of a volume on a PS Series group that identifies the volume to which this cmdlet applies. This name is case-sensitive and is for a volume that is a promoted replica set.
148
7 Replication Cmdlets
Required?: true Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false
Example
This command demotes a promoted replica set named MyVolume to a normal replica set. MyVolume must reside on a PS Series group to which a connection exists in the current PowerShell runspace.
C:\PS>ConvertTo-EqlDemotedReplicaSet -VolumeName MyVolume
Related Commands
Connect-EqlGroup cmdlet New-EqlReplica cmdlet Suspend-EqlReplication cmdlet Resume-EqlReplication cmdlet ConvertTo-EqlPromotedReplicaSet cmdlet Remove-EqlReplicaSet cmdlet
149
8 Schedule Cmdlets
These cmdlets are used for managing schedules for creating snapshots and replicas of volumes.
New-EqlSchedule cmdlet
Creates a schedule for taking snapshots or replicas of the specified volume.
Command Syntax
New-EqlSchedule [-GroupName <string>] [-GroupAddress <string>] -VolumeName <string> [-MemberIndex <uint>] [-VolumeIndex <uint>] [-UseIndex [<SwitchParameter>]] -ScheduleName <string> [-ScheduleType <string>] [-ReplicationSite <string>] [-StartDate {DateTime}] [-StartTime {DateTime}] [-EndDate {DateTime}] [-EndTime {DateTime}] [-OnlineStatus <string>] [-AccessType <string>] [-ScheduleStatus <string>] [-KeepCount <string>] [-TimeFrequency <string>] [-PassThru [<SwitchParameter>]] [<CommonParameters>]
Command Description
The New-EqlSchedule cmdlet creates a schedule for taking snapshots or replicas of a volume. The volume is identified by name, and must reside on a PS Series group to which a connection exists in the current PowerShell runspace. If you are connected to more than one group, you can specify the target group using either the GroupName or GroupAddress parameter. If a replication site is specified, the schedule creates replicas. Otherwise, it creates snapshots. Use the Set-EqlSchedule cmdlet to change or set any of the optional parameters that were not set at creation time.
Inputs
Interop.EqlPsaMgmtAPI.EQL_SCHEDULE_SPEC
The output of Get-EqlSchedule for any volume can be piped to New-EqlSchedule to copy the schedule parameters from one volume to another.
Outputs
Returns a string acknowledging the successful completion of the cmdlet action, or an Interop.EqlPsaMgmtAPI.EQL_SCHEDULE_SPEC object if the PassThru parameter is present.
Command Parameters
Parameter: GroupName <string>
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. Either this parameter or the GroupName parameter can be used to identify a group for this cmdlet.
151
8 Schedule Cmdlets
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: GroupAddress <string>
Specifies the IP address of a PS Series group for which a session was exists in this PowerShell runspace. This parameter can be either IPv4 or IPv6. Either this parameter or the GroupName parameter can be used to identify a Group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: VolumeName <string>
Specifies the name of a volume on a PS Series group that identifies the volume to which this cmdlet applies. This name is case-sensitive.
Required?: true Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: MemberIndex <uint>
Specifies the member index that is used with the volume index to uniquely identify a volume.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: VolumeIndex <uint>
Specifies the volume index that is used with the member index to uniquely identify a volume.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: UseIndex [<SwitchParameter>]
Specifies that the cmdlet should use the MemberIndex and VolumeIndex parameter values to identify a volume instead of the volume name. This is a faster method for getting access to the volume.
Required?: false
152
8 Schedule Cmdlets
Position?: named Default value?: false Accept pipeline input?: false Accept wildcard characters?: false Parameter: ScheduleName <string>
Specifies the name to use when referring to the schedule. This name must be unique for the volume and is case-sensitive.
Required?: true Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: ScheduleType <string>
Specifies the type of schedule to create. Enter (o)nce to create a schedule that runs once, (h)ourly or (d)aily to create a recurring schedule.
Required?: false Position?: named Default value?: once Accept pipeline input?: true Accept wildcard characters?: false Parameter: ReplicationSite <string>
Specifies the name of the replication partner for the schedule to use to create replicas for the named volume. If a replication partner is not specified, then the schedule creates snapshots. The replication partnership must be configured on this group and the volume must be configured for replication to that partner. Otherwise, this cmdlet will fail.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: StartDate {DateTime}
Specifies the time of day that the schedule will start running.
Required?: false Position?: named
153
8 Schedule Cmdlets
Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: EndDate {DateTime}
Specifies the time of day that the schedule will stop running.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: OnlineStatus <string>
Specifies whether the snapshot that is created by the schedule will be online or offline.
Required?: false Position?: named Default value?: offline Accept pipeline input?: true Accept wildcard characters?: false Parameter: AccessType <string>
Specifies whether the snapshot that is created by the schedule will be read-only or read-write.
Required?: false Position?: named Default value?: read_write Accept pipeline input?: true Accept wildcard characters?: false Parameter: ScheduleStatus <string>
Specifies whether the schedule is created in an enabled or disabled state. Enter (e)nabled to create an enabled schedule or (d)isabled to create a disabled schedule.
Required?: false Position?: named Default value?: enabled Accept pipeline input?: true Accept wildcard characters?: false Parameter: KeepCount <string>
154
8 Schedule Cmdlets
Specifies the maximum number of snapshots or replicas created by this schedule that should be kept on the PS Group before the deletion policy is applied.
Required?: false Position?: named Default value?: 10 Accept pipeline input?: true Accept wildcard characters?: false Parameter: TimeFrequency <string>
Specifies the number of minutes between runs in the time interval during which the schedule is configured to run. For example, enter 60 to run the schedule every hour.
Required?: false Position?: named Default value?: 5 Accept pipeline input?: true Accept wildcard characters?: false Parameter: PassThru [<SwitchParameter>]
Specifies that the cmdlet should return an EQL_SCHEDULE_SPEC object for the new schedule on successful completion.
Required?: false Position?: named Default value?: false Accept pipeline input?: false Accept wildcard characters?: false
Examples
Example 1 This command creates a schedule for creating read-write, offline snapshots of MyVolume every day starting on 6/1/2020 every 15 minutes between 6 PM and 11 PM.
C:\PS>New-EqlSchedule -VolumeName MyVolume -ScheduleName MySchedule -ScheduleType daily -StartDate 6/1/2010 -StartTime 6:00PM -EndTime 11:00PM -TimeFrequency 15 -AccessType read_write -OnlineStatus offline
Example 2 This command creates a schedule for creating read-only, offline replicas of MyVolume on PSGroup2 every day starting on 6/1/2020 between 6 PM and 11 PM. This schedule will not run until it is enabled.
C:\PS>New-EqlSchedule -VolumeName MyVolume -ScheduleName MyReplicaSchedule -ScheduleType hourly -ReplicationSite PSGroup2 -StartDate 6/1/2010 -StartTime 6:00P M -EndTime 11:00PM -AccessType read_only -OnlineStatus offline -ScheduleStatus disabled
155
8 Schedule Cmdlets
Related Commands
Connect-EqlGroup cmdlet New-EqlVolume cmdlet Set-EqlVolume cmdlet Remove-EqlVolume cmdlet Set-EqlSchedule cmdlet Get-EqlSchedule cmdlet Remove-EqlSchedule cmdlet
Get-EqlSchedule cmdlet
Retrieves information for one or more schedules for the specified volume.
Command Syntax
Get-EqlSchedule [-GroupName <string>] [-GroupAddress <string>] -VolumeName <string> [-MemberIndex <uint>] [-VolumeIndex <uint>] [-UseIndex [<SwitchParameter>]] [-ScheduleName <string>] [<CommonParameters>]
Command Description
The Get-EqlSchedule cmdlet retrieves the specified schedule for a volume identified by name on a PS Series group to which a connection exists in the current PowerShell runspace. If you are connected to more than one group, you can specify the target group using either the GroupName or GroupAddress parameter. If a schedule name is not specified, the information for all schedules for the specified volume is retrieved. The information retrieved by this command can be piped into the New-EqlSchedule command to copy the schedule parameters from one volume to another.
Inputs
None.
Outputs
Interop.EqlPsaMgmtAPI.EQL_SCHEDULE_SPEC
You can pipe objects from Get-EqlSchedule to other cmdlets, such as New-EqlSchedule or Remove-EqlSchedule. Pipe the objects through format-list to filter out parameters that you do not want to set.
156
8 Schedule Cmdlets
Command Parameters
Parameter: GroupName <string>
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. Either this parameter or the GroupName parameter can be used to identify a group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: GroupAddress <string>
Specifies the IP address of a PS Series group for which a session was exists in this PowerShell runspace. This parameter can be either IPv4 or IPv6. Either this parameter or the GroupName parameter can be used to identify a Group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: VolumeName <string>
Specifies the name of a volume on a PS Series group that identifies the volume to which this cmdlet applies. This name is case-sensitive.
Required?: true Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: MemberIndex <uint>
Specifies the member index that is used with the volume index to uniquely identify a volume.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: VolumeIndex <uint>
Specifies the volume index that is used with the member index to uniquely identify a volume.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false
157
8 Schedule Cmdlets
Specifies that the cmdlet should use the MemberIndex and VolumeIndex parameter values to identify a volume instead of the volume name. This is a faster method for getting access to the volume.
Required?: false Position?: named Default value?: false Accept pipeline input?: false Accept wildcard characters?: false Parameter: ScheduleName <string>
Specifies the name of the schedule of the specified volume to which this cmdlet applies. This name is case-sensitive.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false
Examples
Example 1 This command gets information for all schedules for MyVolume.
C:\PS>Get-EqlSchedule -VolumeName MyVolume
Related Commands
Connect-EqlGroup cmdlet Get-EqlVolume cmdlet Remove-EqlVolume cmdlet New-EqlSchedule cmdlet Set-EqlSchedule cmdlet
Set-EqlSchedule cmdlet
Changes the schedule of the specified volume.
158
8 Schedule Cmdlets
Command Syntax
Set-EqlSchedule [-GroupName <string>] [-GroupAddress <string>] -VolumeName <string> [-MemberIndex <uint>] [-VolumeIndex <uint>] [-UseIndex [<SwitchParameter>]] -ScheduleName <string> [-NewScheduleName <string>] [-ScheduleType <string>] [-ReplicationSite [<string>]] [-StartDate] [-StartTime {DateTime}] [-EndDate {DateTime}] [-EndTime {DateTime}] [-OnlineStatus <string>] [-AccessType <string>] [-ScheduleStatus <string>] [-KeepCount <string>] [-TimeFrequency <string>] [-PassThru [<SwitchParameter>]] [<CommonParameters>]
Command Description
The Set-EqlSchedule cmdlet changes settings for a schedule of a volume identified by name on a PS Series group to which a connection exists in the current PowerShell runspace. If you are connected to more than one group, you can specify the target group using either the GroupName or GroupAddress parameter.
Inputs
Interop.EqlPsaMgmtAPI.EQL_SCHEDULE_SPEC
The output of Get-EqlSchedule for any volume can be piped to Set-EqlSchedule to copy the schedule parameters from one volume to another.
Outputs
Returns a string acknowledging the successful completion of the cmdlet action, or an Interop.EqlPsaMgmtAPI.EQL_SCHEDULE_SPEC object if the PassThru parameter is present.
Command Parameters
Parameter: GroupName <string>
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. Either this parameter or the GroupName parameter can be used to identify a group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: GroupAddress <string>
Specifies the IP address of a PS Series group for which a session was exists in this PowerShell runspace. This parameter can be either IPv4 or IPv6. Either this parameter or the GroupName parameter can be used to identify a Group for this cmdlet.
Required?: false
159
8 Schedule Cmdlets
Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: VolumeName <string>
Specifies the name of a volume on a PS Series group that identifies the volume to which this cmdlet applies. This name is case-sensitive.
Required?: true Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: MemberIndex <uint>
Specifies the member index that is used with the volume index to uniquely identify a volume.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: VolumeIndex <uint>
Specifies the volume index that is used with the member index to uniquely identify a volume.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: UseIndex [<SwitchParameter>]
Specifies that the cmdlet should use the MemberIndex and VolumeIndex parameter values to identify a volume instead of the volume name. This is a faster method for getting access to the volume.
Required?: false Position?: named Default value?: false Accept pipeline input?: false Accept wildcard characters?: false Parameter: ScheduleName <string>
Specifies the name of the schedule for the specified volume to which this cmdlet applies. This name is case-sensitive.
Required?: true Position?: named Default value?: none
160
8 Schedule Cmdlets
Accept pipeline input?: true Accept wildcard characters?: false Parameter: NewScheduleName <string>
Changes the name of the schedule for the specified volume. This name must be unique for the volume and is case-sensitive.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: ScheduleType <string>
Changes the type of schedule. Enter (o)nce for a schedule that runs once; (h)ourly or (d)aily for a recurring schedule.
Required?: false Position?: named Default value?: once Accept pipeline input?: true Accept wildcard characters?: false Parameter: ReplicationSite [<string>]
Changes the name of the replication partner for the schedule to create replicas of the named volume. If a replication site is not specified, then the schedule creates snapshots. If replication of the specified volume to the named site is not configured, this cmdlet will fail.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: StartDate {DateTime}
Changes the time of day that the schedule will start running.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false
161
8 Schedule Cmdlets
Changes the time of day that the schedule will stop running.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: OnlineStatus <string>
Changes whether the snapshots created by the schedule are created with read_only or read_ write access.
Required?: false Position?: named Default value?: read_write Accept pipeline input?: true Accept wildcard characters?: false Parameter: ScheduleStatus <string>
Changes whether the schedule in an enabled or disabled state. Enter (e)nabled to enable the schedule or (d)isabled to disable the schedule.
Required?: false Position?: named Default value?: enabled Accept pipeline input?: true Accept wildcard characters?: false Parameter: KeepCount <string>
Changes the maximum number of snapshots or replicas created by this schedule that should be kept on the group before the deletion policy is applied.
162
8 Schedule Cmdlets
Required?: false Position?: named Default value?: 10 Accept pipeline input?: true Accept wildcard characters?: false Parameter: TimeFrequency <string>
Changes the number of minutes between runs in the time interval during which the schedule is configured to run. For example, enter 60 to run the schedule every hour.
Required?: false Position?: named Default value?: 5 Accept pipeline input?: true Accept wildcard characters?: false Parameter: PassThru [<SwitchParameter>]
Specifies that the cmdlet should return an EQL_SCHEDULE_SPEC object for the changed schedule on successful completion.
Required?: false Position?: named Default value?: false Accept pipeline input? false Accept wildcard characters?: false
Examples
Example 1 This command changes MySchedule to run between 5:00 AM and 3:00 PM.
C:\PS>Set-EqlSchedule -VolumeName MyVolume -ScheduleName MySchedule -StartTime 5:00AM -EndTime 3:00pm
Example 2 This command changes MySchedule to create read-only snapshots of MyVolume that are online and enables the schedule.
C:\PS>Set-EqlSchedule -VolumeName MyVolume -ScheduleName MySchedule -OnlineStatus online -AccessType read_only -ScheduleStatus enabled
Related Commands
Connect-EqlGroup cmdlet New-EqlVolume cmdlet Set-EqlVolume cmdlet Remove-EqlVolume cmdlet New-EqlSchedule cmdlet
163
8 Schedule Cmdlets
Remove-EqlSchedule cmdlet
Removes one or more of the schedules for the specified volume.
Command Syntax
Remove-EqlSchedule [-GroupName <string>] [-GroupAddress <string>] -VolumeName <string> [-MemberIndex <uint>] [-VolumeIndex <uint>] [-UseIndex [<SwitchParameter>]] [-ScheduleName <string>] [<CommonParameters>]
Command Description
The Remove-EqlSchedule cmdlet deletes the schedule with the specified name from a volume identified by name on a PS Series group to which a connection exists in the current PowerShell runspace. If you are connected to more than one group, you can specify the target group using either the GroupName or GroupAddress parameter. If a schedule name is not specified, all schedules are removed from the volume. Use the Get-EqlSchedule cmdlet to get the name for each of the schedules for a volume.
Inputs
None.
Outputs
None. Returns a string acknowledging the successful completion of the cmdlet action.
Command Parameters
Parameter: GroupName <string>
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. Either this parameter or the GroupName parameter can be used to identify a group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: GroupAddress <string>
Specifies the IP address of a PS Series group for which a session was exists in this PowerShell runspace. This parameter can be either IPv4 or IPv6. Either this parameter or the GroupName parameter can be used to identify a Group for this cmdlet.
164
8 Schedule Cmdlets
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: VolumeName <string>
Specifies the name of a volume on a PS Series group that identifies the volume to which this cmdlet applies. This name is case-sensitive.
Required?: true Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: MemberIndex <uint>
Specifies the member index that is used with the volume index to uniquely identify a volume.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: VolumeIndex <uint>
Specifies the volume index that is used with the member index to uniquely identify a volume.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: UseIndex [<SwitchParameter>]
Specifies that the cmdlet should use the MemberIndex and VolumeIndex parameter values to identify a volume instead of the volume name. This is a faster method for getting access to the volume.
Required?: false Position?: named Default value?: false Accept pipeline input?: false Accept wildcard characters?: false Parameter: ScheduleName <string>
Specifies the name of the schedule of the specified volume to which this cmdlet applies. This name is case-sensitive.
Required?: false Position?: named
165
8 Schedule Cmdlets
Default value?: none Accept pipeline input?: true Accept wildcard characters?: false
Examples
Example 1 This command deletes all of the schedules for MyVolume.
C:\PS>Remove-EqlSchedule -VolumeName MyVolume
Example 2 This command deletes the schedule named MySchedule from volume MyVolume.
C:\PS>Remove-EqlSchedule -VolumeName MyVolume -ScheduleName MySchedule
Related Commands
Connect-EqlGroup cmdlet Get-EqlVolume cmdlet Remove-EqlVolume cmdlet New-EqlSchedule cmdlet Set-EqlSchedule cmdlet Get-EqlSchedule cmdlet
166