Condividi tramite

Set-AzureSubscription

  • Riferimento
Modulo:
Azure

Modifica una sottoscrizione di Azure.

Nota

I cmdlet a cui si fa riferimento in questa documentazione sono per la gestione delle risorse di Azure legacy che usano le API di Azure Service Manager (ASM). Questo modulo di PowerShell legacy non è consigliato durante la creazione di nuove risorse perché ASM è pianificato per il ritiro. Per altre informazioni, vedere Ritiro di Azure Service Manager.

Il modulo Az PowerShell è il modulo PowerShell consigliato per la gestione delle risorse di Azure Resource Manager (ARM) con PowerShell.

Sintassi

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

Descrizione

Il cmdlet Set-AzureSubscription stabilisce e modifica le proprietà di un oggetto sottoscrizione di Azure. È possibile usare questo cmdlet per lavorare in una sottoscrizione di Azure che non è la sottoscrizione predefinita o per modificare l'account di archiviazione corrente. Per informazioni sulle sottoscrizioni correnti e predefinite, vedere il cmdlet Select-AzureSubscription .

Questo cmdlet opera su un oggetto sottoscrizione di Azure, non sulla sottoscrizione di Azure effettiva. Per creare ed effettuare il provisioning di una sottoscrizione di Azure, visitare il portale di Azure (https://azure.microsoft.com/).

Questo cmdlet modifica i dati nel file di dati della sottoscrizione creato quando si usa il cmdlet Add-AzureAccount o Import-AzurePublishSettingsFile per aggiungere un account Azure a Windows PowerShell.

Questo argomento descrive il cmdlet nella versione 0.8.10 del modulo Microsoft Azure PowerShell. Per ottenere la versione del modulo in uso, nella console di Azure PowerShell digitare (Get-Module -Name Azure).Version.

Esempio

Esempio 1: Modificare una sottoscrizione esistente1

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

Questo esempio modifica il certificato per la sottoscrizione denominata ContosoEngineering.

Esempio 2: Modificare l'endpoint del servizio

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

Questo comando aggiunge o modifica un endpoint di servizio personalizzato per la sottoscrizione ContosoEngineering.

Esempio 3: Cancellare i valori delle proprietà

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

Questo comando imposta i valori delle proprietà Certificate e ResourceManagerEndpoint su null ($Null). In questo modo vengono cancellati i valori di tali proprietà senza modificare altre impostazioni.

Esempio 4: Usare un file di dati di sottoscrizione alternativo

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

Questo comando modifica l'account di archiviazione corrente della sottoscrizione Contoso ContosoAccount in ContosoStorage01. Il comando usa il parametro SubscriptionDataFile per modificare i dati nel file di dati della sottoscrizione C:\Azure\SubscriptionData.xml. Per impostazione predefinita, Set-AzureSubscription usa il file di dati di sottoscrizione predefinito nel profilo utente mobile.

Parametri

-Certificate

Tipo:X509Certificate2
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Context

Tipo:AzureStorageContext
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-CurrentStorageAccountName

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Environment

Specifica un ambiente di Azure.

Un ambiente Azure una distribuzione indipendente di Microsoft Azure, ad esempio AzureCloud per Azure globale e AzureChinaCloud per Azure gestito da 21Vianet in Cina. È anche possibile creare ambienti di Azure locali usando Azure Pack e i cmdlet WAPack. Per altre informazioni, vedere Azure Pack.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PassThru

Restituisce $True se il comando ha esito positivo e $False in caso di errore. Per impostazione predefinita, questo cmdlet non restituisce alcun output.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Profile

Specifica il profilo di Azure da cui viene letto questo cmdlet. Se non si specifica un profilo, questo cmdlet legge dal profilo predefinito locale.

Tipo:AzureSMProfile
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ResourceManagerEndpoint

Specifica l'endpoint per i dati di Azure Resource Manager, inclusi i dati sui gruppi di risorse associati all'account. Per altre informazioni su Azure Resource Manager, vedere Cmdlet di Azure Resource Manager (https://go.microsoft.com/fwlink/?LinkID=394765) e Uso di Windows PowerShell con Resource Manager (https://go.microsoft.com/fwlink/?LinkID=394767).

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ServiceEndpoint

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-SubscriptionId

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-SubscriptionName

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

Input

None

È possibile inviare tramite pipe l'input a questo cmdlet in base al nome della proprietà, ma non in base al valore.

Output

None or System.Boolean

Quando si usa il parametro PassThru , questo cmdlet restituisce un valore booleano. Per impostazione predefinita, questo cmdlet non restituisce alcun output.