New-VolumeMapping
SYNOPSIS
Creates a new mapping between a volume and a host or host group on the PowerStore cluster.
SYNTAX
ByVolumeNameHostName (Default)
New-VolumeMapping [-Cluster] <Cluster> -VolumeName <String> -HostName <String> [-Lun <Int32>] [-Confirm] [-WhatIf] [<CommonParameters>]
ByVolumeNameHostId
New-VolumeMapping [-Cluster] <Cluster> -VolumeName <String> -HostId <String> [-Lun <Int32>] [-Confirm] [-WhatIf] [<CommonParameters>]
ByVolumeNameHostGroupName
New-VolumeMapping [-Cluster] <Cluster> -VolumeName <String> -HostGroupName <String> [-Lun <Int32>] [-Confirm] [-WhatIf] [<CommonParameters>]
ByVolumeNameHostGroupId
New-VolumeMapping [-Cluster] <Cluster> -VolumeName <String> -HostGroupId <String> [-Lun <Int32>] [-Confirm] [-WhatIf] [<CommonParameters>]
ByVolumeIdHostName
New-VolumeMapping [-Cluster] <Cluster> -VolumeId <String> -HostName <String> [-Lun <Int32>] [-Confirm] [-WhatIf] [<CommonParameters>]
ByVolumeIdHostId
New-VolumeMapping [-Cluster] <Cluster> -VolumeId <String> -HostId <String> [-Lun <Int32>] [-Confirm] [-WhatIf] [<CommonParameters>]
ByVolumeIdHostGroupName
New-VolumeMapping [-Cluster] <Cluster> -VolumeId <String> -HostGroupName <String> [-Lun <Int32>] [-Confirm] [-WhatIf] [<CommonParameters>]
ByVolumeIdHostGroupId
New-VolumeMapping [-Cluster] <Cluster> -VolumeId <String> -HostGroupId <String> [-Lun <Int32>] [-Confirm] [-WhatIf] [<CommonParameters>]
DESCRIPTION
Creates a new mapping between a volume and a host or host group on the PowerStore cluster.
EXAMPLES
Example 1
PS C:\> New-VolumeMapping -Cluster $cluster -VolumeId vid1 -HostId hid1
Where $cluster is a PowerStore cluster instance. Creates a new mapping between volume with Id vid1 and host with Id hid1.
Example 2
PS C:\> New-VolumeMapping -Cluster $cluster -VolumeName volume1 -HostId hid1 -Lun 2
Where $cluster is a PowerStore cluster instance. Creates a new mapping between volume volume1 and host with Id hid1 with LUN value 2.
Example 3
PS C:\> New-VolumeMapping -Cluster $cluster -VolumeName volume1 -HostName host1
Where $cluster is a PowerStore cluster instance. Creates a new mapping between volume volume1 and host host1.
Example 4
PS C:\> New-VolumeMapping -Cluster $cluster -VolumeName volume1 -HostGroupName hostgroup1 -Lun 10
Where $cluster is a PowerStore cluster instance. Creates a new mapping between volume volume1 and host group hostgroup1 with LUN value 10.
PARAMETERS
-Cluster
A PowerStore cluster instance.
Type: Cluster
Parameter Sets: (All)
Aliases:
Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-VolumeName
Volume name.
Type: String
Parameter Sets: ByVolumeNameHostId, ByVolumeNameHostName, ByVolumeNameHostGroupId, ByVolumeNameHostGroupName
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-VolumeId
Volume Id.
Type: String
Parameter Sets: ByVolumeIdHostId, ByVolumeIdHostName, ByVolumeIdHostGroupId, ByVolumeIdHostGroupName
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-HostName
Host name.
Type: String
Parameter Sets: ByVolumeIdHostName, ByVolumeNameHostName
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-HostId
Host Id.
Type: String
Parameter Sets: ByVolumeIdHostId, ByVolumeNameHostId
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-HostGroupName
Host group name.
Type: String
Parameter Sets: ByVolumeIdHostGroupName, ByVolumeNameHostGroupName
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-HostGroupId
Host group Id.
Type: String
Parameter Sets: ByVolumeIdHostGroupId, ByVolumeNameHostGroupId
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Lun
Logical unit number.
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Confirm
Prompts you for confirmation before running the cmdlet.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.