Compartilhar via


Set-AzureVMChefExtension

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

Observação

Os cmdlets referenciados nesta documentação são para gerenciar recursos herdados do Azure que usam APIs do Azure Service Manager (ASM). Este módulo herdado do PowerShell não é recomendado ao criar novos recursos, pois o ASM está agendado para desativação. Para obter mais informações, confira a desativação do Azure Service Manager.

O módulo do Az PowerShell é o módulo recomendado do PowerShell para gerenciar recursos do Azure Resource Manager (ARM) com o PowerShell.

Sintaxe

Set-AzureVMChefExtension
   [-Version <String>]
   -ValidationPem <String>
   [-ClientRb <String>]
   [-BootstrapOptions <String>]
   [-RunList <String>]
   [-JsonAttribute <String>]
   [-ChefDaemonInterval <String>]
   [-ChefServerUrl <String>]
   [-ValidationClientName <String>]
   [-OrganizationName <String>]
   [-BootstrapVersion <String>]
   [-Daemon <String>]
   [-Secret <String>]
   [-SecretFile <String>]
   [-Windows]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Set-AzureVMChefExtension
   [-Version <String>]
   -ValidationPem <String>
   [-ClientRb <String>]
   [-BootstrapOptions <String>]
   [-RunList <String>]
   [-JsonAttribute <String>]
   [-ChefDaemonInterval <String>]
   [-ChefServerUrl <String>]
   [-ValidationClientName <String>]
   [-OrganizationName <String>]
   [-BootstrapVersion <String>]
   [-Daemon <String>]
   [-Secret <String>]
   [-SecretFile <String>]
   [-Linux]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Description

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

Exemplos

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

PS C:\> Set-AzureVMChefExtension -VM $VM -ValidationPem "C:\\myorg-validator.pem" -ClientRb "C:\\client.rb" -RunList "Apache" -Windows;

Esse comando adiciona uma extensão do Chef a uma máquina virtual do Windows. Quando a máquina virtual é ativada, ela é inicializada com o Chef e executa o Apache nela.

Exemplo 2: Adicionar uma extensão do Chef a uma máquina virtual do Windows com inicialização

PS C:\> Set-AzureVMChefExtension -VM $VM -ValidationPem "C:\\myorg-validator.pem" -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;

Esse comando adiciona a extensão do Chef a uma máquina virtual do Windows. Quando a máquina virtual é iniciada, ela é inicializada com o Chef e executa o Apache nela. Após a inicialização, a máquina virtual refere-se às BootstrapOptions especificadas no formato JSON.

Exemplo 3: Adicionar uma extensão do Chef a uma máquina virtual do Windows e instalar o Apache e o GIT

PS C:\> Set-AzureVMChefExtension -VM $VM -ValidationPem "C:\\myorg-validator.pem" -ChefServerUrl "http://ipaddress:port" -ValidationClientName "MyOrg-Validator" -RunList "apache, git" -Windows;

Esse comando adiciona a extensão do Chef a uma máquina virtual do Windows. Quando a máquina virtual é iniciada, ela é inicializada com o Chef e tem o Apache e o GIT instalados. Se você não fornecer o client.rb, precisará fornecer a URL do servidor do Chef e o nome do cliente de validação.

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

PS C:\> Set-AzureVMChefExtension -VM $VM -ValidationPem "C:\\myorg-validator.pem" -ChefServerUrl "http://ipaddress:port" -OrganizationName "MyOrg" -Linux;

Esse comando adiciona a extensão do Chef a uma máquina virtual Linux. Quando a máquina virtual é iniciada, ela é inicializada com o Chef. Se você não fornecer o client.rb, precisará fornecer a URL e a organização do servidor do Chef.

Parâmetros

-BootstrapOptions

Especifica as opções de bootstrap no formato JavaScript Object Notation (JSON).

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-BootstrapVersion

Especifica a versão do cliente do Chef que é instalada junto com a extensão.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ChefDaemonInterval

Especifica a frequência (em minutos) com que o chef-service é executado. Caso você não queira que o chef-service seja instalado na VM do Azure, defina o valor como 0 neste campo.

Tipo:String
Aliases:ChefServiceInterval
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ChefServerUrl

Especifica a URL do servidor do Chef.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ClientRb

Especifica o caminho completo do client.rb do Chef.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Daemon

Configura o serviço chef-cliente para execução autônoma. A plataforma do nó deve ser Windows. Opções permitidas: 'nenhum', 'serviço' e 'tarefa'. none - Atualmente, impede que o serviço chef-client 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 sequenciada.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-InformationAction

Especifica como esse cmdlet responde a um evento de informação.

Os valores aceitáveis para esse parâmetro são:

  • Continuar
  • Ignorar
  • Perguntar
  • SilentlyContinue
  • Stop
  • Suspend
Tipo:ActionPreference
Aliases:infa
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InformationVariable

Especifica uma variável de informação.

Tipo:String
Aliases:iv
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-JsonAttribute

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Linux

Indica que esse cmdlet cria uma máquina virtual baseada em Linux.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-OrganizationName

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Profile

Especifica o perfil do Azure do qual esse cmdlet é lido. Se você não especificar um perfil, esse cmdlet lerá o perfil padrão local.

Tipo:AzureSMProfile
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RunList

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Secret

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-SecretFile

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ValidationClientName

Especifica o nome do cliente de validação.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ValidationPem

Especifica o caminho do arquivo .pem do validador do Chef.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Version

Especifica o número da versão da extensão do Chef.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-VM

Especifica o objeto de máquina virtual persistente.

Tipo:IPersistentVM
Aliases:InputObject
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Windows

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

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False