Set-SCApplicationHostTemplate
設定已新增至服務範本的應用程式主機範本屬性。
Syntax
Set-SCApplicationHostTemplate
[-DeploymentOrder <Int32>]
[-ServicingOrder <Int32>]
[-Port <Int32>]
[-AllowUntrustedServerCertificate <Boolean>]
[-RunAsAccount <VMMCredential>]
[-ApplicationHostTemplate] <ApplicationHostTemplate>
[-Name <String>]
[-Description <String>]
[-Owner <String>]
[-Tag <String>]
[-ComputerName <String>]
[-Site <String>]
[-AuthenticationType <String>]
[-ApplicationProfile <ApplicationProfile>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>] Description
Set-SCApplicationHostTemplate Cmdlet 會設定已新增至服務範本的應用程式主機範本屬性。
範例
範例 1：變更應用程式主機範本的描述
PS C:\> $ServiceTemplate = Get-SCServiceTemplate -Name "ServiceTemplate01"
PS C:\> $AppHostTemplate = Get-SCApplicationHostTemplate -ServiceTemplate $ServiceTemplate
PS C:\> Set-SCApplicationHostTemplate -ApplicationHostTemplate $AppHostTemplate -Description "This is the updated description"第一個命令會取得名為 ServiceTemplate01 的服務範本物件，並將物件儲存在$ServiceTemplate變數中。
第二個命令會取得$ServiceTemplate中服務範本的應用程式主機範本物件，並將物件儲存在$AppHostTemplate變數中。
最後一個命令會在 $AppHostTemplate 中變更應用程式主機範本的描述屬性。
範例 2：變更應用程式主機範本的名稱
PS C:\> $ServiceTemplate = Get-SCServiceTemplate -Name "ServiceTemplate01"
PS C:\> $AppHostTemplate = Get-SCApplicationHostTemplate -ServiceTemplate $ServiceTemplate
PS C:\> Set-SCApplicationHostTemplate -ApplicationHostTemplate $AppHostTemplate -Name "This is the updated name"第一個命令會取得名為 ServiceTemplate01 的服務範本物件，並將物件儲存在$ServiceTemplate變數中。
第二個命令會取得儲存在 $ServiceTemplate 中的服務範本的應用程式主機範本物件，並將物件儲存在$AppHostTemplate變數中。
最後一個命令會變更儲存在 $AppHostTemplate 的應用程式主機範本名稱屬性。 因為應用程式主機範本會複製到服務範本中，所以重新命名應用程式主機範本不會影響系統中的其他服務範本。
參數
-AllowUntrustedServerCertificate
指出當目標部署伺服器呈現不受信任的伺服器憑證時，部署是否可繼續進行。 此參數會與 Web 應用程式主機範本搭配使用。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ApplicationHostTemplate
指定應用程式主機範本物件。
| Type: | ApplicationHostTemplate |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ApplicationProfile
指定應用程式佈建檔物件。
| Type: | ApplicationProfile |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AuthenticationType
指定用來協助部署與範本相關聯之 Web 應用程式的驗證機制。 此參數會與 Web 應用程式主機範本搭配使用。 有效值為：NTLM 和 Basic。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ComputerName
指定 Virtual Machine Manager (VMM) 可在網路上唯一識別的電腦名稱稱。 有效的格式如下：
- FQDN
- IPv4 或 IPv6 位址
- NetBIOS 名稱
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DeploymentOrder
指定部署電腦層、應用程式主機或應用程式的順序。
| Type: | Int32 |
| 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 |
-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 |
-Port
指定新增物件或建立連接時要使用的網路埠。 有效值為：1 到 4095。
| Type: | Int32 |
| 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 |
-RunAsAccount
指定執行身分帳戶，其中包含具有執行此動作許可權的認證。
| Type: | VMMCredential |
| 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 |
-ServicingOrder
指定服務電腦層或應用程式主機的順序。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Site
指定部署任何相關聯 Web 部署套件的網站。 此參數會與 Web 應用程式主機範本搭配使用。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Tag
指定要與物件建立關聯的單字或片語，以便搜尋具有指定標記集的所有物件。 您可以搜尋標籤的子集，也可以搜尋完整的標記集。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
輸出
ApplicationHostTemplate
此 Cmdlet 會傳回 ApplicationHostTemplate 物件。