Compartir a través de

Publish-AzVMDscConfiguration

  • Referencia
Módulo:
Az.Compute

Carga un script de DSC en Azure Blob Storage.

Sintaxis

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.

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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).

Tipo:String
Posición:1
Valor predeterminado:None
Requerido:True
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

-ContainerName

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

Tipo:String
Posición:4
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

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

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

-ResourceGroupName

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

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

-SkipDependencyDetection

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

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

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

-StorageEndpointSuffix

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

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
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

Entradas

String

String[]

Salidas

String