Compartir a través de

Get-AzurePublishSettingsFile

  • Referencia
Módulo:
Azure

Descarga el archivo de configuración de publicación para una suscripción de Azure.

Nota:

Los cmdlets a los que se hace referencia en esta documentación son para administrar recursos heredados de Azure que usan las API de Azure Service Manager (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 powerShell es el módulo de PowerShell recomendado para administrar recursos de Azure Resource Manager (ARM) con PowerShell.

Sintaxis

Get-AzurePublishSettingsFile
   [-Environment <String>]
   [-Realm <String>]
   [-PassThru]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Description

El cmdlet Get-AzurePublishSettingsFile descarga un archivo de configuración de publicación para una suscripción en su cuenta. Cuando se complete el comando, puede usar el cmdlet Import-PublishSettingsFile para que la configuración del archivo esté disponible para Windows PowerShell.

Para que la cuenta de Azure esté disponible para Windows PowerShell, puede usar un archivo de configuración de publicación o el cmdlet Add-AzureAccount . Los archivos de configuración de publicación le permiten preparar la sesión de antemano para que pueda ejecutar scripts y trabajos en segundo plano desatendidos. Sin embargo, no todos los servicios admiten archivos de configuración de publicación. Por ejemplo, el módulo AzureResourceManager no admite archivos de configuración de publicación.

Al ejecutar Get-AzurePublishSettingsFile, se abre el explorador predeterminado y se le pide que inicie sesión en su cuenta de Azure, seleccione una suscripción y seleccione una ubicación del sistema de archivos para el archivo de configuración de publicación. A continuación, descarga el archivo de configuración de publicación de la suscripción en el archivo seleccionado.

Un "archivo de configuración de publicación" es un archivo XML con una extensión de nombre de archivo .publishsettings. El archivo contiene un certificado codificado que proporciona credenciales de administración para las suscripciones de Azure.

Nota de seguridad: Los archivos de configuración de publicación contienen credenciales que se usan para administrar las suscripciones y servicios de Azure. Si los usuarios malintencionados acceden al archivo de configuración de publicación, pueden editar, crear y eliminar los servicios de Azure. Como procedimiento recomendado de seguridad, guarde el archivo en una ubicación en la carpeta Descargas o documentos y, después, elimínelo después de usar el cmdlet Import-AzurePublishSettingsFile para importar la configuración.

En este tema se describe el cmdlet en la versión 0.8.10 del módulo de Microsoft Azure PowerShell. Para obtener la versión del módulo que usa, en la consola de Azure PowerShell, escriba (Get-Module -Name Azure).Version.

Ejemplos

Ejemplo 1: Descargar un archivo de configuración de publicación

PS C:\> Get-AzurePublishSettingsFile

Este comando abre el explorador predeterminado, se conecta a la cuenta de Windows Azure y, a continuación, descarga el archivo .publishsettings de la cuenta.

Ejemplo 2: Especificar un dominio kerberos

PS C:\> Get-AzurePublishSettingsFile -Realm contoso.com -Passthru

Este comando descarga el archivo de configuración de publicación de una cuenta en el dominio de contoso.com. Use un comando con el parámetro Realm al iniciar sesión en Azure con una cuenta organizativa, en lugar de una cuenta microsoft.

Parámetros

-Environment

Especifica un entorno de Azure.

Un entorno de Azure que es una implementación independiente de Microsoft Azure, como AzureCloud para Azure global y AzureChinaCloud para Azure operado por 21Vianet en China. También puede crear entornos de Azure locales mediante Azure Pack y los cmdlets WAPack. Para más información, consulte Azure Pack.

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

-PassThru

Devuelve $True si el comando se ejecuta correctamente y $False si se produce un error. De forma predeterminada, este cmdlet no devuelve ninguna salida.

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

-Realm

Especifica la organización en un identificador organizativo. Por ejemplo, si inicia sesión en Azure como admin@contoso.com, el valor del parámetro Realm es contoso.com. Use este parámetro cuando use un identificador de organización para iniciar sesión en Azure Portal. Este parámetro no es necesario cuando se usa una cuenta Microsoft, como una cuenta de outlook.com o live.com.

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

Entradas

None

Puede canalizar la entrada a este cmdlet por nombre de propiedad, pero no por valor.

Salidas

None or System.Boolean

Cuando se usa el parámetro PassThru , este cmdlet devuelve un valor booleano. De lo contrario, este cmdlet no devuelve ninguna salida.