Set-SCApplicationPackage
修改應用程式封裝的屬性。
語法
Set-SCApplicationPackage
[-UserRole <UserRole>]
[-Enabled <Boolean>]
[-VMMServer <ServerConnection>]
[-ApplicationPackage] <ApplicationPackage[]>
[-EncryptionKey <PSCredential>]
[-Name <String>]
[-SharePath <String>]
[-Description <String>]
[-Owner <String>]
[-FamilyName <String>]
[-Release <String>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>] Set-SCApplicationPackage
[-VMMServer <ServerConnection>]
[-ApplicationPackage] <ApplicationPackage[]>
[-SetAsEquivalent]
-FamilyName <String>
-Release <String>
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>] Description
Set-SCApplicationPackage Cmdlet 會修改儲存在 Virtual Machine Manager （VMM） 連結庫中的應用程式套件屬性。
範例
範例 1：更新應用程式套件的描述
PS C:\> $AppPackage = Get-SCApplicationPackage -Name "WebApp01.zip"
PS C:\> Set-SCApplicationPackage -ApplicationPackage $AppPackage -Description "Web application to install on a service."第一個命令會取得名為 WebApp01.zip 的應用程式封裝物件，並將物件儲存在$AppPackage變數中。
第二個命令會更新 WebApp01.zip的描述。
參數
-ApplicationPackage
指定應用程式封裝物件的陣列。
| 類型: | ApplicationPackage[] |
| Position: | 0 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Description
指出指定之物件的描述。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Enabled
當設定為 $True 時啟用 物件，或在設定為 $False 時停用物件。 例如，如果您想要升級虛擬機範本上的軟體，您可以停用 VMM 連結庫中的範本物件，暫時防止使用者使用該物件。
| 類型: | Boolean |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-EncryptionKey
指定當您將位於周邊網路 Hyper-V 主機新增至 VMM 時，要當做加密金鑰使用的認證。
範例格式：-SecurityFile "C:\SecurityFile.txt" -EncryptionKey $Key
| 類型: | PSCredential |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-FamilyName
指定 VMM 連結庫中實體資源的系列名稱。 此值會與 Release、Namespace 和 Type 搭配使用，以在連結庫資源之間建立等價。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-JobVariable
指定作業進度會追蹤並儲存在此參數所命名的變數中。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Name
指定 VMM 物件的名稱。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Owner
以有效網域用戶帳戶的形式指定 VMM 對象的擁有者。
- 範例格式：
-Owner "Contoso\PattiFuller" - 範例格式：
-Owner "PattiFuller@Contoso"
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-PROTipID
指定觸發此動作之效能和資源優化提示 （PRO 提示） 的識別碼。 此參數可讓您稽核 PRO 秘訣。
| 類型: | Guid |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Release
指定描述連結庫資源發行的字串。 VMM 會自動為匯入連結庫的每個資源建立發行值。 匯入資源之後，即可自定義字串。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-RunAsynchronously
表示作業會以異步方式執行，讓控件立即返回命令殼層。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-SetAsEquivalent
指出 Cmdlet 會將多個應用程式套件標示為對等專案。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-SharePath
指定現有連結庫伺服器上使用通用命名約定 （UNC） 路徑的有效連結庫共享路徑。
範例格式：-SharePath "\\LibServer01\LibShare"
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-UserRole
指定使用者角色物件。
| 類型: | UserRole |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-VMMServer
指定 VMM 伺服器物件。
| 類型: | ServerConnection |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
輸出
ApplicationPackage
此 Cmdlet 會傳回 ApplicationPackage 物件。