Add-SCApplicationHostTemplate

将应用程序主机模板添加到服务模板。

语法

Add-SCApplicationHostTemplate
   [-DeploymentOrder <Int32>]
   [-ServicingOrder <Int32>]
   [-Name] <String>
   [-Description <String>]
   [-Tag <String>]
   -ComputerName <String>
   -ApplicationProfile <ApplicationProfile>
   -ServiceTemplate <ServiceTemplate>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Add-SCApplicationHostTemplate
   [-DeploymentOrder <Int32>]
   [-ServicingOrder <Int32>]
   [-Port <Int32>]
   [-AllowUntrustedServerCertificate <Boolean>]
   -RunAsAccount <VMMCredential>
   [-WebApplicationHost]
   [-Name] <String>
   [-Description <String>]
   [-Tag <String>]
   -ComputerName <String>
   -Site <String>
   [-AuthenticationType <String>]
   -ApplicationProfile <ApplicationProfile>
   -ServiceTemplate <ServiceTemplate>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

说明

Add-SCApplicationHostTemplate cmdlet,将应用程序主机模板添加到服务模板。 应用程序主机模板用于在已部署的 SQL Server 或 Web 部署包上将 SQL 数据层应用程序(DAC)部署到受支持的 Web 应用程序主机。

示例

示例 1:将 SQL 应用程序主机模板添加到服务模板

PS C:\> $AppProfile = Get-SCApplicationProfile -Name "SvcWebAppProfile01"
PS C:\> $ServiceTemplate = Get-SCServiceTemplate -Name "ServiceTemplate01"
PS C:\> Add-SCApplicationHostTemplate -Name "SQL Application Host" -ComputerName "SQLServer01.Contoso.com" -ApplicationProfile $AppProfile -ServiceTemplate $ServiceTemplate

第一个命令获取名为 SvcWebAppProfile01 的顶点配置文件对象,并将对象存储在$AppProfile变量中。

第二个命令获取名为 ServiceTemplate01 的服务图腾板对象,并将对象存储在$ServiceTemplate变量中。

第三个命令将应用程序主机模板添加到存储在$ServiceTemplate的服务模板。

示例 2:将 Web 应用程序主机模板添加到服务模板

PS C:\> $AppProfile = Get-SCApplicationProfile -Name "WebAppProfile01"
PS C:\> $ServiceTemplate = Get-SCServiceTemplate -Name "ServiceTemplate01"
PS C:\> $WebRAA = Get-SCRunAsAccount -Name "IIS Site Admin"
PS C:\> $WebAppHostTemplate = Add-SCApplicationHostTemplate -Name "Web Farm" -ServiceTemplate $ServiceTemplate -ApplicationProfile -$AppProfile -ComputerName "@Web Server@" -DeploymentOrder 2 -WebAppHost -Port 8172 -Site "Default Web Site" -AuthenticationType "NTLM" -AllowUntrustedServerCertificate -RunAsAccount $WebRAA

第一个命令获取名为 WebAppProfile01 的顶点配置文件对象,并将对象存储在$AppProfile变量中。

第二个命令获取名为 ServiceTemplate01 的服务模板对象,并将对象存储在$ServiceTemplate变量中。

第三个命令获取名为 IIS 站点管理员的运行方式帐户对象,并将该对象存储在$WebRAA变量中。

最后一个命令将 Web 应用程序主机模板添加到存储在$ServiceTemplate的服务模板(在本例中为 ServiceTemplate01)。

参数

-AllowUntrustedServerCertificate

指示当目标部署服务器提供不受信任的服务器证书时,部署是否可以继续。 此参数与 Web 应用程序主机模板结合使用。

类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ApplicationProfile

指定应用程序配置文件对象。

类型:ApplicationProfile
Position:Named
默认值:None
必需:True
接受管道输入:True
接受通配符: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
必需:True
接受管道输入: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:0
默认值:None
必需:True
接受管道输入: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
必需:True
接受管道输入:False
接受通配符:False

-RunAsynchronously

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

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ServiceTemplate

指定服务模板对象。

类型:ServiceTemplate
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-ServicingOrder

指定计算机层或应用程序主机的服务顺序。

类型:Int32
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Site

指定将任何关联的 Web 部署包部署到的网站。 此参数与 Web 应用程序主机模板结合使用。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-Tag

指定要与对象关联的单词或短语,以便可以搜索具有指定标记集的所有对象。 可以搜索标记的子集,也可以搜索完整的标记集。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-WebApplicationHost

指定应用程序主机模板用于 Web 应用程序主机。

类型:SwitchParameter
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

输出

ApplicationHostTemplate

此 cmdlet 返回 ApplicationHostTemplate 对象。