Compartir a través de

Import-AzurePublishSettingsFile

  • Referencia
Módulo:
Azure

Importa un archivo de configuración de publicación que le permite administrar las cuentas de Azure en Windows PowerShell.

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

Import-AzurePublishSettingsFile
      -PublishSettingsFile <String>
      [-Environment <String>]
      [-Profile <AzureSMProfile>]
      [<CommonParameters>]

Description

El cmdlet Import-AzurePublishSettingsFile importa un archivo de configuración de publicación (*.publishsettings) que contiene información sobre las cuentas de Azure y guarda un archivo de datos de suscripción en el equipo. Cuando se complete el cmdlet, puede administrar las cuentas de Azure en Windows PowerShell.

Antes de ejecutar Import-AzurePublishSettingsFile, ejecute Get-AzurePublishSettingsFile, que descarga y guarda el archivo de configuración de publicación para poder importarlo.

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.

Nota de seguridad: Los archivos de configuración de publicación contienen un certificado de administración codificado, pero no cifrado. Si los usuarios malintencionados acceden al archivo de configuración de publicación, es posible que puedan 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.

Ejemplos

Ejemplo 1: Importación de un archivo

PS C:\> Import-AzurePublishSettingsFile -PublishSettingsFile C:\Temp\MyAccount.publishsettings

Este comando importa el archivo "C:\Temp\MyAccount.publishsettings".

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

-PublishSettingsFile

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

Este cmdlet no genera ningún resultado.

Notas

  • 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. Después de importar este archivo, elimínelo para evitar riesgos de seguridad.
  • Un "archivo de datos de suscripción" es un archivo XML que se puede guardar en el equipo de forma segura. De forma predeterminada, se guarda en el perfil de usuario móvil ($home/AppData/Roaming).