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 应用程序主机模板结合使用。

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 提示) 的性能和资源优化提示的 ID。 此参数允许审核 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

指示作业以异步方式运行,以便控件立即返回到命令 shell。

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 对象。