Publish-AzVMDscConfiguration

  • Referencia
Módulo:
Az.Compute

Carga un script de DSC en Azure Blob Storage.

Syntax

Publish-AzVMDscConfiguration
       [-ResourceGroupName] <String>
       [-ConfigurationPath] <String>
       [[-ContainerName] <String>]
       [-StorageAccountName] <String>
       [-StorageEndpointSuffix <String>]
       [-Force]
       [-SkipDependencyDetection]
       [-ConfigurationDataPath <String>]
       [-AdditionalPath <String[]>]
       [-DefaultProfile <IAzureContextContainer>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Publish-AzVMDscConfiguration
       [-ConfigurationPath] <String>
       [[-OutputArchivePath] <String>]
       [-Force]
       [-SkipDependencyDetection]
       [-ConfigurationDataPath <String>]
       [-AdditionalPath <String[]>]
       [-DefaultProfile <IAzureContextContainer>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

El cmdlet Publish-AzVMDscConfiguration carga un script desired State Configuration (DSC) en Azure Blob Storage, que posteriormente se puede aplicar a máquinas virtuales de Azure mediante el cmdlet Set-AzVMDscExtension.

Ejemplos

Ejemplo 1: Creación de un paquete de .zip carga en Azure Storage

Publish-AzVMDscConfiguration ".\MyConfiguration.ps1"

Este comando crea un paquete de .zip para el script dado y los módulos de recursos dependientes y los carga en Azure Storage.

Ejemplo 2: Crear un paquete de .zip y almacenarlo en un archivo local

Publish-AzVMDscConfiguration ".\MyConfiguration.ps1" -OutputArchivePath ".\MyConfiguration.ps1.zip"

Este comando crea un paquete de .zip para el script especificado y los módulos de recursos dependientes y los almacena en el archivo local denominado .\MyConfiguration.ps1.zip.

Ejemplo 3: Agregar configuración al archivo y, a continuación, cargarla en el almacenamiento

Publish-AzVMDscConfiguration -ConfigurationPath "C:\Sample.ps1" -SkipDependencyDetection

Este comando agrega la configuración denominada Sample.ps1 al archivo de configuración para cargar en Azure Storage y omite los módulos de recursos dependientes.

Ejemplo 4: Agregar datos de configuración y configuración al archivo y cargarlos en el almacenamiento

Publish-AzVMDscConfiguration -ConfigurationPath "C:\Sample.ps1" -ConfigurationDataPath "C:\SampleData.psd1"

Este comando agrega la configuración denominada Sample.ps1 y los datos de configuración denominados SampleData.psd1 al archivo de configuración para cargarlos en Azure Storage.

Ejemplo 5: Agregar configuración, datos de configuración y contenido adicional al archivo y, a continuación, cargarlo en el almacenamiento

Publish-AzVMDscConfiguration -ConfigurationPath "C:\Sample.ps1" -AdditionalPath @("C:\ContentDir1", "C:\File.txt") -ConfigurationDataPath "C:\SampleData.psd1"

Este comando agrega configuración denominada Sample.ps1, datos de configuración SampleData.psd1 y contenido adicional al archivo de configuración para cargarlo en Azure Storage.

Parámetros

-AdditionalPath

Especifica la ruta de acceso de un archivo o un directorio que se va a incluir en el archivo de configuración. Se descarga en la máquina virtual junto con la configuración.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ConfigurationDataPath

Especifica la ruta de acceso de un archivo .psd1 que especifica los datos de la configuración. Esto se agrega al archivo de configuración y, a continuación, se pasa a la función de configuración. Se sobrescribe mediante la ruta de acceso de datos de configuración proporcionada a través del cmdlet Set-AzVMDscExtension.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ConfigurationPath

Especifica la ruta de acceso de un archivo que contiene una o varias configuraciones. El archivo puede ser un archivo de script de Windows PowerShell (.ps1) o un archivo de módulo de Windows PowerShell (.psm1).

Type:String
Position:1
Default value:None
Required:True
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

-ContainerName

Especifica el nombre del contenedor de Azure Storage al que se carga la configuración.

Type:String
Position:4
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

-OutputArchivePath

Especifica la ruta de acceso de un archivo .zip local en el que escribir el archivo de configuración. Cuando se usa este parámetro, el script de configuración no se carga en Azure Blob Storage.

Type:String
Aliases:ConfigurationArchivePath
Position:2
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

Especifica el nombre del grupo de recursos que contiene la cuenta de almacenamiento.

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SkipDependencyDetection

Indica que este cmdlet excluye las dependencias de recursos de DSC del archivo de configuración.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-StorageAccountName

Especifica el nombre de la cuenta de almacenamiento de Azure que se usa para cargar el script de configuración en el contenedor especificado por el parámetro ContainerName .

Type:String
Position:3
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-StorageEndpointSuffix

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

Type:String
Position:Named
Default value:None
Required:False
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

Entradas

String

String[]

Salidas

String