Set-SCApplicationHostTemplate

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

Syntax

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 em $ServiceTemplate e armazena o objeto na variável $AppHostTemplate.

O último comando altera a propriedade de descrição do modelo de host do aplicativo em $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 de aplicativo para o modelo de serviço armazenado em $ServiceTemplate e armazena o objeto na variável $AppHostTemplate.

O último comando altera a propriedade de nome do modelo de host do aplicativo armazenado em $AppHostTemplate. Como o modelo de host de aplicativo é clonado no modelo de serviço, renomear o modelo de host do 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 do Aplicativo Web.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ApplicationHostTemplate

Especifica um objeto de modelo de host de aplicativo.

Type:ApplicationHostTemplate
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ApplicationProfile

Especifica um objeto de perfil de aplicativo.

Type:ApplicationProfile
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 do Aplicativo Web. Os valores válidos são: NTLM e Basic.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ComputerName

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

  • FQDN
  • Endereço IPv4 ou IPv6
  • Nome NetBIOS
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DeploymentOrder

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JobVariable

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Especifica o nome de um objeto do VMM.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Owner

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

  • Formato de exemplo: -Owner "Contoso\PattiFuller"
  • Formato de exemplo: -Owner "PattiFuller@Contoso"
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PROTipID

Especifica a ID da dica de Desempenho e Otimização de Recursos (dica PRO) que disparou essa ação. Esse parâmetro permite que você audite dicas pro.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAsAccount

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

Type:VMMCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAsynchronously

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ServicingOrder

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 do Aplicativo Web.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Tag

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Saídas

ApplicationHostTemplate

Este cmdlet retorna um objeto ApplicationHostTemplate .