Set-AzureRmVMDscExtension

Módulo:

AzureRM.Compute

Configura la extensión DSC en 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-AzureRmVMDscExtension
   [-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>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

El cmdlet Set-AzureRmVMDscExtension 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

PS C:\> Set-AzureRmVMDscExtension -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-AzureRmVMDscConfiguration.

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

PS C:\> Set-AzureRmVMDscExtension -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-AzureRmVMDscConfiguration.

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

PS C:\> Set-AzureRmVMDscExtension -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-AzureRmVMDscConfiguration.

Parámetros

-ArchiveBlobName

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

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

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

-Force

Obliga al comando a ejecutarse sin solicitar la 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

-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-AzureRmVMDscExtension 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 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

-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-AzureRmVMDscExtension
• Remove-AzureRmVMDscExtension
• Publish-AzureRmVMDscConfiguration