Set-SCStorageZone

Modifies an existing zone in a zone set.

Syntax

Set-SCStorageZone [-StorageZone] <StorageZone> [-AddZoneAlias <StorageZoneAlias[]>]
 [-AddZoneMembership <String[]>] [-Description <String>] [-JobVariable <String>] [-Name <String>]
 [-PROTipID <Guid>] [-RemoveZoneAlias <StorageZoneAlias[]>] [-RemoveZoneMembership <String[]>]
 [-RunAsynchronously] [<CommonParameters>]

Description

The Set-SCStorageZone cmdlet modifies an existing zone in a zone set.

Examples

Example 1: Modify an existing zone

PS C:\> $Zone = Get-SCStorageZone -Name "Zone01"
PS C:\> $Alias = Get-SCStorageZoneAlias -Name "MyArrayPorts"
PS C:\> $Members = @()
PS C:\> $Members += "D113ED3B8A310220"
PS C:\> $Members += "C003FF3B8A610000"
PS C:\> Set-SCStorageZone -StorageZone $Zone -Description "Update zone for vm host" -AddZoneMembership $Members -RemoveZoneAlias $Alias

The first command gets the zone object named Zone01, and stores that object in the $Zone variable.

The second command gets the storage zone alias named MyArrayPorts, and stores the object in the $Alias variable.

The third command creates an array named $Members. The fourth and fifth commands populate the $Members array.

The last command adds a description and members to the zone stored in $Zone. The command removes the specified aliases.

Parameters

-AddZoneAlias

Specifies an array of zone aliases that represents one or more world-wide port names. To obtain a StorageZoneAlias object, use the Get-SCStorageZoneAlias cmdlet.

Type:StorageZoneAlias[]
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-AddZoneMembership

Specifies an array of zone members for this cmdlet to add.

Type:String[]
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Description

Specifies a description of the storage zone.

Type:String
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-JobVariable

Specifies the name of a variable that you use to track and store job progress.

Type:String
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Name

Specifies the name of the new storage zone.

Type:String
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PROTipID

Specifies the ID of the Performance and Resource Optimization tip (PRO tip) that triggered this action. This parameter lets you audit PRO tips.

Type:Guid
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-RemoveZoneAlias

Specifies an array of storage zone aliases for this cmdlet to remove.

Type:StorageZoneAlias[]
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-RemoveZoneMembership

Specifies an array of zone members for this cmdlet to remove.

Type:String[]
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-RunAsynchronously

Indicates that the job runs asynchronously so that control returns to the command shell immediately.

Type:SwitchParameter
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-StorageZone

Specifies a Fibre Channel zone in a zone set.

Type:StorageZone
Required:True
Position:0
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False

Outputs

StorageZone

This cmdlet returns a **StorageZone** object.