Partilhar via

Set-AzureRmVMChefExtension

  • Referência
Módulo:
AzureRM.Compute

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

Aviso

O módulo AzureRM do PowerShell foi oficialmente preterido a partir de 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo Az PowerShell para garantir suporte e atualizações contínuos.

Embora o módulo AzureRM ainda possa funcionar, ele não é mais mantido ou suportado, colocando qualquer uso continuado a critério e risco do usuário. Consulte nossos recursos de migração para obter orientação sobre a transição para o módulo Az.

Sintaxe

Set-AzureRmVMChefExtension
   [-ResourceGroupName] <String>
   [-VMName] <String>
   [[-TypeHandlerVersion] <String>]
   -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]
   [[-Location] <String>]
   [[-Name] <String>]
   [[-AutoUpgradeMinorVersion] <Boolean>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzureRmVMChefExtension
   [-ResourceGroupName] <String>
   [-VMName] <String>
   [[-TypeHandlerVersion] <String>]
   -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]
   [[-Location] <String>]
   [[-Name] <String>]
   [[-AutoUpgradeMinorVersion] <Boolean>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

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

Exemplos

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

PS C:\> Set-AzureRmVMChefExtension -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 do Chef a uma máquina virtual do 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

PS C:\> Set-AzureRmVMChefExtension -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 do Chef a uma máquina virtual do Windows com opções de bootstrap

PS C:\> Set-AzureRmVMChefExtension -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 do 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

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

-BootstrapOptions

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

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

-BootstrapVersion

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

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

-ChefDaemonInterval

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

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

-ChefServerUrl

Especifica o link do servidor Chef, como uma URL.

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

-ClientRb

Especifica o caminho completo do client.rb do Chef.

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

-Confirm

Solicita a sua confirmação antes de executar o cmdlet.

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

-Daemon

Configura o serviço chef-client para execução autônoma. A plataforma do nó 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 sequedulada.

Tipo:String
Valores aceites:none, service, task
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-JsonAttribute

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

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

-Linux

Indica que esse cmdlet cria uma máquina virtual do Windows.

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

-Location

Especifica o local da máquina virtual.

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

-Name

Especifica o nome da extensão Chef.

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

-OrganizationName

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

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

-ResourceGroupName

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

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

-RunList

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

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

-Secret

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

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

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

-TypeHandlerVersion

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

Tipo:String
Aliases:HandlerVersion, Version
Position:9
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ValidationClientName

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

-ValidationPem

Especifica o caminho do arquivo .pem do validador do Chef

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

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

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

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

-Windows

Indica que esse cmdlet cria uma máquina virtual do Windows.

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

Entradas

String

Boolean

Saídas

PSAzureOperationResponse