Compartilhar via

Set-AzureSubscription

  • Referência
Módulo:
Azure

Altera uma assinatura do Azure.

Observação

Os cmdlets referenciados 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, pois o ASM está agendado para desativação. Para obter mais informações, confira a desativação do Azure Service Manager.

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

Sintaxe

Set-AzureSubscription
   -SubscriptionId <String>
   [-Certificate <X509Certificate2>]
   [-ServiceEndpoint <String>]
   [-ResourceManagerEndpoint <String>]
   [-CurrentStorageAccountName <String>]
   [-Context <AzureStorageContext>]
   [-Environment <String>]
   [-PassThru]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]
Set-AzureSubscription
   -SubscriptionName <String>
   [-Certificate <X509Certificate2>]
   [-ServiceEndpoint <String>]
   [-ResourceManagerEndpoint <String>]
   [-CurrentStorageAccountName <String>]
   [-Context <AzureStorageContext>]
   [-Environment <String>]
   [-PassThru]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]
Set-AzureSubscription
   -SubscriptionName <String>
   -SubscriptionId <String>
   -Certificate <X509Certificate2>
   [-ServiceEndpoint <String>]
   [-ResourceManagerEndpoint <String>]
   [-CurrentStorageAccountName <String>]
   [-Context <AzureStorageContext>]
   [-Environment <String>]
   [-PassThru]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Description

O cmdlet Set-AzureSubscription estabelece e altera as propriedades de um objeto de assinatura do Azure. Você pode usar esse cmdlet para trabalhar em uma assinatura do Azure que não seja sua assinatura padrão ou para alterar sua conta de armazenamento atual. Para obter informações sobre assinaturas atuais e padrão, consulte o cmdlet Select-AzureSubscription .

Esse cmdlet opera em um objeto de assinatura do Azure, não em sua assinatura real do Azure. Para criar e provisionar uma assinatura do Azure, visite o Portal do Azure (https://azure.microsoft.com/).

Esse cmdlet altera os dados no arquivo de dados da assinatura que você cria ao usar o cmdlet Add-AzureAccount ou Import-AzurePublishSettingsFile para adicionar uma conta do Azure ao Windows PowerShell.

Este tópico descreve o cmdlet na versão 0.8.10 do módulo do Microsoft Azure PowerShell. Para obter a versão do módulo que você está usando, no console do Azure PowerShell, digite (Get-Module -Name Azure).Version.

Exemplos

Exemplo 1: Alterar uma assinatura existente1

C:\PS> $thumbprint = <Thumbprint-2>
C:\PS> $differentCert = Get-Item cert:\\CurrentUser\My\$thumbprint
C:\PS> Set-AzureSubscription -SubscriptionName ContosoEngineering -Certificate $differentCert

Este exemplo altera o certificado da assinatura chamada ContosoEngineering.

Exemplo 2: Alterar o ponto de extremidade de serviço

C:\PS> Set-AzureSubscription -SubscriptionName ContosoEngineering -ServiceEndpoint "https://management.core.contoso.com"

Esse comando adiciona ou altera um ponto de extremidade de serviço personalizado para a assinatura ContosoEngineering.

Exemplo 3: Limpar valores de propriedade

C:\PS> Set-AzureSubscription -SubscriptionName ContosoEngineering -Certificate $null -ResourceManagerEndpoint $Null

Esse comando define os valores das propriedades Certificate e ResourceManagerEndpoint como nulos ($Null). Isso limpa os valores dessas propriedades sem alterar outras configurações.

Exemplo 4: Usar um arquivo de dados de assinatura alternativo

C:\PS> Set-AzureSubscription -SubscriptionName ContosoFinance -SubscriptionDataFile C:\Azure\SubscriptionData.xml -CurrentStorageAccount ContosoStorage01

Esse comando altera a conta de armazenamento atual da assinatura ContosoFinance para ContosoStorage01. O comando usa o parâmetro SubscriptionDataFile para alterar os dados no arquivo de dados de assinatura C:\Azure\SubscriptionData.xml. Por padrão, Set-AzureSubscription usa o arquivo de dados de assinatura padrão em seu perfil de usuário móvel.

Parâmetros

-Certificate

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

-Context

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

-CurrentStorageAccountName

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

-Environment

Especifica um ambiente do Azure.

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

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

-PassThru

Retorna $True se o comando for bem-sucedido e $False se falhar. Por padrão, esse cmdlet não retorna nenhuma saída.

Tipo:SwitchParameter
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 do qual esse cmdlet é lido. Se você não especificar um perfil, esse cmdlet lerá o 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

-ResourceManagerEndpoint

Especifica o ponto de extremidade para dados do Azure Resource Manager, incluindo dados sobre grupos de recursos associados à conta. Para obter mais informações sobre o Azure Resource Manager, consulte Cmdlets do Azure Resource Manager (https://go.microsoft.com/fwlink/?LinkID=394765) e Usando o Windows PowerShell com o Resource Manager (https://go.microsoft.com/fwlink/?LinkID=394767).

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

-ServiceEndpoint

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

-SubscriptionId

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

-SubscriptionName

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 por nome de propriedade, mas não por valor.

Saídas

None or System.Boolean

Quando você usa o parâmetro PassThru , esse cmdlet retorna um valor booliano. Por padrão, esse cmdlet não retorna nenhuma saída.