Read-SCLibraryShare

  • リファレンス
モジュール:
VirtualMachineManager

ライブラリ共有に格納されている VMM ライブラリ オブジェクトの状態とメタデータを更新します。

構文

Read-SCLibraryShare
    [-LibraryShare] <LibraryShare>
    [-Path <String>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

説明

Read-SCLibraryShare コマンドレットは、指定したライブラリ共有に格納されているすべての Virtual Machine Manager (VMM) ライブラリ オブジェクトの状態とメタデータを更新します。 この更新プログラムでは、指定したライブラリ共有の新しいライブラリ ファイルと、指定したライブラリ共有の下にある新しい子共有フォルダーも検索されます。

例

例 1: 指定したライブラリ共有を更新する

PS C:\> $LibShare = Get-SCLibraryShare -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -eq "AllVHDs" }
PS C:\> Read-SCLibraryShare -LibraryShare $LibShare

最初のコマンドは、VMMServer01 の VMM ライブラリから LibraryServer01 の AllVHDs という名前のライブラリ共有オブジェクトを取得し、そのオブジェクトを $LibShare 変数に格納します。

2 番目のコマンドは、$LibShare に保管されている共有内のすべてのライブラリ オブジェクトに関する状態とメタデータの情報を更新した後、共有内で見つかった新しいライブラリ オブジェクトを VMM ライブラリに追加します。

例 2: 複数のライブラリ共有を更新する

PS C:\> $LibShares = Get-SCLibraryShare -VMMServer "VMMServer1.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -match "vhd" }
PS C:\> $LibShares | Read-SCLibraryShare

最初のコマンドは、LibraryServer01 上のライブラリ共有オブジェクトとその名前に文字列 "vhd" を取得し、そのオブジェクトを $LibShares 変数に格納します。

2 番目のコマンドは、$LibShares に保管されているすべてのライブラリ共有の情報を更新した後、これらの共有で見つかった新しいライブラリ オブジェクトを VMM ライブラリに追加します。

例 3: ライブラリ共有の特定のサブディレクトリを更新する

PS C:\> $LibShare = Get-SCLibraryShare -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -eq "AllVHDs" }
PS C:\> Read-SCLibraryShare -LibraryShare $LibShare -Path "Production\WebFrontEnd"

最初のコマンドは、VMMServer01 の VMM ライブラリから LibraryServer01 の AllVHDs という名前のライブラリ共有オブジェクトを取得し、そのオブジェクトを $LibShare 変数に格納します。

2 番目のコマンドは、$LibShareに格納されているライブラリ共有上の指定されたサブディレクトリ内のすべてのライブラリ オブジェクトの状態とメタデータ情報を更新し、その共有内にある新しいライブラリ オブジェクトを VMM ライブラリに追加します。

パラメーター

-JobVariable

ジョブの進行状況を追跡して、このパラメーターで示す名前の変数に保管するように指定します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LibraryShare

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

Type:LibraryShare
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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\]"
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PROTipID

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

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAsynchronously

コントロールがコマンド シェルに直ちに戻るように、ジョブが非同期的に実行されることを示します。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

出力

LibraryShare

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