New-SCStorageZoneAlias

Creates a Fibre Channel zone alias.

Syntax

New-SCStorageZoneAlias
   [-StorageFabric] <StorageFabric>
   -Name <String>
   [-Description <String>]
   [-AddZoneMembership <String[]>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

The New-SCStorageZoneAlias cmdlet creates a Fibre Channel zone alias.

Examples

Example 1: Create a Fibre Channel zone alias

PS C:\> $Fabric = Get-SCStorageFabric -Name "PROD"
PS C:\> $Members = @()
PS C:\> $Members += "C003FF3B8A610000"
PS C:\> $Members += "D113EF3A8F411234"
PS C:\> New-SCStorageZoneAlias -StorageFabric $Fabric -Name "ZoneAlias01" -Description "" -AddZoneMembership $Members

The first command gets the storage fabric object named PROD, and then stores that object in the $Fabric variable.

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

The last command creates a zone alias named ZoneAlias01 for the members stored in $Members.

Required Parameters

-Name

Specifies the name of the new Fibre Channel zone alias.

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

Specifies a storage Fibre Channel fabric object.

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

Optional Parameters

-AddZoneMembership

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

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

Specifies a description of the new zone alias.

Type:String
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
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
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
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Outputs

StorageZoneAlias

This cmdlet returns a StorageZoneAlias object.