Set-SCApplicationPackage
修改應用程式封裝的屬性。
Syntax
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
指定應用程式封裝物件的陣列。
| Type: | ApplicationPackage[] |
| 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 |
-EncryptionKey
指定當您將位於周邊網路中 Hyper-V 主機的 Hyper-V 主機新增至 VMM 時，要用來作為加密金鑰的認證。
範例格式： -SecurityFile "C:\SecurityFile.txt" -EncryptionKey $Key
| Type: | PSCredential |
| 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 秘訣。
| 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 |
輸出
ApplicationPackage
此 Cmdlet 會傳回 ApplicationPackage 物件。