Partilhar via

Set-SCApplicationHostTemplate

Módulo:
VirtualMachineManager Module

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

Sintaxe

Default (Predefinição) 

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.

Propriedades dos parâmetros

Tipo:Boolean
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ApplicationHostTemplate

Especifica um objeto de modelo de host de aplicativo.

Propriedades dos parâmetros

Tipo:ApplicationHostTemplate
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ApplicationProfile

Especifica um objeto de perfil de aplicativo.

Propriedades dos parâmetros

Tipo:ApplicationProfile
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-DeploymentOrder

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

Propriedades dos parâmetros

Tipo:Int32
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Description

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-JobVariable

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Name

Especifica o nome de um objeto do VMM.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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"

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:Int32
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:Guid
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-RunAsAccount

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

Propriedades dos parâmetros

Tipo:VMMCredential
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-RunAsynchronously

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ServicingOrder

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

Propriedades dos parâmetros

Tipo:Int32
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Saídas

ApplicationHostTemplate

Este cmdlet retorna um objeto ApplicationHostTemplate .