Beruflich Dokumente
Kultur Dokumente
Reference Guide
Version 4.0
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. October 2011 Part Number: 110-6098-EN-R2
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 Array Management Cmdlets Restart-EqlMember cmdlet Stop-EqlMember cmdlet 5 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 Get-EqlLDAPServer cmdlet 1 1 2 3 4 4 5 5 5 6 7 7 9 13 13 15 19 19 19 20 22 25 27 37 40 43 45 48
iii
Contents
New-EqlLDAPServer cmdlet Remove-EqlLDAPServer cmdlet Set-EqlLDAPServer cmdlet Pool Configuration cmdlets New-EqlPool cmdlet Get-EqlPool cmdlet Set-EqlPool cmdlet Merge-EqlPool cmdlet Remove-EqlPool cmdlet Local CHAP Account cmdlets New-EqlChapUser cmdlet Get-EqlChapUser cmdlet Set-EqlChapUser cmdlet Remove-EqlChapUser cmdlet 6 Volume Administration Cmdlets Basic cmdlets New-EqlVolume cmdlet Get-EqlVolume cmdlet Get-EqlVolumeConnection 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
iv
Contents
New-EqlThinClone cmdlet ConvertFrom-EqlThinClone cmdlet 7 Snapshot Cmdlets New-EqlSnapshot cmdlet Get-EqlSnapshot cmdlet Get-EqlSnapshotConnection cmdlet Set-EqlSnapshot cmdlet Restore-EqlSnapshot cmdlet Remove-EqlSnapshot cmdlet New-EqlSnapshotClone cmdlet 8 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 New-EqlReplica cmdlet Get-EqlReplica cmdlet Remove-EqlReplica cmdlet Suspend-EqlReplication cmdlet Resume-EqlReplication cmdlet ConvertTo-EqlPromotedReplicaSet cmdlet ConvertTo-EqlDemotedReplicaSet cmdlet
121 124 127 127 131 134 136 140 143 146 149 149 149 153 155 160 162 165 168 170 172 173 175 178 180 182 184 186
Contents
Get-EqlInboundReplica cmdlet Get-EqlInboundReplicaSet cmdlet 9 Schedule Cmdlets New-EqlSchedule cmdlet Get-EqlSchedule cmdlet Set-EqlSchedule cmdlet Remove-EqlSchedule cmdlet Contacting Dell Online Services
vi
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, listing all of the iSCSI connections to a volume, 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 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, cloning a snapshot, and listing iSCSI connections to a snapshot. 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. 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 on individual replicas within a replica set, such as creating a new replica, getting a list of replicas, or deleting a specific replica. They also 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. The cmdlets handle IPV4 and IPv6 correctly as long as the values entered are enclosed in quotes. 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. Wildcard parameter matching is not case-sensitive.
See the documentation for a specific cmdlet for more information about that cmdlet.
Note: Refer to the documentation for a specific cmdlet to see what is available for its
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 PowerShell 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-EqlGroup cmdlet 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.
Inputs
None. You cannot pipe objects to Connect-EqlGroup.
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.
3 Session cmdlets
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>
Specifies the number of times to retry an SMTP request if it fails or times out.
Required?: false
3 Session cmdlets
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 caused 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 running 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
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.
3 Session cmdlets
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. 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.
Required?: true, unless GroupName 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.
10
3 Session cmdlets
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
Restart-EqlMember cmdlet
Shuts down and restarts an array. Restarting an array has no effect on member, volume, or group configuration information or volume data. When you restart an array, network connections are closed and the array is shut down. Then, the array automatically restarts. When the restart completes, the member rejoins the group automatically. Volumes with data located on the member will be unavailable until the restart completes. Restart an array only when you are updating the array firmware. Do not repeatedly restart an array.
Syntax
Restart-EqlMember [-GroupName <string>] [-GroupAddress <string>] -MemberName <string> [-Force[<SwitchParameter]] [<CommonParameters>]
Command Description
The Restart-EqlMember cmdlet shuts down and restarts the specified array that is a member of a PS Series group to which a connection exists in the current PowerShell runspace. This cmdlet will display a prompt to the console to confirm the restart. The Force parameter can be used to suppress this prompt for scripts.
Inputs
None.
Outputs
Returns a string acknowledging the successful initiation of the array restart process.
Command Parameters
Parameter: GroupName <string>
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. The GroupAddress parameter can be used instead of this parameter. The cmdlet will execute on the specified group.
Required?: false Position?: named Default value?: none Accept pipeline input?: true
13
Specifies the IP address of a PS Series group for which a session 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. The cmdlet will execute on the specified group.
Required?: false 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?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: Force [<SwitchParameter>]
Specifies that the cmdlet should bypass the confirmation prompt and restart the array.
Required?: false Position?: named Default value?: false Accept pipeline input?: false Accept wildcard characters?: false
Examples
Example 1 This command prompts for confirmation and initiates the shutdown and restart of Member1 if confirmed.
C:\PS>Restart-EqlMember -MemberName Member1
Example 2 This command initiates the shutdown and restart of Member1 without prompting for confirmation.
C:\PS>Restart-EqlMember -MemberName Member1 -Force
Related Commands
Connect-EqlGroup cmdlet
14
Stop-EqlMember cmdlet
Cleanly shuts down an array. Shutting down an array has no effect on member, volume, or group configuration information or volume data stored on the member. Any volumes with data on the array will be set offline until the array is completely restarted. Once the array is restarted, it rejoins the group automatically. Any iSCSI connections to volumes and snapshots on the array will be terminated and will not be available until the array is restarted.
Note: The Stop-EqlMember cmdlet does not power off the array. To power off the array,
you must turn off both power supplies after the array shuts down. Do not repeatedly shut down and restart an array. If you are using a network connection to run the Stop-EqlMember cmdlet, the session will be disconnected before the array is shut down. Therefore, make sure that the ACT LED on each control module is off (not lit) before turning off power to both power supplies. To fully restart the array, turn on power to both power supplies. When the array restart completes, volumes will be set online.
Syntax
Stop-EqlMember [-GroupName <string>] [-GroupAddress <string>] -MemberName <string> [-Force[<SwitchParameter]] [<CommonParameters>]
Command Description
The Stop-EqlMember cmdlet shuts down the specified array that is a member of a PS Series group to which a connection exists in the current PowerShell runspace. This cmdlet will display a prompt to the console to confirm the shut down. The Force parameter can be used to suppress this prompt for scripts.
Inputs
None.
Outputs
Returns a string acknowledging the successful initiation of the array shutdown process.
Command Parameters
Parameter: GroupName <string>
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. The GroupAddress parameter can be used instead of this parameter. The cmdlet will execute on the specified group.
15
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 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. The cmdlet will execute on the specified group.
Required?: false 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?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: Force [<SwitchParameter>]
Specifies that the cmdlet should bypass the confirmation prompt and shut down the array.
Required?: false Position?: named Default value?: false Accept pipeline input?: false Accept wildcard characters?: false
Examples
Example 1 This command prompts for confirmation and initiates the shutdown of Member1 cleanly if confirmed.
C:\PS>Stop-EqlMember -MemberName Member1
Example 2 This command initiates the shutdown of Member1 without prompting for confirmation.
C:\PS>Stop-EqlMember -MemberName Member1 -Force
16
Related Commands
Connect-EqlGroup cmdlet Get-EqlMember cmdlet Restart-EqlMember cmdlet
17
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 GroupAddress 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>
19
Specifies the IP address of a PS Series group for which a session 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 PS Series 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
The following Group ID is an example of a Group ID that will be output to the console.
6-0C0909-252711EE5-C2D4A40000002000
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-EqlVolume cmdlet is executed.
Inputs
None.
20
Outputs
Interop.EqlPsaMgmtAPI.EQL_PSGROUP_DEFAULT_SPEC
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 GroupAddress 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 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-EqlGroupDefaults 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
21
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 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
22
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 GroupAddress 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 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 or $true to use the volume name. Enter (n)o or $false 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?:false Position?: named
23
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.
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 or (d)elete_oldest 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
24
Examples
Example 1 This command will change the threshold 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 current PowerShell runspace.
C:\PS>Set-EqlGroupDefaults -ThinProvisionWarningPercentDefault 80 -ThinProvisionMaxGrowPercentDefault 95
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
25
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>
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. Either this parameter or the GroupAddress 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 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 are output to the console. See the following for sample output:
GroupName : GroupB GroupAddress : 10.100.100.5 GroupID : 6-0C0909-252711EE5-C2D4A40000002000 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 :
26
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 : **************** SyslogNotification : disabled NTPServers : 10.100.100.3:123;10.100.100.4 SyslogServers : 10.100.100.1 RadiusIscsiAuthentication : disabled RadiusLoginAuthentication : disabled RadiusAuthenticationServers : 10.100.100.1 RadiusAuthenticationSecrets : **************** RadiusAuthenticationTimeoutSeconds : 2 RadiusAuthenticationRetryCount : 1 RadiusUserAccounting : disabled RadiusAccountingServers : 10.100.100.1 RadiusAccountingSecrets : **************** RadiusAccountingTimeoutSeconds : 2 RadiusAccountingRetryCount : 1 LDAPLoginAuthentication:disabled
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>]
27
[-MembershipPassword [<string>]] [-SyslogNotification <string>] [-SyslogServers <string>] [-RadiusIscsiAuthentication <string>] [-RadiusLoginAuthentication <string>] [-RadiusAuthenticationServers <string>] [-RadiusAuthenticationSecrets <string>] [-RadiusAuthenticationTimeoutSeconds <int>] [-RadiusAuthenticationRetryCount <int>] [-RadiusUserAccounting <string>] [-RadiusAccountingServers <string>] [-RadiusAccountingSecrets <string>] [-RadiusAccountingTimeoutSeconds <int>] [-RadiusAccountingRetryCount <int>] [-LDAPLoginAuthentication <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 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 GroupAddress 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 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
28
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 or $true to enable the service and allow SSH access to the group and its member arrays. Enter (d)isabled or $false 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 or $true to enable the service and allow Telnet access to the group and its member arrays. Enter (d)isabled or $false to disable the service.
Required?: false Position?: named Default value?: enabled Accept pipeline input?: true Accept wildcard characters?: false Parameter: WebAccess <string>
Changes whether the use of standard HTTP Web connections (through port 80) to the Group Manager GUI is enabled or disabled. Enter (e)nabled or $true to enable the standard HTTP Web connections to the Group Manager GUI. Enter (d)isabled or $false 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 or $true to require SSL encryption. Enter (d)isabled or $false to not require SSL encryption.
Required?: false Position?: named Default value?: disabled Accept pipeline input?: true Accept wildcard characters?: false Parameter: ConnectionBalancing <string>
29
Changes whether iSCSI connection load balancing across group members is enabled or disabled. Enter (e)nabled or $true to enable iSCSI connection load balancing. Enter (d)isabled or $false 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 the optimal RAID level for a volume is enabled or disabled. Enter (e)nabled or $true to enable performance load balancing. Enter (d)isabled or $false 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 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 or $true to require the use of CHAP for discovery. Enter (d)isabled or $false 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.
30
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 enclosed in quotation marks. SMTPServers can be IPv4 or IPv6 for the Set-EqlGroupConfiguration cmdlet. A port can be specified with each address. For IPv4 addresses, the port number should be separated from the IP address using a colon (:). For IPv6 addresses, the port number should be separated from the IP address using a space. If a port is not specified, port 125 is used.
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 enclosed in quotation marks. NTPServers can be IPv4 or IPv6 for the Set-EqlGroupConfiguration cmdlet. A port can be specified with each address. For IPv4 addresses, the port number should be separated from the IP address using a colon (:). For IPv6 addresses, the port number should be separated from the IP address using a space. If a port is not specified, port 123 is used.
Required?: false 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>
31
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 or $true to send e-mail notification of events. Enter (d)isabled or $false to disable email 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 or $true to enable the FTP server. Enter (d)isabled or $false 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>
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 or $true to use local CHAP. Enter (d)isabled or $false to use external RADIUS authentication servers.
Required?: false Position?: named Default value?: disabled
32
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?: false 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?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: SyslogNotification <string>
Changes whether event logging to remote syslog servers is enabled.Enter (e)nabled or $true remote event logging. Enter (d)isabled or $false to disable it. To use syslog notification, you must also specify IP addresses for the syslog servers using the SyslogServers parameter.
Required?: false Position?: named Default value?: disabled Accept pipeline input?: true Accept wildcard characters?: false Parameter: SyslogServers <string>
Changes the list of IP Addresses and optional port information that identifies the remote servers used to log events. The servers must be configured to accept remote log files. This list is ordered by preference and should be enclosed in quotation marks. Port 514 is used. A different port
33
number cannot be set for the Syslog Servers. The IP addresses can be IPv4 or IPv6. Up to three addresses can be entered. If more than three are entered, the extra addresses are ignored. To remove all addresses, enter an empty string ("").
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: RadiusIscsiAuthentication <string>
Changes whether RADIUS authentication for host access to volumes is enabled. Enter (e)nabled or $true to use RADIUS authentication or (d)isabled or $false to disable it. To use RADIUS authentication, you must also specify IP addresses for the RADIUS Servers with the RadiusAuthenticationServers parameter.
Required?: false Position?: named Default value?: disabled Accept pipeline input?: true Accept wildcard characters?: false Parameter: RadiusLoginAuthentication <string>
Changes whether RADIUS authentication for group administration accounts is enabled. Enter (e)nabled or $true to use RADIUS authentication or (d)isabled or $false to disable it. To use RADIUS authentication, you must also specify IP addresses for the RADIUS Servers with the RadiusAuthenticationServers parameter.
Required?: false Position?: named Default value?: disabled Accept pipeline input?: true Accept wildcard characters?: false Parameter: RadiusAuthenticationServers <string>
Changes the list of IP addresses and optional port information that identify the servers used to authenticate host access of volumes through CHAP, group administration accounts, or Microsoft service access to the group. The servers are contacted in the order specified. The list should be enclosed in quotation marks. A port can be specified with each address. For IPv4 addresses, the port number should be separated from the IP address using a colon (:). For IPv6 addresses, the port number should be separated from the IP address using a space. If a port is not specified, the default RADIUS server port 1812 is used. The IP Addresses can be IPv4 or IPv6. Up to three addresses can be entered. If more than three are entered, the extra addresses are ignored. To remove all addresses, enter an empty string (""). If you use this parameter and the servers require passwords, then you must also enter the RadiusAuthenticationSecrets parameter.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false
34
Changes the list of secrets (passwords) for the RADIUS authentication servers specified for the RadiusAuthenticationServers parameter and specified in the same order. One to three secrets are specified (63 characters each maximum length) separated by commas and no spaces.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: RadiusAuthenticationTimeoutSeconds <int>
Changes the number of seconds to wait for a response from a RADIUS authentication server before timing out.
Required?: false Position?: named Default value?: 2 Accept pipeline input?: true Accept wildcard characters?: false Parameter: RadiusAuthenticationRetryCount <int>
Changes the number of times that the group will try to contact a RADIUS authentication server before trying the next server in the list.
Required?: false Position?: named Default value?: 1 Accept pipeline input?: true Accept wildcard characters?: false Parameter: RadiusUserAccounting <string>
Changes whether tracking of group administration accounts authenticated with RADIUS by RADIUS accounting servers is enabled. Enter (e)nabled or $true to track authentication by RADIUS accounting servers. Enter (d)isabled or $false to disable tracking. To use RADIUS accounting, you must also specify IP addresses for the RADIUS accounting servers using the RadiusAccountingServers parameter.
Required?: false Position?: named Default value?: disabled Accept pipeline input?: true Accept wildcard characters?: false Parameter: RadiusAccountingServers <string>
Changes the list of IP addresses and optional port information that identify the accounting servers used to track RADIUS authentication of group administration accounts. The list should be enclosed in quotation marks. These servers are contacted in the order specified. A port can be specified with each address. For IPv4 addresses, the port number should be separated from the IP address using a colon (:). For IPv6 addresses, the port number should be separated from
35
the IP address using a space. If a port is not specified, the default RADIUS server port 1812 is used. The IP Addresses can be IPv4 or IPv6. Up to three addresses can be entered. If more than three are entered, the extra addresses are ignored. To remove all addresses, enter an empty string (""). If you use this parameter and the servers require passwords, then you must also enter the RadiusAccountingSecrets parameter.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: RadiusAccountingSecrets <string>
Changes the list of secrets (passwords) for the RADIUS accounting servers specified for the RadiusAccountingServers parameter and specified in the same order. One to three secrets are specified (63 characters each maximum length) separated by commas and no spaces.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: RadiusAccountingTimeoutSeconds <int>
Changes the number of seconds to wait for a response from a RADIUS accounting server before timing out.
Required?: false Position?: named Default value?: 2 Accept pipeline input?: true Accept wildcard characters?: false Parameter: RadiusAccountingRetryCount <int>
Changes the number of times that the group will try to contact a RADIUS accounting server before trying the next server in the list.
Required?: false Position?: named Default value?: 1 Accept pipeline input?: true Accept wildcard characters?: false Parameter: LDAPLoginAuthentication <string>
Changes whether LDAP login authentication is enabled. Enter (e)nabled or $true to enable LDAP authentication or enter (d)isabled or $false to disable it. To use LDAP authentication at least one LDAP Server configuration entry must exist on the PS Series group. Use the New-EqlLDAPServer cmdlet to add a new configuration entry.
Required?: false Position?: named
36
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 changed group 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 New-EqlLDAPServer cmdlet Get-EqlLDAPServer cmdlet
Get-EqlMember cmdlet
Retrieves the current configuration settings for PS Series group member arrays.
37
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. Use the Get-EqlNetInterface cmdlet to get the network interface settings for the array.
Note: If the member array is offline, many of the configuration settings and statistics
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 GroupAddress 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 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
38
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 ModelNumber : 70-0202 SerialNumber : VM000c29db26ab3 ServiceTag : VIM26AB ProductFamily : PS6000 ChassisType : 1603 ControllerCount : 2 DiskCount : 16 CacheSizeMB : 249 CacheMode : write_back ChassisFlags : {isAccelerated} FirmwareVersion : Storage Array Firmware V5.0.2 (R138185) DefaultGateway : 10.127.0.1 StoragePoolName : default RaidType : raid5 OnlineStatus : online RAIDStatus : ok TotalSpaceMB : 8640 FreeSpaceMB : 7740 VolumeUsedSpaceMB : 900 SnapshotUsedSpaceMB : 0 ReplicaUsedSpaceMB : 0 ISCSIConnectionCount : 0
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
39
Related Commands
Connect-EqlGroup cmdlet Set-EqlMember cmdlet Remove-EqlMember cmdlet Get-EqlNetInterface cmdlet Set-EqlNetInterface 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.
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.
Note: Changing the RAID configuration to another type is initiated by this cmdlet and
may take a long time to complete. The member may be periodically taken offline during the process.
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_MEMBER_SPEC object is returned.
40
You can pipe objects from one Set-EqlMember to another Set-EqlMember cmdlet. 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 GroupAddress 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 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: 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
41
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 PS Series array. 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: RAID10 to RAID50, RAID6, or RAID5 RAID50 to RAID6 or RAID5 RAID6 to RAID5
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 changed group member on successful completion.
42
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 Restart-EqlMember cmdlet Stop-EqlMember cmdlet
Get-EqlNetInterface cmdlet
Retrieves the current network interface settings for PS Series group member arrays.
Command Syntax
Get-EqlNetInterface [-GroupName <string>] [-GroupAddress <string>] [-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.
43
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 GroupAddress 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 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: 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: 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
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
44
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 [-GroupName <string>] [-GroupAddress <string>] -MemberName <string> -InterfaceName <string> [-Description [<string>]] [-IPAddress <string>] [-SubnetMask [<string>]] [-DesiredStatus <string>] [-UseForManagementOnly <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 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.
45
Inputs
None.
Outputs
Interop.EqlPsaMgmtAPI.EQL_MEMBER_NETWORK_INTERFACE
You can pipe objects from Set-EqlNetInterface to another Set-EqlNetInterface cmdlet. 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 GroupAddress 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 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: 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?: true
46
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 Parameter: IPAddress <string>
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: DesiredStatus <string>
Changes whether the network interface is enabled or disabled for I/O traffic. Enter (u)p to enable the interface for use, or (d)own to disable it.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: UseForManagementOnly <string>
Changes whether the network interface is restricted to management only traffic. Enter (e)nabled to restrict the network interface to management traffic only, or (d)isabled to allow management and data I/O traffic on the network interface. IPAddress must be an IPv4 IP Address to restrict the network interface to management traffic only. Only the highest numbered interface available
47
(eth2 or eth3 in most configurations) for the member can be configured for management-only traffic.
Required?: false Position?: named Default value?: none 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 changed group member interface 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 and outputs a PSObject that contains the values from an Interop.EqlPsaMgmtAPI.EQL_MEMBER_NETWORK_INTERFACE for eth1 of Member1.
C:\PS>Set-EqlNetInterface -MemberName Member1 -InterfaceName eth1 -Description -PassThru
Related Commands
Connect-EqlGroup cmdlet Get-EqlNetInterface cmdlet Set-EqlMember cmdlet
Get-EqlLDAPServer cmdlet
Retrieves identifying and status information for a named LDAP server or for every LDAP server in a PS Series group.
48
Syntax
Get-EqlLDAPServer [-GroupName <string>] [-GroupAddress <string>] [-ServerIPAddress <string>] [<CommonParameters>]
Command Description
The Get-EqlLDAPServer cmdlet retrieves the configuration information for a LDAP Server specified by IP address on a PSSeries group to which a connection exists in the current PowerShell runspace. If a LDAP server IP address is not specified, data is returned for every LDAP server configured for the group.
Inputs
None. You cannot pipe objects to Get-EqlLDAPServer.
Outputs
Interop.EqlPsaMgmtAPI.EQL_LDAP_SERVER_SPEC
This command outputs an array of PSObjects containing the identifying information for the named LDAP server or all LDAP servers configured 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 GroupAddress 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 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 PS Series group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: ServerIPAddress <string>
49
Specifies the IP address of a LDAP Server on a PS Series group that identifies the LDAP Server to which this cmdlet applies. This parameter can be either IPv4 or IPv6.
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 following configuration information for LDAP Server with IP Address 10.100.100.100:
C:\PS>Get-EqlLDAPServer -ServerIpAddress 10.100.100.100
Example 2 This command will return a PSObject containing the configuration information for every LDAP server configured in the current group.
C:\PS>Get-EqlLDAPServer
Related Commands
Connect-EqlGroup cmdlet New-EqlLDAPServer cmdlet Set-EqlLDAPServer cmdlet Remove-EqlLDAPServer cmdlet
New-EqlLDAPServer cmdlet
Creates a new LDAP server in a PS Series group.
50
Syntax
New-EqlLDAPServer [-GroupName <string>] [-GroupAddress <string>] -ServerIPAddress <string> -BaseDistinguishedName <string> [-BindDistinguishedName <string>] [-BindCredential <System.Management.Automation.PSCredential>] [-BindPassword <string>] [-AnonymousAccess <string>] [-SecureProtocol <string>] [-Port <uint32>][-PassThru [<SwitchParameter>]] [<CommonParameters>]
Command Description
The New-EqlLDAPServer cmdlet creates a LDAP Server configuration entry with the specified IP address on a PS Series group to which a connection exists in the current PowerShell runspace. The group is registered with the specified LDAPserver. Up to three LDAP servers can be configured for a PS Series group.
Inputs
None. You cannot pipe objects to New-EqlLDAPServer.
Outputs
Interop.EqlPsaMgmtAPI.EQL_LDAP_SERVER_SPEC
Returns a string acknowledging the successful completion of the cmdlet action or an Interop.EqlPsaMgmtAPI.EQL_LDAP_SERVER_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 GroupAddress parameter can be used to identify a group for this cmdlet. The cmdlet will execute on the specified group.
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 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 PS Series group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false
51
Specifies the IP address of a LDAP Server on a PS Series group that identifies the LDAP Server to which this cmdlet applies. This parameter can be either IPv4 or IPv6.
Required?: true Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: BaseDistinguishedName <string>
Specifies the base distinguished name (511 characters maximum) for a LDAP Server on a PS Series group. The distinguished name must be enclosed with quotation marks.
Required?: true Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: BindDistinguishedName <string>
Specifies the bind distinguished name (511 characters maximum) for a LDAP Server on a PS Series group. The distinguished name must be enclosed with quotation marks. If AnonymousAccess is disabled, the BindDistinguishedName and BindPassword or BindCredential parameters must be specified.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: BindCredential <System.Management.Automation.PSCredential>
Specifies a PSCredential object containing the password (63 alphanumeric characters maximum) used with the Bind Distinguished Name of the LDAP Server.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: BindPassword <string>
Specifies the password used with the bind distinguished name. The BindCredential parameter can be used instead of the BindPassword parameter.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false
52
Specifies whether anonymous access is enabled or disabled for the LDAP server. Enter (y)es or $true to enable anonymous access. Enter (n)o or $false to disable anonymous access. If anonymous access is disabled, the BindDistinguishedName and BindPassword or BindCredential parameters must be specified. anonymous access.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: SecureProtocol <string>
Specifies the secure protocol used when accessing the LDAP server. Enter (T)LS or (S)SL for the secure protocol. Otherwise, enter (n)o_protocol.
Required?: false Position?: named Default value?: no_protocol Accept pipeline input?: true Accept wildcard characters?: false Parameter: Port <uint32>
Specifies that the cmdlet should return an EQL_LDAP_SERVER_SPEC object for the changed 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 creates a new LDAP server configuration entry and enables anonymous access to the server. The default values are used for all other parameters.
53
Example 2 This command creates a new LDAP server configuration entry with a bind distinguished name and bind password. The bind parameters are required because the value of AnonymousAccess is not changed from no (default) to yes.
C:\PS>New-EqlLDAPServer -ServerIPAddress 10.100.100.100 -BaseDistinguishedName "DC=MyDomain,DC=MyCompany,DC=com" -BindDistinguishedName "CN=MyAdm in,O=MyOrganization,C=MyCountry" -BindPassword password -PassThru
Related Commands
Connect-EqlGroup cmdlet Set-EqlLDAPServer cmdlet Get-EqlLDAPServer cmdlet Remove-EqlLDAPServer cmdlet
Remove-EqlLDAPServer cmdlet
Deletes a specified LDAP server in a PS Series group and moves its member arrays to the default LDAP server.
Syntax
Remove-EqlLDAPServer [-GroupName <string>] [-GroupAddress <string>] -ServerIPAddress <string> [-Force[<SwitchParameter>]] [<CommonParameters>]
Command Description
The Remove-EqlLDAPServer cmdlet deletes the LDAP server specified by IPaddress of a PS Series group to which a connection exists in the current PowerShell runspace.
Inputs
None. You cannot pipe objects to Remove-EqlLDAPServer.
Outputs
Returns a string acknowledging the successful completion of the cmdlet action.
54
Command Parameters
Parameter: GroupName <string>
Specifies the name of a PS Series group for which a session was created in this PowerShell runspace. The GroupAddress parameter can be used instead of this parameter. The cmdlet will execute on the specified group.
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 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: ServerIPAddress <string>
Specifies the IP address of a LDAP Server on a PS Series group that identifies the LDAP Server to which this cmdlet applies. This parameter can be either IPv4 or IPv6.
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 LDAP server configuration.
Required?: false Position?: named Default value?: false Accept pipeline input?: false Accept wildcard characters?: false
Examples
Example 1 This command will display a confirmation prompt to the console and remove the configuration for the specified LDAP Server if confirmed.
C:\PS>Remove-EqlLDAPServer -ServerIPAddress 10.100.100.100
55
Example 2 This command will remove the specified LDAP server configuration. It will not prompt for confirmation because -Force is specified.
C:\PS>Remove-EqlLDAPServer -ServerIPAddress 10.100.100.100 -Force
Related Commands
Connect-EqlGroup cmdlet New-EqlLDAPServer cmdlet Get-EqlLDAPServer cmdlet Set-EqlLDAPServer cmdlet
Set-EqlLDAPServer cmdlet
Changes the name and description of a specified LDAP server in a PS Series group.
Syntax
Set-EqlLDAPServer [-GroupName <string>] [-GroupAddress <string>] -ServerIPAddress <string> [-NewServerIPAddress <string>] [-BaseDistinguishedName <string>] [-BindDistinguishedName <string>] [-BindCredential <System.Management.Automation.PSCredential>] [-BindPassword <string>] [-AnonymousAccess <string>] [-SecureProtocol <string>] [-Port <uint32>][-PassThru [<SwitchParameter>]] [<CommonParameters>]
Command Description
This cmdlet changes the name and description of LDAP server specified by name on a PS Series group to which a connection exists in the current PowerShell runspace.
Inputs
None. You cannot pipe objects to Set-EqlLDAPServer.
Outputs
Interop.EqlPsaMgmtAPI.EQL_LDAP_SERVER_SPEC Returns a string acknowledging the successful completion of the cmdlet action or an Interop.EqlPsaMgmtAPI.EQL_LDAP_SERVER_SPEC object if the PassThru parameter is present.
56
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 GroupAddress parameter can be used to identify a group for this cmdlet. The cmdlet will execute on the specified group.
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 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 PS Series group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: ServerIPAddress <string>
Specifies the IP address of a LDAP Server on a PS Series group that identifies the LDAP Server to which this cmdlet applies. This parameter can be either IPv4 or IPv6.
Required?: true Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: NewServerIPAddress <string>
Changes the IP address for the specified LDAP Server on a PS Series group. This parameter can be either IPv4 or IPv6. If this IP address is for a different LDAP server, then you must also enter a new BaseDistinguishedName and if required, new credentials.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: BaseDistinguishedName <string>
Changes the base distinguished name (511 characters maximum) for a LDAP Server on a PS Series group. The distinguished name must be enclosed with quotation marks.
Required?: false
57
Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: BindDistinguishedName <string>
Changes the bind distinguished name (511 characters maximum) for a LDAP Server on a PS Series group. The distinguished name must be enclosed with quotation marks. If AnonymousAccess is disabled, the BindDistinguishedName and BindPassword or BindCredential parameters must be specified.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: BindCredential <System.Management.Automation.PSCredential>
Specifies a PSCredential object containing the password (63 alphanumeric characters maximum) used with the Bind Distinguished Name of the LDAP Server.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: BindPassword <string>
Changes the password used with the bind distinguished name. The BindCredential parameter can be used instead of the BindPassword parameter.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: AnonymousAccess <string>
Changes whether anonymous access is enabled or disabled for the LDAP server. Enter (y)es or $true to enable anonymous access. Enter (n)o or $false to disable anonymous access. If anonymous access is disabled, the BindDistinguishedName and BindPassword or BindCredential parameters must be specified.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: SecureProtocol <string>
58
Changes the secure protocol used when accessing the LDAP server. Enter (T)LS or (S)SL for the secure protocol. Otherwise, enter (n)o_protocol.
Required?: false Position?: named Default value?: no_protocol Accept pipeline input?: true Accept wildcard characters?: false Parameter: Port <uint32>
Specifies that the cmdlet should return an EQL_LDAP_SERVER_SPEC object for the changed group member on successful completion.
Required?: false Position?: named Default value?: false Accept pipeline input?: false Accept wildcard characters?: false
Example
This command will change the IP Address used to access the LDAP server from 10.100.100.100 to 10.100.100.200.
C:\PS>Set-EqlLDAPServer -ServerIPAddress 10.100.100.100 -NewServerIPAddress 10.100.100.200
Related Commands
Connect-EqlGroup cmdlet New-EqlLDAPServer cmdlet Get-EqlLDAPServer cmdlet Remove-EqlLDAPServer cmdlet
59
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 GroupAddress 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 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>
60
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
Get-EqlPool cmdlet
Retrieves identifying and status information for a named pool or for every pool in a PS Series group.
Command Syntax
Get-EqlPool [-GroupName <string>] [-GroupAddress <string>] [-StoragePoolName <string>] [<CommonParameters>]
61
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 GroupAddress 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 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. If this parameter is not specified, the cmdlet will get information for all pools on the group.
Required?: false Position?: named Default value?: none
62
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
Related Commands
Connect-EqlGroup cmdlet New-EqlVolume cmdlet Set-EqlVolume cmdlet Set-EqlMember cmdlet
63
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 GroupAddress 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 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
64
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 Parameter: PoolDescription [<string>]
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
Related Commands
Connect-EqlGroup cmdlet New-EqlPool cmdlet Get-EqlPool cmdlet Merge-EqlPool cmdlet Remove-EqlPool cmdlet
65
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> -DestinationStoragePoolName <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 GroupAddress 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 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
66
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: DestinationStoragePoolName <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
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 -DestinationStoragePoolName 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 -DestinationStoragePoolName PoolA -Force
67
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.
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 GroupAddress parameter can be used to identify a group for this cmdlet.
Required?: false Position?: named
68
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 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 PS Series 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
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
69
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. 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 GroupAddress parameter can be used to identify a group for this cmdlet.
70
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 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.
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
71
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>]
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.
72
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 GroupAddress 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 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 Set-EqlChapUser cmdlet Remove-EqlChapUser cmdlet
Set-EqlChapUser cmdlet
Changes the password for the specified local CHAP user.
73
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 GroupAddress 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 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 CHAP user account on a PS Series group that identifies the CHAP user to which this cmdlet applies.
74
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)
Related Commands
Connect-EqlGroup cmdlet New-EqlChapUser cmdlet Get-EqlChapUser cmdlet Remove-EqlChapUser cmdlet
75
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 GroupAddress 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 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
76
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
77
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>] [-VolumeAdministrator <string>] [-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
79
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 GroupAddress parameter can be used to identify a PS Series 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 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 PS Series 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>
80
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
81
Specifies whether load balancing should be enabled or disabled for the new volume. Enter (y)es or $true to enable load balancing. Enter (n)o or $false 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 or $true to set it online or (off)line or $false 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 or $true to allow multiple initiator access. Enter (n)o or $false to not allow sharing of the volume.
Required?: false Position?: named Default value?: no Accept pipeline input?: true
82
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 or (d)elete_oldest 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 or $true to thin provision the new volume. Enter (n)o or $false 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
83
Specifies the percent of the requested volume size that can be used before a warning is issued.
Required?: false Position?: named 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: VolumeAdministrator <string>
Sets the name of the Volume Administrator that will own this volume. This name is case sensitive. If the name specified is not a volume admin, the command will fail.
Required?: false Position?: named Default value?: none 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
84
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 default 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
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>]] [-StoragePoolName <string>] [-AccessType <string>][-OnlineStatus <string>] [-AllowMultipleInitiators <string>] [-ThinProvision <string>] [-TemplateVolume <string>] [-ThinClone <string>] [-NASVolume <string>] [-ISCSITargetName <string>] [-PSVID <string>] [-PSVIDAsGuid <string>] [<CommonParameters>]
85
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. The name specified can contain wildcards to retrieve all volumes with names that match the wildcard pattern. The list of volumes can also be filtered using one or more of the following parameters: StoragePoolName, AccessType, OnlineStatus, AllowMultipleInitiators, ThinProvision, TemplateVolume, and ThinClone. It can also be filtered using the ISCSITargetName, PSVID, and PSVIDAsGuid parameters which can contain wildcards. If more than one filter criterion is specified, volumes must match all of the specified criteria. If neither a volume name nor filter parameters are specified, this command will retrieve the information for all volumes on the current or specified PS Series group. 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.
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 GroupAddress 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 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.
86
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 name can contain wildcard characters (* and ?) to retrieve the information for all volumes that match the wildcard pattern. Wildcard matching is not case-sensitive.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: true 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: StoragePoolName <string>
Filters the list of volumes to only include volumes in the specified storage pool.
Required?: false
87
Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: AccessType <string>
Filters the list of volumes to only include volumes that match the specified AccessType value: (r)ead_only or read_(w)rite.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: OnlineStatus <string>
Filters the list of volumes to only include volumes that match the specified OnlineStatus value: Enter (on)line or $true to get volumes that allow multiple initiators. Enter (n)o or $false to exclude volumes that allow multiple initiators.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: AllowMultipleInitiators <string>
Filters the list of volumes to only include volumes that match the specified value. Enter (y)es or $true to allow multiple initiator access. Enter (n)o or $false to not allow sharing of the volume.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: ThinProvision <string>
Filters the list of volumes to only include volumes that match the specified ThinProvision value: Enter (y)es or $true to get thin provisioned volumes. Enter (n)o or $false to exclude thin provisioned volumes.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: TemplateVolume <string>
Filters the list of volumes to only include volumes that match the specified TemplateVolume value: Enter (y)es $true to get template volumes. Enter (n)o or $false to exclude template volumes.
88
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: ThinClone <string>
Filters the list of volumes to only include volumes that match the specified ThinClone value: Enter (y)es $true to get thin clones. Enter (n)o or $false to exclude thin clones.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: NASVolume <string>
Filters the list of volumes to only include volumes that match the specified NASVolume value: Enter (y)es or $true to get NASvolumes. Enter (n)o or $false to exclude NASvolumes.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: ISCSITargetName <string>
Specifies the iSCSI target name for a volume on a PSSeries group that identifies the volume to which this cmdlet applies. This name is not case-sensitive. The name can contain wildcard characters (* and ?) to retrieve the information for all volumes that match the wildcard pattern.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: true Parameter: PSVID <string>
Specifies the PSVID for a volume on a PSSeries group that identifies the volume to which this cmdlet applies. This PSVID is not case-sensitive. The PSVID can contain wildcard characters (* and ?) to retrieve the information for all volumes that match the wildcard pattern.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: true Parameter: PSVIDAsGuid <string>
Specifies the PSVID formatted as a GUID for a volume on a PSSeries group that identifies the volume to which this cmdlet applies. This GUID is not case-sensitive. The GUID can contain
89
wildcard characters (* and ?) to retrieve the information for all volumes that match the wildcard pattern.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: true
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 MemberIndex : 1073788292 VolumeIndex : 2 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 VolumeAdministrator : MyVolumeAdmin 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 NASVolume: no CloneSourcePsvid : 00000000-0000-0000-0000-000000000000 AllocatedMB : 0 SnapshotReserveAvailableMB : 105 OperationalStatus : available SnapshotReserveMB : 105 SnapshotCount : 3 ISCSIConnectionCount : 0 SpannedMemberCount : 1 ReplicaCount : 0
90
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
91
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
Example 5 This command gets the configuration and current statistics for every volume which has a name that begins with "MyVol" on the PS Series group named MyGroup.
C:\PS>Get-EqlVolume -VolumeName MyVol* -GroupName MyGroup
Example 6 This command gets the configuration and current statistics for every thin-provisioned volume on the PS Series group at IP Address 10.100.100.10.
C:\PS>Get-EqlVolume -GroupAddress 10.100.100.10 -ThinProvision yes
Related Commands
Connect-EqlGroup cmdlet New-EqlVolume cmdlet Set-EqlVolume cmdlet Remove-EqlVolume cmdlet New-EqlVolumeACL cmdlet Get-EqlVolumeACL cmdlet Remove-EqlVolumeACL cmdlet Get-EqlVolumeConnection cmdlet
92
Get-EqlVolumeConnection cmdlet
Retrieves configuration and statistics for iSCSI connections to a volume.
Syntax
Get-EqlVolumeConnection [-GroupName <string>] [-GroupAddress <string>] -VolumeName <string> [-MemberIndex [<uint>]] [-VolumeIndex [<uint>]] [-UseIndex [<SwitchParameter>]] [<CommonParameters>]
Command Description
The Get-EqlVolumeConnection cmdlet retrieves the configuration and statistics for all iSCSI connections to a volume identified by name on a PS Series group to which a connection exists in the current PowerShell runspace.
Inputs
None.
Outputs
Interop.EqlPsaMgmtAPI.EQL_ISCSI_CONNECTION_SPEC
You can pipe objects from the Get-EqlVolume cmdlets to the Get-EqlVolumeConnection cmdlet to get a list for all or a subset of volumes on a group. Specify the UseIndex parameter to make this more efficient on a group with a large number of volumes.
Command Parameters
Parameter: GroupName <string>
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. The GroupAddress parameter can be used instead of this parameter. The cmdlet will execute on the specified group.
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 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. The cmdlet will execute on the specified group.
Required?: false
93
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?: true Parameter: MemberIndex <uint>
Specifies the member index that is used with the volume index to uniquely identify a volume. If you specify a member index, you must also specify a volume index.
Required?: true, if Useindex is specified. Position?: named Default value?: none 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. If you specify a volume index, you must also specify a member index.
Required?: true, if UseIndex is specified. Position?: named Default value?: none 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
Examples
Example 1 This command gets the configuration and current statistics for every connection to MyVolume.
C:\PS>Get-EqlVolumeConnection -VolumeName MyVolume
94
Example 2 This command gets the configuration and current statistics for every connection to every volume on a PS Series group. The UseIndex parameter causes the Get-EqlVolumeConnection cmdlet to identify the volumes using the MemberIndex and VolumeIndex parameters piped from the Get-EqlVolume cmdlet. This results in significantly faster execution on groups that have many volumes.
C:\PS>Get-EqlVolume | Get-EqlVolumeConnection -UseIndex
Related Commands
Connect-EqlGroup cmdlet Get-EqlVolume cmdlet Get-EqlSnapshotConnection 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>] [-ThinProvisionWarningPercent <uint>] [-ThinProvisionMaxGrowPercent <uint>] [-VolumeAdministrator <string>] [-PassThru [<SwitchParameter>]] [<CommonParameters>]
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
95
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 parameters, 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 GroupAddress 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 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
96
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>
Changes the percent of the volume size set aside for snapshot reserve.
97
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 or $true to enable load balancing. Enter (n)o or $false 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 an empty string ("") for the parameter value.
Required?: false 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 or $true to set it online. Enter (off)line or $false to set it offline.
98
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 or $true to allow multiple initiator access. Enter (n)o or $false 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). Enter an empty string ("") for the parameter value.
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 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 or (d)elete_oldest for the policy.
99
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 or $true to thin provision the volume. Enter (n)o or $false 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 Default value?: 100 Accept pipeline input?: true Accept wildcard characters?: false Parameter: VolumeAdministrator <string>
Changes the name of the Volume Administrator that owns this volume. This name is case sensitive. If the name specified is not a volume admin, the command will fail. Enter an empty string ("") to clear the current value.
100
Required?: false Position?: named Default value?: none 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 changes 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 -ThinProvisionMinReservePercent 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
101
Remove-EqlVolume cmdlet
Deletes a specified volume and its snapshots, schedules, and ACLs from a PS Series group.
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. Use Set-EqlVolume to take the volume offline before trying to delete it. 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 GroupAddress 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 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
102
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: 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
103
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 Get-EqlVolumeConnection cmdlet Remove-EqlReplica 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>]
104
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 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 GroupAddress 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 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.
105
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: 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
106
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 parameter 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.
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
107
Example 3 This command copies the access control lists from MyVolume1 to MyVolume2.
C:\PS>Get-EqlVolumeACL -VolumeName MyVolume1 | New-EqlVolumeACL -VolumeName MyVolume2
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>]
108
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 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 GroupAddress 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 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.
109
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 gets all of the ACLs for MyVolume.
C:\PS>Get-EqlVolumeACL -VolumeName MyVolume
Related Commands
Connect-EqlGroup cmdlet
110
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.
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 GroupAddress 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
111
Specifies the IP address of a PS Series group for which a session 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 Parameter: AclIndex <uint>
112
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
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.
113
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 GroupAddress 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 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
114
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: 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>
115
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.
C:\PS>New-EqlVolumeClone -VolumeName MyVolume -CloneName MyVolumeClone -StoragePoolName MyPool
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>]
116
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.
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 GroupAddress 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 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
117
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: 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
118
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
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>
119
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. Either this parameter or the GroupAddress parameter can be used to identify a PS Series 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 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 PS Series 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 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>]
120
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
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.
121
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 GroupAddress 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 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.
122
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: CloneName <string>
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
123
ConvertFrom-EqlThinClone cmdlet
Detaches a thin clone from its template volume.
Command Syntax
ConvertFrom-EqlThinClone [-GroupName <string>] [-GroupAddress <string>] -CloneName <string> [<CommonParameters>]
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 GroupAddress parameter can be used to identify a PS Series 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 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 PS Series group for this cmdlet.
124
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.
C:\PS>ConvertFrom-EqlThinClone -CloneName MyThinClone
Related Commands
Connect-EqlGroup cmdlet Set-EqlVolume cmdlet Get-EqlVolume cmdlet Remove-EqlVolume cmdlet ConvertFrom-EqlTemplateVolume cmdlet New-EqlThinClone cmdlet
125
7 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.
127
7 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 GroupAddress 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 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
128
7 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 the snapshot is created and set online or offline. Enter (on)line or $true to set it online or (off)line or $false to set it offline.
Required?: false Position?: named Default value?: offline Accept pipeline input?: true Accept wildcard characters?: false Parameter: AllowMultipleInitiators <string>
Specifies whether multiple initiators will be allowed to connect to the snapshot at the same time. Enter (y)es or $true to enable multiple initiator access. Enter (n)o or $false to disable it.
Required?: false Position?: named Default value?: no Accept pipeline input?: true Accept wildcard characters?: false Parameter: PassThru [<SwitchParameter>]
129
7 Snapshot Cmdlets
Specifies that the cmdlet should return an EQL_SNAPSHOT_SPEC object for the new snapshot 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 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
130
7 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 GroupAddress 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 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.
131
7 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
132
7 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 Get-EqlSnapshotConnection cmdlet
133
7 Snapshot Cmdlets
Get-EqlSnapshotConnection cmdlet
Retrieves configuration and statistics for iSCSI connections to a snapshot.
Syntax
Get-EqlSnapshotConnection [-GroupName <string>] [-GroupAddress <string>] -VolumeName <string> [-MemberIndex <uint>] [-VolumeIndex <uint>] [-UseIndex [<SwitchParameter>]] -SnapshotName <string> [<CommonParameters>]
Command Description
The Get-EqlSnapshotConnection cmdlet retrieves the configuration and statistics for all iSCSI connections to a snapshot identified by name on a PS Series group to which a connection exists in the current PowerShell runspace.
Inputs
None.
Outputs
Interop.EqlPsaMgmtAPI.EQL_ISCSI_CONNECTION_SPEC
You can pipe objects from the Get-EqlSnapshot cmdlet to the Get-EqlSnapshotConnection cmdlet to get a list of connections for all snapshots of a volume on a group.
Command Parameters
Parameter: GroupName <string>
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. The GroupAddress parameter can be used instead of this parameter. The cmdlet will execute on the specified group.
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 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. The cmdlet will execute on the specified group.
Required?: false Position?: named
134
7 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?: none Accept pipeline input?: true Accept wildcard characters?: true Parameter: MemberIndex <uint>
Specifies the member index that is used with the volume index to uniquely identify a volume. If you specify a member index, you must also specify a volume index.
Required?: true, if UseIndex is specified. Position?: named Default value?: none 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. If you specify a volume index, you must also specify a member index.
Required?: true, if UseIndex is specified. Position?: named Default value?: none 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?: true Position?: named
135
7 Snapshot Cmdlets
Default value?: none Accept pipeline input?: true Accept wildcard characters?: true
Examples
Example 1 This command gets the configuration and current statistics for every connection to MyVolume.
C:\PS>Get-EqlSnapshotConnection -VolumeName MyVolume -SnapshotName MyVolume-2010-06-10-08:00:00.1234
Example 2 This command gets the configuration and current statistics for every connection to every snapshot of MyVolume on the PS Series group.
C:\PS>Get-EqlSnapshot -VolumeName MyVolume | Get-EqlSnapshotConnection
Related Commands
Connect-EqlGroup cmdlet Get-EqlSnapshot cmdlet Get-EqlVolume cmdlet Get-EqlVolumeConnection cmdlet
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>]]
136
7 Snapshot Cmdlets
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 GroupAddress 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 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
137
7 Snapshot 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: 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?: true Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: NewSnapshotName <string>
138
7 Snapshot Cmdlets
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>
Changes whether multiple initiators are allowed to connect to the snapshot at the same time. Enter (y)es or $true to enable multiple initiator access. Enter (n)o or $false to disable it.
139
7 Snapshot Cmdlets
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
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.
140
7 Snapshot Cmdlets
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 GroupAddress 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 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
141
7 Snapshot 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: 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?: true Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false
142
7 Snapshot Cmdlets
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>] [-SelectOldest {<SwitchParameter>]] [<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. The SelectOldest parameter can be specified instead the snapshot name to remove the oldest snapshot for the volume. If neither a snapshot name nor SelectOldest is specified, all snapshots of the volume are removed.
Inputs
None.
Outputs
None. Returns a string acknowledging the successful completion of the cmdlet action.
143
7 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 GroupAddress 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 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
144
7 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: 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. If this parameter is specified, the SelectOldest parameter must not be used.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: SelectOldest [<SwitchParameter>]
Specifies that the cmdlet should select the oldest snapshot for removal. If this parameter is specified, the SnapshotName parameter must not be used.
Required?: false Position?: named Default value?: false Accept pipeline input?: false 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
145
7 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 GroupAddress 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>
146
7 Snapshot Cmdlets
Specifies the IP address of a PS Series group for which a session 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: 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.
147
7 Snapshot Cmdlets
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false Parameter: CloneName <string>
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
148
8 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_SPEC object 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.
149
8 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 GroupAddress 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 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.
150
8 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>
151
8 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 OutboundCredential parameter.
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 PartnerName parameter. The OutboundCredential parameter can be used instead of the OutboundPassword parameter.
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, or (d)isabled to disable replication.
Required?: false Position?: named Default value?: enabled Accept pipeline input?: true Accept wildcard characters?: false Parameter: PassThru [<SwitchParameter>]
152
8 Replication Cmdlets
Specifies that the cmdlet should return an EQL_PARTNER_SPEC object for the new replication partnership 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
153
8 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 GroupAddress 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 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
154
8 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>]
155
8 Replication Cmdlets
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. Otherwise, an Interop.EqlPsaMgmtAPI.EQL_PARTNER_SPEC object 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 GroupAddress 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 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.
156
8 Replication Cmdlets
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 Parameter: PartnerIPAddress <string>
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 InboundCredential parameter.
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 PartnerName parameter. 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>
157
8 Replication Cmdlets
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>
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.
158
8 Replication Cmdlets
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>
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, or enter (d)isabled to 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 changed 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
159
8 Replication Cmdlets
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
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>
160
8 Replication Cmdlets
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. Either this parameter or the GroupAddress 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 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 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
161
8 Replication Cmdlets
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.
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>
162
8 Replication Cmdlets
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. Either this parameter or the GroupAddress 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 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 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>
163
8 Replication Cmdlets
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 Accept wildcard characters?: false Parameter: KeepLocalFailback <string>
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
164
8 Replication Cmdlets
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
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
165
8 Replication Cmdlets
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, it retrieves information for all of the outbound replica sets for the PS Series group.
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>
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. Either this parameter or the GroupAddress 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 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. If this parameter is specified, the ReplicationSite parameter must also be specified.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: ReplicationSite <string>
166
8 Replication Cmdlets
Specifies the name of a PS Series group that identifies the replication partner to which this cmdlet applies. This name is case-sensitive. If this parameter is specified, the VolumeName parameter must also be specified.
Required?: false 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
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 Get-EqlInboundReplicaSet cmdlet
167
8 Replication Cmdlets
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.
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 GroupAddress 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 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
168
8 Replication Cmdlets
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>
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
169
8 Replication Cmdlets
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
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.
170
8 Replication Cmdlets
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.
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 GroupAddress 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 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.
171
8 Replication Cmdlets
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 Accept pipeline input?: false Accept wildcard characters?: false
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
172
8 Replication Cmdlets
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> [-PassThru [<SwitchParameter>]] [<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>
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. Either this parameter or the GroupAddress 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 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
173
8 Replication 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. 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>]
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
174
8 Replication Cmdlets
Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: PassThru [<SwitchParameter>]
Specifies that the cmdlet should return an EQL_REPLICA_SPEC object for the new replica on successful completion.
Required?: false Position?: named Default value?: false Accept pipeline input?: false 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
Get-EqlReplica cmdlet
Retrieves a list of replicas for a specified volume.
Syntax
Get-EqlReplica [-GroupName <string>] [-GroupAddress <string>] -VolumeName <string> -ReplicationSite <string> [-ReplicaName <string>] [<CommonParameters>]
175
8 Replication Cmdlets
Command Description
The Get-EqlReplica cmdlet retrieves information for the replicas available in a replica set identified by volume name and replication site on a PS Series group to which a connection exists. The ReplicaName value for a replica can be used for the ReplicaName parameter of the Remove-EqlReplica cmdlet to identify which replica to delete. The AdminStatus value for a replica can be used to determine whether other actions can be performed on the replica.
Inputs
None.
Outputs
An Interop.EqlPsaMgmtAPI.EQL_REPLICA_SPEC object or a string. Returns an array of PSObjects containing the information for the replicas in the specified replica set or a string indicating that no replicas were found.
Command Parameters
Parameter: GroupName <string>
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. The GroupAddress parameter can be used instead of this parameter. The cmdlet will execute on the specified group.
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 created from 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. The cmdlet will execute on the specified group.
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 is used with the ReplicationSite parameter to identify the replica set that contains the replicas to which this cmdlet applies. This name is case-sensitive.
176
8 Replication Cmdlets
Required?: true Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: true Parameter: ReplicationSite <string>
Specifies the name of a PS Series group that is used with the VolumeName parameter to identify the replica set that contains the replicas to which this cmdlet applies. This name is casesensitive.
Required?: true Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: ReplicaName <string>
Specifies the name of a replica on a PS Series group that identifies the replica 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
Example 1
This command returns the information for all of the replicas in the replica set for MyVolume on PSGroupB.
C:\PS>Get-EqlReplica -VolumeName MyVolume -ReplicationSite PSGroupB | format-list
The following is sample output for the four replicas in the specified replica set:
VolumeName : MyVolume ReplicationSite : PSGroupB ReplicaName : MyVolume.1-2010-06-21-08:24:36.27164 AdminStatus : replica_completed VolumeName : MyVolume ReplicationSite : PSGroupB ReplicaName : MyVolume.1-2010-09-14-16:28:20.61291 AdminStatus : replica_completed VolumeName : MyVolume ReplicationSite : PSGroupB ReplicaName : MyVolume.1-2011-01-31-10:52:04.73532 AdminStatus : replica_completed VolumeName : MyVolume ReplicationSite : PSGroupB ReplicaName : MyVolume.1-2011-01-31-16:26:40.73543 AdminStatus : replica_completed
177
8 Replication Cmdlets
Related Commands
Connect-EqlGroup cmdlet New-EqlReplica cmdlet Remove-EqlReplica cmdlet New-EqlReplicaSet cmdlet Get-EqlReplicaSet cmdlet Remove-EqlReplicaSet cmdlet Get-EqlInboundReplica cmdlet Get-EqlInboundReplicaSet cmdlet
Remove-EqlReplica cmdlet
Deletes a replica from a replica set.
Syntax
Remove-EqlReplica [-GroupName <string>] [-GroupAddress <string>] [-VolumeName <string>] -ReplicationSite <string> -ReplicaName <string> [-SelectOldest [<SwitchParameter>]] [-Force [<SwitchParameter>]] [<CommonParameters>]
Command Description
The Remove-EqlReplica cmdlet deletes a replica identified by name from a replica set identified by volume name and replication site on a PS Series group to which a connection exists.
Inputs
None.
Outputs
Returns a string acknowledging the successful completion of the cmdlet action.
Command Parameters
Parameter: GroupName <string>
178
8 Replication Cmdlets
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. The GroupAddress parameter can be used instead of this parameter. The cmdlet will execute on the specified group.
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 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. The cmdlet will execute on the specified group.
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 is used with the ReplicationSite parameter to identify the replica set that contains the replica 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 is used with the VolumeName parameter to identify the replica set that contains the replica 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: ReplicaName <string>
Specifies the name of a replica in a replicaset on a PS Series group that identifies the replica to which this cmdlet applies. This name is case-sensitive.
Required?: true, unsless SelectOldest is specified. Position?: named Default value?: none Accept pipeline input?: true
179
8 Replication Cmdlets
Specifies that the cmdlet should bypass the confirmation prompt and delete the replica.
Required?: false Position?: named Default value?: false Accept pipeline input?: false Accept wildcard characters?: false Parameter: SelectOldest [<SwitchParameter>]
Specifies that the cmdlet should select the oldest replica in the replica set for removal. If this parameter is specified, the ReplicaName parameter must not be used.
Required?: false Position?: named Default value?: false Accept pipeline input?: false Accept wildcard characters?: false
Example
This command prompts for confirmation and if the user confirms the action, removes the replica MyVolume.1-2011-01-01-00:00:00.100 from the replicaset for MyVolume on PSGroupB.
C:\PS>Remove-EqlReplica -VolumeName MyVolume -ReplicationSite PSGroupB -ReplicaName MyVolume.1-2011-01-01-00:00:00.100
Related Commands
Connect-EqlGroup cmdlet New-EqlReplica cmdlet New-EqlReplicaSet cmdlet Get-EqlReplicaSet cmdlet Remove-EqlReplicaSet 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>]
180
8 Replication Cmdlets
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.
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 GroupAddress 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 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>
181
8 Replication Cmdlets
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.
C:\PS>Suspend-EqlReplication -VolumeName MyVolume -ReplicationSite PSGroupB
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.
182
8 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 GroupAddress 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 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.
183
8 Replication Cmdlets
Related Commands
Connect-EqlGroup cmdlet Get-EqlVolume cmdlet Remove-EqlVolume cmdlet Suspend-EqlReplication cmdlet New-EqlReplica cmdlet ConvertTo-EqlPromotedReplicaSet cmdlet ConvertTo-EqlDemotedReplicaSet cmdlet Remove-EqlReplicaSet cmdlet
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>
184
8 Replication Cmdlets
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. Either this parameter or the GroupAddress 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 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: 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
185
8 Replication Cmdlets
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.
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 GroupAddress parameter can be used to identify a PS Series group for this cmdlet.
Required?: false Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: GroupAddress <string>
186
8 Replication Cmdlets
Specifies the IP address of a PS Series group for which a session 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 PS Series 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.
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
Get-EqlInboundReplica cmdlet
Retrieves a list of replicas for a specified inbound replica set.
Command Syntax
Get-EqlInboundReplica [-GroupName <string>] [-GroupAddress <string>] -ReplicaSetName <string> [-ReplicaName <string>] [<CommonParameters>]
187
8 Replication Cmdlets
Command Description
This cmdlet retrieves information for the replicas available in an inbound replica set identified by replica set name on a PS Series group to which a connection exists.
Inputs
None.
Outputs
Interop.EqlPsaMgmtAPI.EQL_INBOUND_REPLICA_SPEC
or string
Returns an array of PSObjects containing the information for the replicas in the specified replica set or a string indicating that no replicas were found.
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 GroupAddress 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 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: ReplicaSetName <string>
Specifies the name of an inbound replica set on a PS Series group that identifies the replica set containing the replicas 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: ReplicaName <string>
188
8 Replication Cmdlets
Specifies the name of an inbound replica on a PS Series group that identifies the replica to which this cmdlet applies. This name is case-sensitive.
Required?: false Position?: named Default value?: Accept pipeline input?: true Accept wildcard characters?: false
Example
This command returns the information for all of the replicas in the inbound replica set MyVolume.3.
C:\PS>Get-EqlInboundReplica -ReplicaSetName MyVolume.3 | format-list
The following is sample output for the four replicas in the specified inbound replica set:
ReplicaSetName : MyVolume.3 VolumeName : MyVolume ReplicationSite : GroupB ReplicaName : MyVolume.3 -2010-04-13-12:54:58.5 ReplicaSetName : MyVolume.3 VolumeName : MyVolume ReplicationSite : GroupB ReplicaName : MyVolume.3 -2010-04-13-13:00:04.6 ReplicaSetName : MyVolume.3 VolumeName : MyVolume ReplicationSite : GroupB ReplicaName : MyVolume.3 -2010-05-20-13:18:16.22 ReplicaSetName : MyVolume.3 VolumeName : MyVolume ReplicationSite : GroupB ReplicaName : MyVolume.3 -2010-05-20-13:18:16.23
Related Commands
Connect-EqlGroup cmdlet New-EqlReplica cmdlet Get-EqlReplica cmdlet New-EqlReplicaSet cmdlet Get-EqlInboundReplicaSet cmdlet Get-EqlReplicaSet cmdlet Remove-EqlReplica cmdlet
Get-EqlInboundReplicaSet cmdlet
Retrieves information for a specified replica set or all replica sets replicated from another group.
189
8 Replication Cmdlets
Command Syntax
Get-EqlInboundReplicaSet [-GroupName <string>] [-GroupAddress <string>] [-ReplicaSetName <string>] [<CommonParameters>]
Command Description
This cmdlet retrieves information for a replica set identified by name on a PS Series group to which a connection exists. If a name is not specified, it retrieves information for all of the inbound replica sets for the PS Series group.
Inputs
None.
Outputs
Interop.EqlPsaMgmtAPI.EQL_INBOUND_REPLICA_SET_SPEC
Returns a PSObject for an Interop.EqlPsaMgmtAPI.EQL_INBOUND_REPLICA_SET_SPEC. The output of the Get-EqlInboundReplicaSet cmdlet can be piped to other cmdlets such as the GetEqlInboundReplica cmdlet.
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 GroupAddress 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 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: ReplicaSetName <string>
Specifies the name of an inbound replica set on a PS Series group that identifies the replica set containing the replicas to which this cmdlet applies. This name is case-sensitive.
190
8 Replication Cmdlets
Required?: true Position?: named Default value?: none Accept pipeline input?: true Accept wildcard characters?: false
Example
This command retrieves the following configuration information for the replica set of MyVolume.2 on the current PS Series group:
C:\PS>Get-EqlInboundReplicaSet -ReplicaSetName MyVolume.2
Related Commands
Connect-EqlGroup cmdlet Get-EqlInboundReplica cmdlet New-EqlReplica cmdlet New-EqlReplicaSet cmdlet Get-EqlReplicaSet cmdlet Set-EqlReplicaSet cmdlet Remove-EqlReplicaSet cmdlet Suspend-EqlReplication cmdlet Resume-EqlReplication cmdlet ConvertTo-EqlPromotedReplicaSet cmdlet ConvertTo-EqlDemotedReplicaSet cmdlet
191
9 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 GroupAddress parameter can be used to identify a group for this cmdlet.
193
9 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 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
194
9 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
195
9 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. Enter (on)line or $true to set it online or (off)line or $false to set it 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>
196
9 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/2010 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/2010 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
197
9 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.
198
9 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 GroupAddress 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 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
199
9 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
200
9 Schedule Cmdlets
Set-EqlSchedule cmdlet
Changes the schedule of the specified volume.
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 <DateTime>] [-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 GroupAddress parameter can be used to identify a group for this cmdlet.
201
9 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 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
202
9 Schedule Cmdlets
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 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>
203
9 Schedule Cmdlets
Default value?: none Accept pipeline input?: true Accept wildcard characters?: false Parameter: StartTime <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 Parameter: EndDate <DateTime>
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 snapshots created by the schedule are online or offline. Enter (on)line or $true to set it online or (off)line or $false to set it offline.
Required?: false Position?: named Default value?: offline Accept pipeline input?: true Accept wildcard characters?: false Parameter: AccessType <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>
204
9 Schedule Cmdlets
Changes whether the schedule is 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.
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 false 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.
205
9 Schedule Cmdlets
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 Get-EqlSchedule cmdlet Remove-EqlSchedule cmdlet
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>
206
9 Schedule Cmdlets
Specifies the name of a PS Series group for which a session exists in this PowerShell runspace. Either this parameter or the GroupAddress 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 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>]
207
9 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 deletes all of the schedules for the volume named MyVolume.
C:\PS>Remove-EqlSchedule -VolumeName MyVolume
Example 2 This command deletes the schedule named MySchedule from the volume named 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
208
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. 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.
209