Set-AzVMDscExtension

Módulo:

Az.Compute

Configura la extensión DSC en una máquina virtual.

Sintaxis

Set-AzVMDscExtension
   [-ResourceGroupName] <String>
   [-VMName] <String>
   [-Name <String>]
   [-ArchiveBlobName] <String>
   [-ArchiveStorageAccountName] <String>
   [-ArchiveResourceGroupName <String>]
   [-ArchiveStorageEndpointSuffix <String>]
   [-ArchiveContainerName <String>]
   [-ConfigurationName <String>]
   [-ConfigurationArgument <Hashtable>]
   [-ConfigurationData <String>]
   [-Version] <String>
   [-Force]
   [-Location <String>]
   [-AutoUpdate]
   [-WmfVersion <String>]
   [-DataCollection <String>]
   [-NoWait]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

El cmdlet Set-AzVMDscExtension configura la extensión Desired State Configuration (DSC) de Windows PowerShell en una máquina virtual de un grupo de recursos.

Ejemplos

Ejemplo 1: Establecimiento de una extensión DSC

Set-AzVMDscExtension -ResourceGroupName "ResourceGroup001" -VMName "VM07" -ArchiveBlobName "Sample.ps1.zip" -ArchiveStorageAccountName "Stg" -ConfigurationName "ConfigName" -Version "1.10" -Location "West US"

Este comando establece la extensión DSC en la máquina virtual denominada VM07 para descargar Sample.ps1.zip de la cuenta de almacenamiento denominada Stg y el contenedor predeterminado. El comando invoca la configuración denominada ConfigName. El archivo Sample.ps1.zip se cargó anteriormente mediante Publish-AzVMDscConfiguration.

Ejemplo 2: Establecimiento de una extensión DSC con datos de configuración

Set-AzVMDscExtension -ResourceGroupName "ResourceGroup001" -VMName "VM13" -ArchiveBlobName "Sample.ps1.zip" -ArchiveStorageAccountName "Stg" -ConfigurationName "ConfigName" -ConfigurationArgument "@{arg="val"}" -ArchiveContainerName "WindowsPowerShellDSC" -ConfigurationData "SampleData.psd1" -Version "1.10" -Location "West US"

Este comando establece la extensión en la máquina virtual denominada VM13 para descargar Sample.ps1.zip de la cuenta de almacenamiento denominada Stg y el contenedor denominado WindowsPowerShellDSC. El comando la configuración denominada ConfigName y especifica los datos de configuración y los argumentos. El archivo Sample.ps1.zip se cargó anteriormente mediante Publish-AzVMDscConfiguration.

Ejemplo 3: Establecimiento de una extensión DSC con datos de configuración que tienen actualización automática

Set-AzVMDscExtension -ResourceGroupName "ResourceGroup001" -VMName "VM22" -ArchiveBlobName "Sample.ps1.zip" -ArchiveStorageAccountName "Stg" -ConfigurationName "ConfigName" -ConfigurationArgument "@{arg="val"}" -ArchiveContainerName WindowsPowerShellDSC -ConfigurationData "SampleData.psd1" -Version "1.10" -Location "West US" -AutoUpdate

Este comando establece la extensión en la máquina virtual denominada VM22 para descargar Sample.ps1.zip de la cuenta de almacenamiento denominada Stg y el contenedor denominado WindowsPowerShellDSC. El comando invoca la configuración denominada ConfigName y especifica los datos de configuración y los argumentos. Este comando también habilita la actualización automática del controlador de extensión a la versión más reciente. El Sample.ps1.zip se cargó anteriormente mediante Publish-AzVMDscConfiguration.

Parámetros

-ArchiveBlobName

Especifica el nombre del archivo de configuración que cargó anteriormente el cmdlet Publish-AzVMDscConfiguration.

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

-ArchiveContainerName

Nombre de especie del contenedor de Almacenamiento de Azure donde se encuentra el archivo de configuración.

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

-ArchiveResourceGroupName

Especifica el nombre del grupo de recursos que contiene la cuenta de almacenamiento que contiene el archivo de configuración. Este parámetro es opcional si la cuenta de almacenamiento y la máquina virtual están en el mismo grupo de recursos.

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

-ArchiveStorageAccountName

Especifica el nombre de la cuenta de almacenamiento de Azure que se usa para descargar ArchiveBlobName.

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

-ArchiveStorageEndpointSuffix

Especifica el sufijo del punto de conexión de almacenamiento.

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

-AutoUpdate

Especifica la versión del controlador de extensión especificada por el parámetro Version. De forma predeterminada, el controlador de extensión no está actualizado automáticamente. Use el parámetro AutoUpdate para habilitar la actualización automática del controlador de extensión a la versión más reciente como y cuando esté disponible.

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

-ConfigurationArgument

Especifica una tabla hash que contiene los argumentos de la función de configuración.

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

-ConfigurationData

Especifica la ruta de acceso de un archivo .psd1 que especifica los datos de la configuración.

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

-ConfigurationName

Especifica el nombre de la configuración a la que invoca la extensión DSC.

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

-Confirm

Le pide 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

-DataCollection

Especifica el tipo de recopilación de datos. Los valores aceptables para este parámetro son: Enable y Disable.

Tipo:	String
Valores aceptados:	Enable, Disable
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:	AzContext, AzureRmContext, AzureCredential
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Force

Obliga a que el comando se ejecute sin pedir confirmación del usuario.

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

-Location

Especifica la ruta de acceso de la extensión de recurso.

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

-Name

Especifica el nombre del recurso de Azure Resource Manager que representa la extensión. El valor predeterminado es Microsoft.Powershell.DSC.

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

-NoWait

Inicia la operación y vuelve inmediatamente antes de que se complete la operación. Para determinar si la operación se ha completado correctamente, use algún otro mecanismo.

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

-ResourceGroupName

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

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

-Version

Especifica la versión de la extensión DSC a la que Set-AzVMDscExtension aplica la configuración.

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

-VMName

Especifica el nombre de la máquina virtual donde está instalado el controlador de extensión DSC.

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

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. 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

-WmfVersion

Especifica la versión de WMF.

Tipo:	String
Valores aceptados:	4.0, 5.0, 5.1, latest
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

Entradas

String

Hashtable

Salidas

PSAzureOperationResponse

Vínculos relacionados

• Get-AzVMDscExtension
• Remove-AzVMDscExtension
• Publish-AzVMDscConfiguration