SCVMM 2016 UR5 で利用可能なコマンドレット (Unregister-SCStorageLogicalUnit) について

System Center 2016 – Virtual Machine Manager (SCVMM 2016) に触れる機会が多くなり、Virtual Machine Manager Command Shell を使った設定や、情報取得、および管理することが増えてきたので、備忘録として各コマンドレットの概要を日本語化 (意訳) しました。

ここでは Unregister-SCStorageLogicalUnit コマンドレットのヘルプ情報について、SCVMM2016 UR5 の Virtual Machine Manager Command Shell 上で「Unregister-SCStorageLogicalUnit」コマンドレットの -Full オプションを用いて実行した結果を元に記載しています。
※SCVMM 2016 UR5 で利用可能なコマンドレット一覧については、「System Center 2016 – Virtual Machine Manager で利用できるコマンドレットについて」を参照。

Unregister-SCStorageLogicalUnit コマンドレット

名前

Unregister-SCStorageLogicalUnit

概要

ホストから論理ユニットとの関連付けを解除します。

構文

Unregister-SCStorageLogicalUnit  [-StorageLogicalUnit] <StorageLogicalUnit[]>  -JobGroup <Guid>  [-JobVariable <String>]  [-PROTipID <Guid>]  [-RunAsynchronously]  [<CommonParameters>] Unregister-SCStorageLogicalUnit  [-StorageLogicalUnit] <StorageLogicalUnit[]>  [-JobGroup <Guid>]  [-JobVariable <String>]  [-PROTipID <Guid>]  [-RunAsynchronously]  -VMHost <Host>  [<CommonParameters>] Unregister-SCStorageLogicalUnit  [-StorageLogicalUnit] <StorageLogicalUnit[]>  [-JobGroup <Guid>]  [-JobVariable <String>]  [-PROTipID <Guid>]  [-RemoveVM <VM>]  [-RunAsynchronously]  -VM <VM[]>  [<CommonParameters>] Unregister-SCStorageLogicalUnit  [-StorageLogicalUnit] <StorageLogicalUnit[]>  [-JobGroup <Guid>]  [-JobVariable <String>]  [-PROTipID <Guid>]  [-RunAsynchronously]  -StorageFileServer <StorageFileServer>  [<CommonParameters>] Unregister-SCStorageLogicalUnit  [-StorageLogicalUnit] <StorageLogicalUnit[]>  [-JobVariable <String>]  [-PROTipID <Guid>]  [-RunAsynchronously]  -StorageInitiators <String[]>  [<CommonParameters>] Unregister-SCStorageLogicalUnit  [-StorageLogicalUnit] <StorageLogicalUnit[]>  [-JobVariable <String>]  [-PROTipID <Guid>]  [-RunAsynchronously]  -VMHostCluster <HostCluster>  [<CommonParameters>]

説明

Unregister-SCStorageLogicalUnit コマンドレットは、ホストから論理ユニットとの関連付けを解除します。

パラメーター

-JobGroup <Guid>

同じジョブ グループ識別子を含む最後のコマンドが実行される直前に、一連のコマンドを実行する一連のコマンドの識別子を指定します。

必須	true
位置	named
既定値	None
パイプライン入力を許可する	False
ワイルドカード文字を許可する	false

-JobVariable <String>

ジョブの進行状況を追跡し、このパラメーターで指定された変数に格納する場合に指定します。

必須	false
位置	named
既定値	None
パイプライン入力を許可する	False
ワイルドカード文字を許可する	false

-PROTipID <Guid>

このアクションにトリガーされるパフォーマンスとリソースの最適化のヒント (PRO ヒント) を指定します。このパラメーターは、PRO ヒントを監査することができます。

必須	false
位置	named
既定値	None
パイプライン入力を許可する	False
ワイルドカード文字を許可する	false

-RemoveVM <VM>

削除する仮想マシン オブジェクトを指定します。

必須	false
位置	named
既定値	None
パイプライン入力を許可する	False
ワイルドカード文字を許可する	false

-RunAsynchronously [<SwitchParameter>]

ジョブが非同期で実行、制御がすぐにコマンド シェルに戻されるかどうかを指定します。

必須	false
位置	named
既定値	None
パイプライン入力を許可する	False
ワイルドカード文字を許可する	false

-StorageFileServer <StorageFileServer>

記憶域ファイル サーバー オブジェクトを指定します。

必須	true
位置	named
既定値	None
パイプライン入力を許可する	False
ワイルドカード文字を許可する	false

-StorageInitiators <String[]>

記憶域イニシエーター アレイを指定します。

必須	false
位置	named
既定値	None
パイプライン入力を許可する	False
ワイルドカード文字を許可する	false

-StorageLogicalUnit <StorageLogicalUnit[]>

記憶域論理ユニット オブジェクトを指定します。

必須	true
位置	0
既定値	None
パイプライン入力を許可する	True (ByValue)
ワイルドカード文字を許可する	false

-VM <VM[]>

仮想マシン オブジェクトの配列を指定します。

必須	true
位置	named
既定値	None
パイプライン入力を許可する	False
ワイルドカード文字を許可する	false

-VMHost <Host>

仮想マシン ホスト オブジェクトを指定します。VMM は、Hyper-V ホスト、VMware ESX ホスト、および Citrix XenServer ホストをサポートします。

各ホストの種類に関する情報について、Add-SCVMHost コマンドレットを参照してください。

必須	true
位置	named
既定値	None
パイプライン入力を許可する	False
ワイルドカード文字を許可する	false

-VMHostCluster <HostCluster>

VMM ホスト クラスター オブジェクトを指定します。

必須	true
位置	named
既定値	None
パイプライン入力を許可する	False
ワイルドカード文字を許可する	false

<CommonParameters>

このコマンドレットは、次の共通パラメーターをサポートします: Verbose、Debug、ErrorAction、ErrorVariable、WarningAction、WarningVariable、OutBuffer, PipelineVariable、および OutVariable。詳細については、about_CommonParameters を参照してください。

入力

出力

メモ

例

例 1 : ホストから論理ユニットを隠す

コマンド

$VMHost = Get-SCVMHost -ComputerName "VMHost01"
$LU = Get-SCStorageLogicalUnit -Name "LUN01"
Unregister-SCStorageLogicalUnit -StorageLogicalUnit $LU -VMHost $VMHost

コマンドの説明

最初のコマンドは、ホスト オブジェクト “VMHost01” を取得し、そのオブジェクトに $VMHost 変数を格納します。

2 番目のコマンドは、記憶域論理ユニット オブジェクト “LUN01” を取得し、そのオブジェクトを $LU 変数に格納します。

最後のコマンドは、VMHost01 から LUN01 との関連付けを解除します。

関連するリンク

• Get-SCStorageLogicalUnit
• Get-SCVMHost
• New-SCStorageLogicalUnit
• Register-SCStorageLogicalUnit
• Remove-SCStorageLogicalUnit
• Set-SCStorageLogicalUnit

参考

• System Center 2016 – データセンターの管理 | Microsoft
  https://www.microsoft.com/ja-jp/cloud-platform/system-center
• VirtualMachineManager | Microsoft Docs
  https://docs.microsoft.com/en-us/powershell/module/virtualmachinemanager/?view=systemcenter-ps-2016
• Unregister-SCStorageLogicalUnit (VirtualMachineManager) | Microsoft Docs
  https://docs.microsoft.com/en-us/powershell/module/virtualmachinemanager/unregister-scstoragelogicalunit?view=systemcenter-ps-2016