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 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:	AzContext, 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

-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 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-AzVMDscExtension
• Remove-AzVMDscExtension
• Publish-AzVMDscConfiguration