Add-VirtualDiskToMaskingSet

Add-VirtualDiskToMaskingSet

Adds a virtual disk to a specified masking set and grants access to the virtual disk to all initiator IDs defined in the masking set.

構文

Parameter Set: ByFriendlyName
Add-VirtualDiskToMaskingSet [-MaskingSetFriendlyName] <String[]> [-AsJob] [-CimSession <CimSession[]> ] [-DeviceAccesses <DeviceAccess[]> ] [-DeviceNumbers <UInt16[]> ] [-PassThru] [-ThrottleLimit <Int32> ] [-VirtualDisknames <String[]> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: ByUniqueId
Add-VirtualDiskToMaskingSet -MaskingSetUniqueId <String[]> [-AsJob] [-CimSession <CimSession[]> ] [-DeviceAccesses <DeviceAccess[]> ] [-DeviceNumbers <UInt16[]> ] [-PassThru] [-ThrottleLimit <Int32> ] [-VirtualDisknames <String[]> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: InputObject (cdxml)
Add-VirtualDiskToMaskingSet -InputObject <CimInstance[]> [-AsJob] [-CimSession <CimSession[]> ] [-DeviceAccesses <DeviceAccess[]> ] [-DeviceNumbers <UInt16[]> ] [-PassThru] [-ThrottleLimit <Int32> ] [-VirtualDisknames <String[]> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

詳細説明

The Add-VirtualDiskToMaskingSet cmdlet adds a virtual disk to a specified masking set and grants access to the virtual disk to all initiator IDs defined in the masking set.

パラメーター

-AsJob

-CimSession<CimSession[]>

リモート セッションまたはリモート コンピューターでコマンドレットを実行します。New-CimSession コマンドレットや Get-CimSession コマンドレットの出力など、コンピューター名またはセッション オブジェクトを入力します。既定値は、ローカル コンピューターで実行中の現在のセッションです。

-DeviceAccesses<DeviceAccess[]>

Specifies the way in which initiators can access the virtual disk(s) that are part of this masking set. You must specify a DeviceAccesses value for each virtual disk specified by the VirtualDiskNames parameter. Allowed values are NoAccess, ReadOnly, ReadWrite, and Unknown

-DeviceNumbers<UInt16[]>

Specifies the device numbers for one or more virtual disks.

-InputObject<CimInstance[]>

Specifies the MaskingSet object to which you want to a virtual disk. Specify a MaskingSet CIM object, which are output by the Get-MaskingSet and New-MaskingSet cmdlets.

-MaskingSetFriendlyName<String[]>

Specifies the friendly name of the masking set to which you want to add a virtual disk.

-MaskingSetUniqueId<String[]>

Specifies an UniqueID of the masking set to which you want to add a virtual disk.

-PassThru

Specifies that the cmdlet should output an object representing the masking set to which it added a virtual disk. By default, this cmdlet does not generate any output.

-ThrottleLimit<Int32>

このコマンドレットを実行するために確立できる最大同時操作数を指定します。このパラメーターを省略するか、値として 0 を入力した場合、Windows PowerShell® では、コンピューターで実行している CIM コマンドレットの数に基づいて、コマンドレットに対する最適なスロットル制限を計算します。スロットル制限は現在のコマンドレットのみに適用され、セッションまたはコンピューターには適用されません。

-VirtualDisknames<String[]>

Specifies one or more virtual disk names that are to be added to the masking set.

-Confirm

コマンドレットを実行する前に、ユーザーに確認を求めます。

-WhatIf

コマンドレットを実行するとどのような結果になるかを表示します。コマンドレットは実行されません。

<CommonParameters>

このコマンドレットは次の共通パラメーターをサポートします。-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、-OutVariable.詳細については、以下を参照してください。 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。

入力

入力型は、コマンドレットにパイプできるオブジェクトの型です。

• Microsoft.Management.Infrastructure.CimInstance#ROOT/Microsoft/Windows/Storage/MSFT_MaskingSet

  You can pipe a MaskingSet object to the InputObject parameter.

出力

出力型は、コマンドレットによって生成されるオブジェクトの型です。

• Microsoft.Management.Infrastructure.CimInstance#ROOT/Microsoft/Windows/Storage/MSFT_MaskingSet

  If you specify the Passthru parameter, this cmdlet outputs an object that represents the masking set to which you added a virtual disk.

注

• Microsoft.Management.Infrastructure.CimInstance オブジェクトは、Windows Management Instrumentation (WMI) オブジェクトを表示するラッパー クラスです。シャープ記号 (#) の後のパスは、基になる WMI オブジェクトの名前空間とクラス名です。

例

Example 1: Add a virtual disk to an existing masking set

This example adds the virtual disks named Volume12 to a masking set named Cluster1MaskingSet, and sets the device access to read-write.

PS C:\> $maskingSet = Get-MaskingSet Cluster1MaskingSet
PS C:\> $virtualDisk = Get-VirtualDisk Volume12
PS C:\> $maskingSet | Add-VirtualDiskToMaskingSet -VirtualDisknames $virtualDisk.Name -DeviceAccesses ReadWrite

関連トピック

Get-MaskingSet

Get-VirtualDisk