Read-SCLibraryShare
更新儲存在程式庫共用中的 VMM 程式庫物件狀態和中繼資料。
Syntax
Read-SCLibraryShare
[-LibraryShare] <LibraryShare>
[-Path <String>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>]
Description
Read-SCLibraryShare Cmdlet 會更新儲存在指定程式庫共用中之所有 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 程式庫取得名為 AllVHDs 的程式庫共用物件,然後將物件儲存在$LibShare變數中。
第二個命令會更新存放於 $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 變數中。
第二個命令會更新存放於 $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 程式庫取得名為 AllVHDs 的程式庫共用物件,然後將物件儲存在$LibShare變數中。
第二個命令會在儲存在 $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 提示 (PRO 提示的識別碼) 。 此參數可讓您稽核 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
此 Cmdlet 會傳回 LibraryShare 物件。