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

スポンサーリンク
Microsoft Public Affiliate Program (JP)(マイクロソフトアフィリエイトプログラム)

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

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

Get-SCDependentLibraryResource コマンドレット

名前

Get-SCDependentLibraryResource

概要

VMM オブジェクト間の依存関係を識別します。

構文

Get-SCDependentLibraryResource
 [-LibraryResource] <LibObjectBase>
 [-OnBehalfOfUser <String>]
 [-OnBehalfOfUserRole <UserRole>]
 [-VMMServer <ServerConnection>]
 [<CommonParameters>]

Get-SCDependentLibraryResource
 [-LibraryServer] <LibraryServer>
 [-OnBehalfOfUser <String>]
 [-OnBehalfOfUserRole <UserRole>]
 [-VMMServer <ServerConnection>]
 [<CommonParameters>]

Get-SCDependentLibraryResource
 [-LibraryShare] <LibraryShare>
 [-OnBehalfOfUser <String>]
 [-OnBehalfOfUserRole <UserRole>]
 [-VMMServer <ServerConnection>]
 [<CommonParameters>]

説明

Get-SCDependentLibraryResource コマンドレットは、Virtual Machine Manager (VMM) オブジェクト間の依存関係を識別します。

Get-SCDependentLibraryResource コマンドレットを使用して、次の存在に依存するオブジェクトを識別することが可能です :

  • 指定したライブラリ オブジェクト
  • 指定したライブラリ共有上のオブジェクト
  • 指定したライブラリサーバー上のオブジェクト

パラメーター

-LibraryResource <LibObjectBase>

VMM ライブラリに格納されたリソースを指定します。

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

-LibraryServer <LibraryServer>

VMM ライブラリ サーバー オブジェクトを指定します。

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

-LibraryShare <LibraryShare>

VMM ライブラリ共有オブジェクトを指定します。

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

-OnBehalfOfUser <String>

ユーザー名を指定します。このコマンドレットは、このパラメーターが指定するユーザーの代わりに操作します。

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

-OnBehalfOfUserRole <UserRole>

ユーザー ロールを指定します。ユーザー ロールを取得するには、Get-SCUserRole コマンドレットを用います。このコマンドレットは、このパラメーターで指定するユーザー ロールの代わりに操作します。

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

-VMMServer <ServerConnection>

VMM サーバー オブジェクトを取得します。

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

<CommonParameters>

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

入力

出力

  • HardwareProfile
    • このコマンドレットは、HardwareProfile オブジェクトを返します。

メモ

例 1 : 特定の仮想ハード ディスクに依存するすべてのオブジェクトを検索する

コマンド
$VHD = Get-SCVirtualHardDisk -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -eq "VHD01" -and $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" }
Get-SCDependentLibraryResource -LibraryResource $VHD
コマンドの説明

最初のコマンドは、”VMMServer01.Contoso.com” 上の VMM ライブラリから “LibraryServer01.Contoso.com” のハード ディスク オブジェクト “VHD01” を取得し、そのオブジェクトを $VHD 変数を格納します。この例は、VHD01 という仮想ハード ディスクが 1 つしか存在しないことを前提としています。

2 番目のコマンドは、VHD01 に依存するすべてのライブラリ オブジェクトを返します。

依存オブジェクトが存在する場合、この仮想ハード ディスクを削除すると、削除された仮想ハード ディスクを参照しないよう、依存オブジェクトが変更されます。したがって、VHD01 が特定の仮想マシン、もしくは特定のテンプレートに関連付けられている場合、その仮想マシンもしくはテンプレートは VHD01 が削除された後で VHD01 を参照しなくなるように変更されます。

関連するリンク

  • Get-SCVirtualHardDisk

参考