Partilhar via


Set-AzVMChefExtension

Adiciona uma extensão do Chef a uma máquina virtual.

Sintaxe

Linux

Set-AzVMChefExtension
    [-ResourceGroupName] <String>
    [-VMName] <String>
    [[-TypeHandlerVersion] <String>]
    [[-Location] <String>]
    [[-Name] <String>]
    [[-AutoUpgradeMinorVersion] <Boolean>]
    -ValidationPem <String>
    [-ClientRb <String>]
    [-BootstrapOptions <String>]
    [-JsonAttribute <String>]
    [-ChefDaemonInterval <String>]
    [-Daemon <String>]
    [-Secret <String>]
    [-SecretFile <String>]
    [-RunList <String>]
    [-ChefServerUrl <String>]
    [-ValidationClientName <String>]
    [-OrganizationName <String>]
    [-BootstrapVersion <String>]
    [-Linux]
    [-NoWait]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Windows

Set-AzVMChefExtension
    [-ResourceGroupName] <String>
    [-VMName] <String>
    [[-TypeHandlerVersion] <String>]
    [[-Location] <String>]
    [[-Name] <String>]
    [[-AutoUpgradeMinorVersion] <Boolean>]
    -ValidationPem <String>
    [-ClientRb <String>]
    [-BootstrapOptions <String>]
    [-JsonAttribute <String>]
    [-ChefDaemonInterval <String>]
    [-Daemon <String>]
    [-Secret <String>]
    [-SecretFile <String>]
    [-RunList <String>]
    [-ChefServerUrl <String>]
    [-ValidationClientName <String>]
    [-OrganizationName <String>]
    [-BootstrapVersion <String>]
    [-Windows]
    [-NoWait]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

O cmdlet Set-AzVMChefExtension adiciona a extensão Chef à máquina virtual.

Exemplos

Exemplo 1: Adicionar uma extensão do Chef a uma máquina virtual Windows

Set-AzVMChefExtension -ResourceGroupName "ResourceGroup001" -VMName "WindowsVM001" -ValidationPem "C:\my-org-validator.pem" -ClientRb "C:\client.rb" -RunList "Apache" -Daemon "service" -SecretFile "C:\my_encrypted_data_bag_secret" -Windows

Este comando adiciona uma extensão Chef a uma máquina virtual Windows chamada WindowsVM001. Quando a máquina virtual é iniciada, o Chef inicializa a máquina virtual para executar o Apache.

Exemplo 2: Adicionar uma extensão do Chef a uma máquina virtual Linux

Set-AzVMChefExtension -ResourceGroupName "ResourceGroup002" -VMName "LinuxVM001" -ValidationPem "C:\my-org-validator.pem" -ClientRb "C:\client.rb" -RunList "Apache" -Secret "my_secret" -Linux

Este comando adiciona uma extensão do Chef a uma máquina virtual Linux chamada LinuxVM001. Quando a máquina virtual é iniciada, o Chef inicializa a máquina virtual para executar o Apache.

Exemplo 3: Adicionar uma extensão Chef a uma máquina virtual Windows com opções de bootstrap

Set-AzVMChefExtension -ResourceGroupName "ResourceGroup003" -VMName "WindowsVM002" -ValidationPem C:\my-org-validator.pem -ClientRb C:\client.rb -BootstrapOptions '{"chef_node_name":"your_node_name","chef_server_url":"https://api.opscode.com/organizations/some-org", "validation_client_name":"some-org-validator"}' -RunList "Apache" -Windows

Este comando adiciona a extensão Chef a uma máquina virtual Windows chamada WindowsVM002. Quando a máquina virtual é iniciada, o Chef inicializa a máquina virtual para executar o Apache. Após a inicialização, a máquina virtual refere-se às BootstrapOptions especificadas no formato JSON.

Parâmetros

-AutoUpgradeMinorVersion

O cmdlet Set-AzVMChefExtension adiciona a extensão Chef à máquina virtual.

Propriedades dos parâmetros

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

Conjuntos de parâmetros

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

-BootstrapOptions

