Partilhar via


Set-SCApplicationHostTemplate

Configura as propriedades de um modelo de host de aplicativo que foi adicionado a um modelo de serviço.

Sintaxe

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

O cmdlet Set-SCApplicationHostTemplate configura as propriedades de um modelo de host de aplicativo que foi adicionado a um modelo de serviço.

Exemplos

Exemplo 1: Alterar a descrição do modelo de host do aplicativo

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"

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

O segundo comando obtém o objeto de modelo de host de aplicativo para o modelo de serviço no $ServiceTemplate e armazena o objeto na variável $AppHostTemplate.

O último comando altera a propriedade description do modelo de host do aplicativo no $AppHostTemplate.

Exemplo 2: Alterar o nome de um modelo de host de aplicativo

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"

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

O segundo comando obtém o objeto de modelo de host do aplicativo para o modelo de serviço armazenado no $ServiceTemplate e armazena o objeto na variável $AppHostTemplate.

O último comando altera a propriedade name do modelo de host do aplicativo armazenado no $AppHostTemplate. Como o modelo de host de aplicativo é clonado no modelo de serviço, renomear o modelo de host de aplicativo não afeta outros modelos de serviço no sistema.

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

-ApplicationHostTemplate

Especifica um objeto de modelo de host de aplicativo.

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

-ApplicationProfile

Especifica um objeto de perfil de aplicativo.

Tipo:ApplicationProfile
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
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:False
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:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Owner

Especifica o proprietário de um objeto do VMM na forma de uma conta de usuário de domínio válida.

  • Exemplo de formato: -Owner "Contoso\PattiFuller"
  • Exemplo de formato: -Owner "PattiFuller@Contoso"
Tipo:String
Position:Named
Default value:None
Necessário:False
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:False
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

-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:False
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

Saídas

ApplicationHostTemplate

Este cmdlet retorna um objeto ApplicationHostTemplate.