Sdílet prostřednictvím


Set-SCStorageZone

Modifies an existing zone in a zone set.

Syntax

Default (Default)

Set-SCStorageZone
    [-StorageZone] <StorageZone>
    [-Name <String>]
    [-Description <String>]
    [-AddZoneAlias <StorageZoneAlias[]>]
    [-RemoveZoneAlias <StorageZoneAlias[]>]
    [-AddZoneMembership <String[]>]
    [-RemoveZoneMembership <String[]>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<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.

Parameter properties

Type:

StorageZoneAlias[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-AddZoneMembership

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

Parameter properties

Type:

String[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Description

Specifies a description of the storage zone.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-JobVariable

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

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Name

Specifies the name of the new storage zone.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments: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.

Parameter properties

Type:Guid
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-RemoveZoneAlias

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

Parameter properties

Type:

StorageZoneAlias[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-RemoveZoneMembership

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

Parameter properties

Type:

String[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-RunAsynchronously

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

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-StorageZone

Specifies a Fibre Channel zone in a zone set.

Parameter properties

Type:StorageZone
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:0
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Outputs

StorageZone

This cmdlet returns a StorageZone object.