Compartir a través de

Publish-AzureVMDscConfiguration

  • Referencia
Módulo:
Azure

Publica un script de configuración de estado deseado en Azure Blob Storage.

Nota:

Los cmdlets a los que se hace referencia en esta documentación son para administrar recursos de Azure heredados que usan las API de Azure Service Management (ASM). Este módulo heredado de PowerShell no se recomienda al crear nuevos recursos, ya que ASM está programado para la retirada. Para más información, consulte Retirada de Azure Service Manager.

El módulo Az de PowerShell es el módulo de PowerShell recomendado para administrar recursos de Azure Resource Manager (ARM) con PowerShell.

Sintaxis

Publish-AzureVMDscConfiguration
       [-ConfigurationPath] <String>
       [-ContainerName <String>]
       [-Force]
       [-StorageContext <AzureStorageContext>]
       [-StorageEndpointSuffix <String>]
       [-SkipDependencyDetection]
       [-ConfigurationDataPath <String>]
       [-AdditionalPath <String[]>]
       [-PassThru]
       [-Profile <AzureSMProfile>]
       [-InformationAction <ActionPreference>]
       [-InformationVariable <String>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Publish-AzureVMDscConfiguration
       [-ConfigurationPath] <String>
       [-Force]
       [-ConfigurationArchivePath <String>]
       [-SkipDependencyDetection]
       [-ConfigurationDataPath <String>]
       [-AdditionalPath <String[]>]
       [-PassThru]
       [-Profile <AzureSMProfile>]
       [-InformationAction <ActionPreference>]
       [-InformationVariable <String>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

El cmdlet Publish-AzureVMDscConfiguration publica un script de configuración de estado deseado en Azure Blob Storage, que posteriormente se puede aplicar a máquinas virtuales de Azure mediante el cmdlet Set-AzureVMDscExtension .

Ejemplos

Ejemplo 1: Publicación de un script de configuración de estado en Blob Storage

PS C:\> Publish-AzureVMDscConfiguration .\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: Publicación de un script de configuración de estado en un archivo local

PS C:\> Publish-AzureVMDscConfiguration .\MyConfiguration.ps1 -ConfigurationArchivePath .\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 .\MyConfiguration.ps1.zip.

Parámetros

-AdditionalPath

Especifica una matriz de rutas de acceso adicionales.

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

-ConfigurationArchivePath

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

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

-ConfigurationDataPath

Especifica una ruta de acceso de datos de configuración.

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 script de Windows PowerShell (archivo .ps1), un módulo (archivo.psm1) o un archivo (.zip archivo) que contiene un conjunto de módulos de Windows PowerShell, con cada módulo en un directorio independiente.

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

-InformationAction

Especifica cómo responde este cmdlet a un evento de información.

Los valores permitidos para este parámetro son los siguientes:

  • Continuar
  • Ignore
  • Inquire
  • SilentlyContinue
  • Detención
  • Suspender
Tipo:ActionPreference
Alias:infa
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InformationVariable

Especifica una variable de información.

Tipo:String
Alias:iv
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PassThru

Devuelve un objeto que representa el elemento con el que está trabajando. De forma predeterminada, este cmdlet no genera ningún resultado.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Profile

Especifica el perfil de Azure del que lee este cmdlet. Si no especifica un perfil, este cmdlet lee del perfil predeterminado local.

Tipo:AzureSMProfile
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SkipDependencyDetection

Indica que este cmdlet omite la detección de dependencias.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-StorageContext

Especifica el contexto de almacenamiento de Azure que proporciona la configuración de seguridad que se usa para cargar el script de configuración en el contenedor especificado por el parámetro ContainerName . Este contexto proporciona acceso de escritura al contenedor.

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

-StorageEndpointSuffix

Especifica el sufijo para el punto de conexión de almacenamiento, por ejemplo, core.contoso.net

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