Especifica as definições de configuração na opção client_rb.

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:True
Valor dos restantes argumentos:False

-BootstrapVersion

Especifica a versão da configuração de bootstrap.

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:True
Valor dos restantes argumentos:False

-ChefDaemonInterval

Especifica a frequência (em minutos) em que o serviço do chef é executado. Se não quiser que o chef-service esteja instalado na VM do Azure, defina o valor como 0 neste campo.

Propriedades dos parâmetros

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

Conjuntos de parâmetros

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

-ChefServerUrl

Especifica o link do servidor Chef, como uma URL.

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:True
Valor dos restantes argumentos:False

-ClientRb

Especifica o caminho completo do client.rb do Chef.

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:True
Valor dos restantes argumentos:False

-Confirm

Solicita confirmação antes de executar o cmdlet.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:False
Suporta carateres universais:False
NãoMostrar:False
Aliases:Cf.

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

-Daemon

Configura o serviço chef-client para execução autônoma. A plataforma de nós deve ser o Windows. Opções permitidas: 'nenhum', 'serviço' e 'tarefa'. none - Atualmente impede que o serviço chef-cliente seja configurado como um serviço. service - Configura o chef-client para ser executado automaticamente em segundo plano como um serviço. task - Configura o chef-client para ser executado automaticamente em segundo plano como uma tarefa agendada.

Propriedades dos parâmetros

Tipo:String
Default value:None
Valores aceites:none, service, task
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:True
Valor dos restantes argumentos:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure.

Propriedades dos parâmetros

Tipo:IAzureContextContainer
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:AzContext, AzureRmContext, AzureCredential

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

-JsonAttribute

Uma cadeia de caracteres JSON a ser adicionada à primeira execução de chef-client. por exemplo, -JsonAttribute '{"foo" : "bar"}'

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:True
Valor dos restantes argumentos:False

-Linux

Indica que este cmdlet cria uma máquina virtual Windows.

Propriedades dos parâmetros

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

Conjuntos de parâmetros

Linux
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Location

Especifica o local da máquina virtual.

Propriedades dos parâmetros

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

Conjuntos de parâmetros

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

-Name

Especifica o nome da extensão Chef.

Propriedades dos parâmetros

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

Conjuntos de parâmetros

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

-NoWait

Inicia a operação e retorna imediatamente, antes que a operação seja concluída. Para determinar se a operação foi concluída com êxito, use algum outro mecanismo.

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

-OrganizationName

Especifica o nome da organização da extensão Chef.

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:True
Valor dos restantes argumentos:False

-ResourceGroupName

Especifica o nome do grupo de recursos que contém a máquina virtual.

Propriedades dos parâmetros

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

Conjuntos de parâmetros

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

-RunList

Especifica a lista de execução do nó do Chef.

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:True
Valor dos restantes argumentos:False

-Secret

A chave de criptografia usada para criptografar e descriptografar os valores do item do pacote de dados.

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:True
Valor dos restantes argumentos:False

-SecretFile

O caminho para o arquivo que contém a chave de criptografia usada para criptografar e descriptografar os valores do item do pacote de dados.

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:True
Valor dos restantes argumentos:False

-TypeHandlerVersion

Especifica a versão da extensão a ser usada para essa máquina virtual.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:HandlerVersion, Versão

Conjuntos de parâmetros

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

-ValidationClientName

O cmdlet Set-AzVMChefExtension adiciona a extensão Chef à máquina virtual.

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:True
Valor dos restantes argumentos:False

-ValidationPem

Especifica o caminho do arquivo .pem do validador do Chef

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:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-VMName

Especifica o nome de uma máquina virtual. Este cmdlet adiciona a extensão Chef para a máquina virtual especificada por esse parâmetro.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:Nome do Recurso

Conjuntos de parâmetros

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

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Propriedades dos parâmetros

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

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

-Windows

Indica que este cmdlet cria uma máquina virtual Windows.

Propriedades dos parâmetros

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

Conjuntos de parâmetros

Windows
Position:Named
Obrigatório:True
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.

Entradas

String

Boolean

Saídas

PSAzureOperationResponse