Set-SCCustomResource
設定自訂資源的屬性。
Syntax
Set-SCCustomResource
[-UserRole <UserRole>]
[-Enabled <Boolean>]
[-VMMServer <ServerConnection>]
[-CustomResource] <CustomResource[]>
[-Name <String>]
[-SharePath <String>]
[-Description <String>]
[-Owner <String>]
[-FamilyName <String>]
[-Release <String>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>]
Set-SCCustomResource
[-VMMServer <ServerConnection>]
[-CustomResource] <CustomResource[]>
[-SetAsEquivalent]
-FamilyName <String>
-Release <String>
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>]
Description
Set-SCCustomResource Cmdlet 會設定自訂資源的屬性。 自訂資源是 Virtual Machine Manager 中的資料夾型程式庫物件, (VMM) 。 資源會在資料夾層級宣告,而 VMM 未知資料夾的內容。
若要將自訂資源新增至 VMM 程式庫,請使用 建立資料夾。CR 延伸模組、將內容放在資料夾中,然後使用 VMM 主控台將資料夾拖曳至 VMM 程式庫共用。 VMM 會探索並將資料夾匯入 VMM 程式庫作為自訂資源。
範例
範例 1:變更自訂資源的描述和發行
PS C:\> $CR = Get-SCCustomResource -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -eq "Folder.CR" -and $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" }
PS C:\> Set-SCCustomResource -CustomResource $CR -Release "v1.1" -Description "My LOB Application version 1.1 Install Package"
第一個命令會從 VMMServer01 上的 VMM 程式庫取得名為 Folder.CR 的自訂資源物件Server01,然後將物件儲存在 $CR 變數中。
第二個命令會變更儲存在 $CR 中之自訂資源物件的 Release 和 Description 屬性的值。
參數
-CustomResource
指定自訂資源物件的陣列。
Type: | CustomResource[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Description
指定自訂資源的描述。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Enabled
在設定為 $True 時啟用 物件,或在設定為 $False 時停用 物件。 例如,如果您想升級虛擬機器範本的軟體時,您可以停用 VMM 程式庫的範本物件,暫時禁止使用者使用該物件。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FamilyName
指定 VMM 程式庫中實體資源的系列名稱。 此值會與 Release、 Namespace和 Type 搭配使用,以在程式庫資源之間建立相等性。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
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 |
-Name
指定 VMM 物件的名稱。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Owner
以有效網域使用者帳戶的格式指定 VMM 物件的擁有者。
- 範例格式:
-Owner "Contoso\PattiFuller"
- 範例格式:
-Owner "PattiFuller@Contoso"
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 |
-Release
指定描述程式庫資源發行的字串。 VMM 會自動為每個匯入至程式庫的資源建立發行值。 匯入資源之後,即可自訂字串。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
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 |
-SetAsEquivalent
表示 Cmdlet 會將多個自訂資源標示為對等專案。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SharePath
使用通用命名慣例 (UNC) 路徑格式,指定現有程式庫伺服器上有效程式庫共用的路徑。
範例格式: -SharePath "\\LibServer01\LibShare"
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserRole
指定使用者角色物件。
Type: | UserRole |
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 |
輸出
CustomResource
此 Cmdlet 會傳回 CustomResource 物件。