Partilhar via

Add-SCApplicationHostTemplate

  • Referência
Módulo:
VirtualMachineManager

Adiciona um modelo de host de aplicativo a um modelo de serviço.

Sintaxe

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>]

Description

O cmdlet Add-SCApplicationHostTemplate adiciona um modelo de host de aplicativo a um modelo de serviço. Um modelo de host de aplicativo é usado para implantar um DAC (aplicativo da camada de dados) SQL em um servidor SQL implantado ou um pacote de Implantação da Web em um Host de Aplicativo Web com suporte.

Exemplos

Exemplo 1: Adicionar um modelo de host de aplicativo SQL a um modelo de serviço

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

O primeiro comando obtém o objeto de perfil de aplicação chamado SvcWebAppProfile01 e armazena o objeto na variável $AppProfile.

O segundo comando obtém o objeto temnplate de serviço chamado ServiceTemplate01 e armazena o objeto na variável $ServiceTemplate.

O terceiro comando adiciona um modelo de host de aplicativo ao modelo de serviço armazenado no $ServiceTemplate.

Exemplo 2: Adicionar um modelo de host de aplicativo Web a um modelo de serviço

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

O primeiro comando obtém o objeto de perfil de aplicação chamado WebAppProfile01 e armazena o objeto na variável $AppProfile.

O segundo comando obtém o objeto de modelo de serviço chamado ServiceTemplate01 e armazena o objeto na variável $ServiceTemplate.

O terceiro comando obtém o objeto Run As Account chamado IIS Site Admin e armazena o objeto na variável $WebRAA.

O último comando adiciona um modelo de host de aplicativo Web ao modelo de serviço armazenado no $ServiceTemplate (neste caso, ServiceTemplate01).

Parâmetros

-AllowUntrustedServerCertificate

Indica se a implantação pode continuar quando o servidor de implantação de destino apresentar um certificado de servidor não confiável. Esse parâmetro é usado em conjunto com um modelo de host de aplicativo Web.

Tipo:Boolean
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ApplicationProfile

Especifica um objeto de perfil de aplicativo.

Tipo:ApplicationProfile
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-AuthenticationType

Especifica o mecanismo de autenticação usado para facilitar a implantação de aplicativos Web associados ao modelo. Esse parâmetro é usado em conjunto com um modelo de host de aplicativo Web. Os valores válidos são: NTLM e Basic.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ComputerName

Especifica o nome de um computador que o Virtual Machine Manager (VMM) pode identificar exclusivamente na rede. Os formatos válidos são:

  • FQDN
  • Endereço IPv4 ou IPv6
  • Nome NetBIOS
Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DeploymentOrder

Especifica a ordem na qual uma camada de computador, host de aplicativo ou aplicativo é implantado.

Tipo:Int32
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Description

Especifica uma descrição para o modelo de host do aplicativo.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-JobVariable

Especifica que o progresso do trabalho é controlado e armazenado na variável nomeada por esse parâmetro.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Name

Especifica o nome de um objeto do VMM.

Tipo:String
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Port

Especifica a porta de rede a ser usada ao adicionar um objeto ou criar uma conexão. Os valores válidos são: 1 a 4095.

Tipo:Int32
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PROTipID

Especifica a ID da dica de Otimização de Desempenho e Recursos (dica PRO) que disparou essa ação. Este parâmetro permite auditar dicas PRO.

Tipo:Guid
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-RunAsAccount

Especifica uma conta Run As que contém credenciais com permissão para executar essa ação.

Tipo:VMMCredential
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-RunAsynchronously

Indica que o trabalho é executado de forma assíncrona para que o controle retorne ao shell de comando imediatamente.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ServiceTemplate

Especifica um objeto de modelo de serviço.

Tipo:ServiceTemplate
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ServicingOrder

Especifica a ordem na qual uma camada de computador ou host de aplicativo é atendido.

Tipo:Int32
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Site

Especifica o site no qual todos os pacotes de implantação da Web associados são implantados. Esse parâmetro é usado em conjunto com um modelo de host de aplicativo Web.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Tag

Especifica uma palavra ou frase a ser associada a um objeto para que você possa pesquisar todos os objetos com o conjunto especificado de tags. Pode procurar um subconjunto de etiquetas ou pode procurar o conjunto completo de etiquetas.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-WebApplicationHost

Especifica que o modelo de host de aplicativo é usado para um host de aplicativo Web.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Saídas

ApplicationHostTemplate

Este cmdlet retorna um objeto ApplicationHostTemplate.