Set-SCApplicationHostTemplate
配置已添加到服务模板的应用程序主机模板的属性。
语法
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>] 说明
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 应用程序主机模板结合使用。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ApplicationHostTemplate
指定应用程序主机模板对象。
| 类型: | ApplicationHostTemplate |
| Position: | 0 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-ApplicationProfile
指定应用程序配置文件对象。
| 类型: | ApplicationProfile |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-AuthenticationType
指定用于促进部署与模板关联的 Web 应用程序的身份验证机制。 此参数与 Web 应用程序主机模板结合使用。 有效值为：NTLM 和 Basic。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ComputerName
指定 Virtual Machine Manager （VMM） 可以在网络上唯一标识的计算机的名称。 有效格式为：
- FQDN
- IPv4 或 IPv6 地址
- NetBIOS 名称
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-DeploymentOrder
指定计算机层、应用程序主机或应用程序部署的顺序。
| 类型: | Int32 |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Description
指定应用程序主机模板的说明。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | 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 |
-Port
指定在添加对象或创建连接时要使用的网络端口。 有效值为：1 到 4095。
| 类型: | Int32 |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-PROTipID
指定触发此操作的性能和资源优化提示（PRO 提示）的 ID。 此参数允许你审核 PRO 提示。
| 类型: | Guid |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-RunAsAccount
指定包含具有执行此操作权限的凭据的运行方式帐户。
| 类型: | VMMCredential |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-RunAsynchronously
指示作业以异步方式运行，以便控件立即返回到命令行界面。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ServicingOrder
指定计算机层或应用程序主机的服务顺序。
| 类型: | Int32 |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Site
指定将任何关联的 Web 部署包部署到的网站。 此参数与 Web 应用程序主机模板结合使用。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Tag
指定要与对象关联的单词或短语，以便可以搜索具有指定标记集的所有对象。 可以搜索标记的子集，也可以搜索完整的标记集。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
输出
ApplicationHostTemplate
此 cmdlet 返回 ApplicationHostTemplate 对象。