Set-AzVMDscExtension
Configura la extensión DSC en una máquina virtual.
Syntax
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.
Type: | String |
Aliases: | ConfigurationArchiveBlob |
Position: | 5 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ArchiveContainerName
Nombre de especie del contenedor de Almacenamiento de Azure donde se encuentra el archivo de configuración.
Type: | String |
Aliases: | ContainerName |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ArchiveStorageAccountName
Especifica el nombre de la cuenta de almacenamiento de Azure que se usa para descargar ArchiveBlobName.
Type: | String |
Aliases: | StorageAccountName |
Position: | 4 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ArchiveStorageEndpointSuffix
Especifica el sufijo del punto de conexión de almacenamiento.
Type: | String |
Aliases: | StorageEndpointSuffix |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ConfigurationArgument
Especifica una tabla hash que contiene los argumentos de la función de configuración.
Type: | Hashtable |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ConfigurationData
Especifica la ruta de acceso de un archivo .psd1 que especifica los datos de la configuración.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ConfigurationName
Especifica el nombre de la configuración a la que invoca la extensión DSC.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Confirm
Le solicita su confirmación antes de ejecutar el cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DataCollection
Especifica el tipo de recopilación de datos. Los valores aceptables para este parámetro son: Enable y Disable.
Type: | String |
Accepted values: | Enable, Disable |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DefaultProfile
Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.
Type: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Obliga al comando a ejecutarse sin solicitar la confirmación del usuario.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Location
Especifica la ruta de acceso de la extensión de recurso.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Especifica el nombre del recurso de Azure Resource Manager que representa la extensión. El valor predeterminado es Microsoft.Powershell.DSC.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceGroupName
Especifica el nombre del grupo de recursos de la máquina virtual.
Type: | String |
Position: | 2 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Version
Especifica la versión de la extensión DSC a la que Set-AzVMDscExtension aplica la configuración.
Type: | String |
Aliases: | HandlerVersion |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-VMName
Especifica el nombre de la máquina virtual donde está instalado el controlador de extensión DSC.
Type: | String |
Position: | 3 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WmfVersion
Especifica la versión de WMF.
Type: | String |
Accepted values: | 4.0, 5.0, 5.1, latest |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Entradas
Salidas
Vínculos relacionados
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de