Add-SCLibraryShare
將文件庫伺服器的檔案系統上的 Windows 共用新增至 VMM 程式庫作為程式庫共用。
Syntax
Add-SCLibraryShare
[-VMMServer <ServerConnection>]
[-SharePath] <String>
[-Credential <PSCredential>]
[-Description <String>]
[-AddDefaultResources]
[-JobGroup <Guid>]
[-UseAlternateDataStream <Boolean>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>] Description
Add-SCLibraryShare Cmdlet 會將程式庫伺服器的檔案系統上的 Windows 共用新增至 Virtual Machine Manager (VMM) 程式庫作為程式庫共用。
您必須先在 Windows 檔案系統中建立共用，才能新增程式庫共用至 VMM 程式庫。 例如，您可以使用 Windows 檔案總管建立並共用您要新增至程式庫的資料夾。
如果您在與預設程式庫共用相同的層級建立 Windows 共用， (MSSCVMMLibrary) VMM 安裝程式或個別的程式庫伺服器上建立，請使用 Add-SCLibraryShare Cmdlet 將該共用新增至 VMM 程式庫。
如果您在預設 VMM 程式庫共用底下建立 Windows 資料夾， (MSSCVMMLibrary) ，VMM 會自動掃描共用、探索儲存在該共用上且符合程式庫物件資格的所有現有物件，並將程式庫物件新增至程式庫。 不過，您可以使用 Read-SCLibraryShare Cmdlet 手動重新整理該共用，並將其內容匯入 VMM 程式庫。
注意：只有程式庫重新整理程式才能探索的程式庫資源，但系統管理員不會包含虛擬硬碟 (Windows 型 .vhd 檔案， Citrix XenServer 型 .vhd 檔案或 VMware 型 .vmdk 檔案) 、虛擬磁片 (Windows 型 .vfd 檔案或 VMware 型 .flp 檔案) 、ISO 映像 (.iso 檔案) 和腳本。
範例
範例 1：將 Windows 共用新增為程式庫共用物件至 VMM 程式庫
PS C:\> Get-SCVMMServer -ComputerName "VMMServer01.Contoso.com"
PS C:\> Add-SCLibraryShare -SharePath "\\LibraryServer01\AllVHDs"第一個命令會連線到 VMMServer01。
第二個命令會將程式庫共用物件新增至名為 AllVHDs 的程式庫， (位於 LibraryServer01) 上的 Windows 共用。 此範例假設 LibraryServer01 已經是 VMM 程式庫伺服器。
範例 2：將兩個 Windows 共用新增為程式庫共用物件至 VMM 程式庫
PS C:\> Get-SCVMMServer -ComputerName "VMMServer01.Contoso.com"
PS C:\> $SharePaths = "\\LibraryServer01\AllVHDs", "\\LibraryServer01\AllISOs"
PS C:\> ForEach($SharePath in $SharePaths) { Add-SCLibraryShare -SharePath $SharePath }第一個命令會連線至 VMMServer1。
第二個命令會將字串 「\LibraryServer01\AllVHDs」 和 「\LibraryServer01\AllSOs」 儲存在 $SharePaths 變數中。 此範例假設 LibraryServer01 已經是 VMM 程式庫伺服器。
最後一個命令會使用 ForEach 迴圈，將儲存在 $SharePaths 中的兩個共用名稱稱傳遞至 Add-SCLibraryShare Cmdlet，以程式庫共用的形式將每個 Windows 共用新增至 VMM。
注意：如需標準Windows PowerShell ForEach迴圈語句的詳細資訊，請輸入 Get-Help about_ForEach 。
ForEach迴圈語句與使用ForEach作為別名的 ForEach-Object Cmdlet 不同。
參數
-AddDefaultResources
指出已新增程式庫共用的預設資源。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Credential
指定認證物件，或針對某些 Cmdlet 指定執行身分帳戶物件，其中包含有權執行此動作之帳戶的使用者名稱和密碼。 或者，如果是 Restart-SCJob，則有權完成重新開機的工作。
如需 PSCredential 物件的詳細資訊，請輸入 Get-Help Get-Credential 。
如需執行身分帳戶的詳細資訊，請輸入 Get-Help New-SCRunAsAccount 。
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
指定程式庫共用的描述。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobGroup
指定一系列命令的識別碼，這些命令會在執行包含相同工作群組識別碼的最終命令之前，使用整組的方式來執行。
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
指定追蹤工作進度，並將工作進度存放在這個參數命名的變數中。
| 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 |
-SharePath
使用通用命名慣例 (UNC) 路徑格式，指定現有程式庫伺服器上有效程式庫共用的路徑。
範例格式： -SharePath "\\LibServer01\LibShare"
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UseAlternateDataStream
指定是否要使用 Use AlternateDataStream。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMMServer
指定 VMM 伺服器物件。
| Type: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
輸出
LibraryShare
此 Cmdlet 會傳回 LibraryShare 物件。