New-SCStorageZoneAlias

Creates a Fibre Channel zone alias.

Syntax

New-SCStorageZoneAlias [-StorageFabric] <StorageFabric> [-AddZoneMembership <String[]>] [-Description <String>]
 [-JobVariable <String>] -Name <String> [-PROTipID <Guid>] [-RunAsynchronously] [<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.

Parameters

-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 new zone alias.

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 Fibre Channel zone alias.

Type:String
Required:True
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
-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
-StorageFabric

Specifies a storage Fibre Channel fabric object.

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

Outputs

StorageZoneAlias

This cmdlet returns a **StorageZoneAlias** object.