Get-SCDirectoryChildItem
指定したディレクトリ内のすべてのファイルとサブディレクトリを、仮想マシン ホスト上または VMM で管理されているライブラリ サーバー上で取得します。
構文
Get-SCDirectoryChildItem
-VMHost <Host>
-Path <String>
[<CommonParameters>]
Get-SCDirectoryChildItem
-LibraryServer <LibraryServer>
-Path <String>
[<CommonParameters>]
説明
Get-SCDirectoryChildItem コマンドレットは、仮想マシン ホストまたは Virtual Machine Manager (VMM) によって管理されているライブラリ サーバー上の指定されたディレクトリのすぐ下にあるすべてのファイルとサブディレクトリを取得します。 共有パス (\ServerName\ShareName\Directory\FileName など) を指定すると、共有パスのサブディレクトリが返されます。
Get-SCDirectoryChildItem コマンドレットを使用してライブラリ サーバー上のファイルとサブディレクトリを取得する場合は、有効なライブラリ共有へのパスを指定する必要があります。 たとえば、VMM を初めてインストールするときにセットアップによってインストールされる既定のライブラリ共有への共有パスは、\VMMServerName.DomainName.com\MSSCVMMLibrary です。
例
例 1: VMM ホスト上の指定したパスのファイルとサブディレクトリを取得する
PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01"
PS C:\> Get-SCDirectoryChildItem -VMHost $VMHost -Path "C:\"
最初のコマンドは、VMM データベースから VMHost01 という名前のホスト オブジェクトを取得し、そのオブジェクトを $VMHost 変数に格納します。
2 番目のコマンドは、VMHost01 の C:\ ドライブのすぐ下に、各ファイルとサブディレクトリに関する名前とその他の情報を表示します。
例 2: ライブラリ サーバー上の指定したパスのサブディレクトリを取得する
PS C:\> $LibServ = Get-SCLibraryServer -VMMServer "VMMServer01.Contoso.com" -ComputerName "FileServer01.Contoso.com"
PS C:\> Get-SCDirectoryChildItem -LibraryServer $LibServ -Path "\\FileServer01.Contoso.com\MSSCVMMLibrary"
最初のコマンドは、VMMServer01 から FileServer01 という名前のライブラリ サーバー オブジェクトを取得し、$LibServ変数にオブジェクトを格納します。
2 番目のコマンドは、FileServer01 の既定のライブラリ共有のディレクトリに格納されている各ファイルに関する名前、親ディレクトリ、およびその他の情報を表示します。 ライブラリ共有への完全なパスを指定する必要があります。
注: この例では、既定の VMM ライブラリ共有 (MSSCVMMLibrary) が環境内で使用されていることを前提としています。
ライブラリ共有の名前を取得するには、「Get-SCLibraryShare | Select Name
」と入力します。
パラメーター
-LibraryServer
VMM ライブラリ サーバー オブジェクトを指定します。
型: | LibraryServer |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Path
操作の宛先パスを指定します。
形式の例:
- ローカル パス:
-Path "F:\"
- UNC パス:
-Path "\\Library\Templates"
- ボリューム GUID パス:
-Path "\\?\Volume{4703c1ea-8ae7-11db-b473-00123f7603e3}\"
- VMware ESX パス:
-Path "\[storage1\]\MyVMwareFolderForVMs\MyVM.vmx"
- Citrix XenServer パス:
-Path "Local storage\[99b6212f-b63d-c676-25f9-d6c460992de7\]"
このパラメーターは、UNC パスのワイルドカード文字を受け入れます。
形式の例:
UNC パス: -Path "\\VMHostServer\MyVMs\*VM*"
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-VMHost
仮想マシン ホスト オブジェクトを指定します。 VMM では、Hyper-V ホスト、VMware ESX ホスト、Citrix XenServer ホストがサポートされます。
ホストの各種類の詳細については、Add-SCVMHost コマンドレットを参照してください。
型: | Host |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
出力
VMHostFileInformation
このコマンドレットは、VMHostFileInformation オブジェクトを返します。