Compartilhar via

Import-AzurePublishSettingsFile

  • Referência
Módulo:
Azure

Importa um arquivo de configurações de publicação que permite gerenciar suas contas do Azure no Windows PowerShell.

Observação

Os cmdlets mencionados nesta documentação são para gerenciar recursos herdados do Azure que usam APIs do Azure Service Manager (ASM). Este módulo herdado do PowerShell não é recomendado ao criar novos recursos, já que o ASM está programado para desativação. Para obter mais informações, consulte Aposentadoria do Azure Service Manager.

O módulo Az PowerShell é o módulo do PowerShell recomendado para gerenciar recursos do Azure Resource Manager (ARM) com o PowerShell.

Sintaxe

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

Description

O cmdlet Import-AzurePublishSettingsFile importa um arquivo de configurações de publicação (*.publishsettings) que contém informações sobre suas contas do Azure e salva um arquivo de dados de assinatura em seu computador. Quando o cmdlet for concluído, você poderá gerenciar suas contas do Azure no Windows PowerShell.

Antes de executar Import-AzurePublishSettingsFile, execute Get-AzurePublishSettingsFile, que baixa e salva o arquivo de configurações de publicação para que você possa importá-lo.

Para disponibilizar sua conta do Azure para o Windows PowerShell, você pode usar um arquivo de configurações de publicação ou o cmdlet Add-AzureAccount . Os arquivos de configurações de publicação permitem preparar a sessão com antecedência para que você possa executar scripts e trabalhos em segundo plano de forma autônoma. No entanto, nem todos os serviços oferecem suporte a arquivos de configurações de publicação. Por exemplo, o módulo AzureResourceManager não oferece suporte a arquivos de configurações de publicação.

Nota de segurança: os arquivos de configurações de publicação contêm um certificado de gerenciamento codificado, mas não criptografado. Se usuários mal-intencionados acessarem seu arquivo de configurações de publicação, eles poderão editar, criar e excluir seus serviços do Azure. Como prática recomendada de segurança, salve o arquivo em um local na pasta Downloads ou Documentos e exclua-o depois de usar o cmdlet Import-AzurePublishSettingsFile para importar as configurações.

Exemplos

Exemplo 1: Importar um arquivo

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

Esse comando importa o arquivo "C:\Temp\MyAccount.publishsettings".

Parâmetros

-Environment

Especifica um ambiente do Azure.

Um ambiente do Azure uma implantação independente do Microsoft Azure, como o AzureCloud para Azure global e o AzureChinaCloud para Azure operado pela 21Vianet na China. Você também pode criar ambientes locais do Azure usando o Pacote do Azure e os cmdlets WAPack. Para obter mais informações, consulte Pacote do Azure.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Profile

Especifica o perfil do Azure a partir do qual este cmdlet lê. Se você não especificar um perfil, esse cmdlet será lido a partir do perfil padrão local.

Tipo:AzureSMProfile
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PublishSettingsFile

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Entradas

None

Você pode canalizar a entrada para esse cmdlet pelo nome da propriedade, mas não pelo valor.

Saídas

None

Este cmdlet não gera saída.

Observações

  • Um "arquivo de configurações de publicação" é um arquivo XML com uma extensão de nome de arquivo .publishsettings. O arquivo contém um certificado codificado que fornece credenciais de gerenciamento para suas assinaturas do Azure. Depois de importar esse arquivo, exclua-o para evitar riscos de segurança.
  • Um "arquivo de dados de assinatura" é um arquivo XML que pode ser salvo em seu computador com segurança. Por padrão, ele é salvo em seu perfil de usuário móvel ($home/AppData/Roaming).