Compartir a través de

Set-AzureRmVMChefExtension

  • Referencia
Módulo:
AzureRM.Compute

Agrega una extensión chef a una máquina virtual.

Advertencia

El módulo AzureRM PowerShell ha quedado oficialmente obsoleto a partir del 29 de febrero de 2024. Se recomienda a los usuarios migrar de AzureRM al módulo Az PowerShell para seguir recibiendo soporte técnico y actualizaciones.

Aunque el módulo AzureRM puede seguir funcionando, ya no recibirá mantenimiento ni soporte técnico, lo que significa que su uso continuado queda a discreción y riesgo del usuario. Consulte nuestros recursos de migración para ver una guía sobre la transición al módulo Az.

Sintaxis

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

El cmdlet Set-AzureVMChefExtension agrega la extensión Chef a la máquina virtual.

Ejemplos

Ejemplo 1: Agregar una extensión chef a una máquina virtual 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 agrega una extensión chef a una máquina virtual Windows denominada WindowsVM001. Cuando se inicia la máquina virtual, Chef arranca la máquina virtual para ejecutar Apache.

Ejemplo 2: Adición de una extensión chef a una 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 agrega una extensión chef a una máquina virtual Linux denominada LinuxVM001. Cuando se inicia la máquina virtual, Chef arranca la máquina virtual para ejecutar Apache.

Ejemplo 3: Adición de una extensión chef a una máquina virtual Windows con opciones de arranque

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 agrega la extensión Chef a una máquina virtual Windows denominada WindowsVM002. Cuando se inicia la máquina virtual, Chef arranca la máquina virtual para ejecutar Apache. Después del arranque, la máquina virtual hace referencia al bootstrapOptions especificado en formato JSON.

Parámetros

-AutoUpgradeMinorVersion

Tipo:Boolean
Posición:10
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-BootstrapOptions

Especifica los valores de configuración en la opción client_rb.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-BootstrapVersion

Especifica la versión de la configuración de arranque.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ChefDaemonInterval

Especifica la frecuencia (en minutos) en la que se ejecuta el servicio chef. Si en caso de que no desee que el chef-service se instale en la máquina virtual de Azure, establezca el valor como 0 en este campo.

Tipo:String
Alias:ChefServiceInterval
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ChefServerUrl

Especifica el vínculo del servidor chef, como una dirección URL.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ClientRb

Especifica la ruta de acceso completa del archivo client.rb de Chef.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Daemon

Configura el servicio chef-client para la ejecución desatendida. La plataforma del nodo debe ser Windows. Opciones permitidas: "none", "service" y "task". none: actualmente impide que el servicio chef-client se configure como servicio. service: configura el chef-client para que se ejecute automáticamente en segundo plano como servicio. task: configura el chef-client para que se ejecute automáticamente en segundo plano como una tarea programada.

Tipo:String
Valores aceptados:none, service, task
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.

Tipo:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-JsonAttribute

Cadena JSON que se va a agregar a la primera ejecución de chef-client. Por ejemplo, -JsonAttribute '{"foo" : "bar"}'

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Linux

Indica que este cmdlet crea una máquina virtual Windows.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Location

Especifica la ubicación de la máquina virtual.

Tipo:String
Posición:7
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Name

Especifica el nombre de la extensión Chef.

Tipo:String
Alias:ExtensionName
Posición:8
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-OrganizationName

Especifica el nombre de la organización de la extensión Chef.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ResourceGroupName

Especifica el nombre del grupo de recursos que contiene la máquina virtual.

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-RunList

Especifica la lista de ejecución del nodo chef.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Secret

Clave de cifrado que se usa para cifrar y descifrar los valores del elemento del contenedor de datos.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-SecretFile

Ruta de acceso al archivo que contiene la clave de cifrado utilizada para cifrar y descifrar los valores del elemento del contenedor de datos.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-TypeHandlerVersion

Especifica la versión de la extensión que se va a usar para esta máquina virtual.

Tipo:String
Alias:HandlerVersion, Version
Posición:9
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ValidationClientName

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ValidationPem

Especifica la ruta de acceso del archivo .pem del validador de Chef.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-VMName

Especifica el nombre de una máquina virtual. Este cmdlet agrega la extensión Chef para la máquina virtual que especifica este parámetro.

Tipo:String
Alias:ResourceName
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Windows

Indica que este cmdlet crea una máquina virtual Windows.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

String

Boolean

Salidas

PSAzureOperationResponse