Partilhar via


Set-AzureVMChefExtension

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

Nota

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

O módulo Az PowerShell é o módulo PowerShell recomendado 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 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;

Este comando adiciona uma extensão do Chef a uma máquina virtual do Windows. Quando a máquina virtual aparece, 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 bootstrapping

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;

Este comando adiciona a extensão 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;

Este comando adiciona a extensão 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 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;

Este comando adiciona a extensão 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 Chef.

Parâmetros

-BootstrapOptions

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

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

-BootstrapVersion

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

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 a URL do servidor Chef.

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

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

-InformationAction

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

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

  • Continuar
  • Ignorar
  • Informe-se
  • SilenciosamenteContinue
  • Parar
  • Suspender
Tipo:ActionPreference
Aliases:infa
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-InformationVariable

Especifica uma variável de informação.

Tipo:String
Aliases:iv
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 baseada em Linux.

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

-Profile

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

Tipo:AzureSMProfile
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
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

-ValidationClientName

Especifica o nome do cliente de validação.

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

-Version

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

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

-VM

Especifica o objeto de máquina virtual persistente.

Tipo:IPersistentVM
Aliases:InputObject
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
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