Set-AzureSubscription
Ändert ein Azure-Abonnement.
Hinweis
Die in dieser Dokumentation referenzierten Cmdlets dienen zum Verwalten von älteren Azure-Ressourcen, die Azure Service Manager (ASM)-APIs verwenden. Dieses ältere PowerShell-Modul wird beim Erstellen neuer Ressourcen nicht empfohlen, da ASM für den Ruhestand geplant ist. Weitere Informationen finden Sie unter Einstellung des Azure Service Manager.
Das Az PowerShell-Modul ist das empfohlene PowerShell-Modul zum Verwalten von Azure Resource Manager (ARM)-Ressourcen mit PowerShell.
Syntax
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>]
Beschreibung
Das Cmdlet Set-AzureSubscription richtet die Eigenschaften eines Azure-Abonnementobjekts ein und ändert diese. Sie können dieses Cmdlet verwenden, um in einem Azure-Abonnement zu arbeiten, das nicht Ihr Standardabonnement ist, oder um Ihr aktuelles Speicherkonto zu ändern. Informationen zu aktuellen und Standardabonnements finden Sie im Cmdlet Select-AzureSubscription .
Dieses Cmdlet wird für ein Azure-Abonnementobjekt und nicht für Ihr tatsächliches Azure-Abonnement verwendet. Um ein Azure-Abonnement zu erstellen und bereitzustellen, besuchen Sie das Azure-Portal (https://azure.microsoft.com/).
Dieses Cmdlet ändert die Daten in der Abonnementdatendatei, die Sie erstellen, wenn Sie das Cmdlet "Add-AzureAccount " oder "Import-AzurePublishSettingsFile " verwenden, um windows PowerShell ein Azure-Konto hinzuzufügen.
In diesem Thema wird das Cmdlet in der Version 0.8.10 des Microsoft Azure PowerShell-Moduls beschrieben.
Um die Version des verwendeten Moduls abzurufen, geben Sie in der Azure PowerShell-Konsole folgendes ein (Get-Module -Name Azure).Version
.
Beispiele
Beispiel 1: Ändern eines vorhandenen Abonnements1
C:\PS> $thumbprint = <Thumbprint-2>
C:\PS> $differentCert = Get-Item cert:\\CurrentUser\My\$thumbprint
C:\PS> Set-AzureSubscription -SubscriptionName ContosoEngineering -Certificate $differentCert
In diesem Beispiel wird das Zertifikat für das Abonnement "Contoso Engineering" geändert.
Beispiel 2: Ändern des Dienstendpunkts
C:\PS> Set-AzureSubscription -SubscriptionName ContosoEngineering -ServiceEndpoint "https://management.core.contoso.com"
Mit diesem Befehl wird ein benutzerdefinierter Dienstendpunkt für das Contoso Engineering-Abonnement hinzugefügt oder geändert.
Beispiel 3: Löschen von Eigenschaftswerten
C:\PS> Set-AzureSubscription -SubscriptionName ContosoEngineering -Certificate $null -ResourceManagerEndpoint $Null
Mit diesem Befehl werden die Werte der Eigenschaften "Certificate" und "ResourceManagerEndpoint" auf NULL ($Null) festgelegt. Dadurch werden die Werte dieser Eigenschaften gelöscht, ohne andere Einstellungen zu ändern.
Beispiel 4: Verwenden einer alternativen Abonnementdatendatei
C:\PS> Set-AzureSubscription -SubscriptionName ContosoFinance -SubscriptionDataFile C:\Azure\SubscriptionData.xml -CurrentStorageAccount ContosoStorage01
Mit diesem Befehl wird das aktuelle Speicherkonto des ContosoFinance-Abonnements in ContosoStorage01 geändert. Der Befehl verwendet den Parameter "SubscriptionDataFile ", um die Daten in der Abonnementdatendatei "C:\Azure\SubscriptionData.xml" zu ändern. Standardmäßig verwendet Set-AzureSubscription die Standardabonnementdatendatei in Ihrem Roamingbenutzerprofil.
Parameter
-Certificate
Typ: | X509Certificate2 |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Context
Typ: | AzureStorageContext |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-CurrentStorageAccountName
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Environment
Gibt eine Azure-Umgebung an.
Eine Azure-Umgebung eine unabhängige Bereitstellung von Microsoft Azure, z. B. AzureCloud für globale Azure und AzureChinaCloud für Azure, betrieben von 21Vianet in China. Sie können auch lokale Azure-Umgebungen mithilfe von Azure Pack und den WAPack-Cmdlets erstellen. Weitere Informationen finden Sie unter Azure Pack.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
Gibt $True zurück, wenn der Befehl erfolgreich ist, und $False, wenn er fehlschlägt. Standardmäßig gibt dieses Cmdlet keine Ausgabe zurück.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Profile
Gibt das Azure-Profil an, aus dem dieses Cmdlet liest. Wenn Sie kein Profil angeben, liest dieses Cmdlet aus dem lokalen Standardprofil.
Typ: | AzureSMProfile |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceManagerEndpoint
Gibt den Endpunkt für Azure Resource Manager-Daten an, einschließlich Daten zu Ressourcengruppen, die dem Konto zugeordnet sind. Weitere Informationen zu Azure Resource Manager finden Sie unter Azure Resource Manager Cmdlets (https://go.microsoft.com/fwlink/?LinkID=394765) und Verwenden von Windows PowerShell mit Ressourcen-Manager (https://go.microsoft.com/fwlink/?LinkID=394767).
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ServiceEndpoint
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SubscriptionId
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SubscriptionName
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Eingaben
None
Sie können Eingaben nach Eigenschaftsname an dieses Cmdlet weiterleiten, aber nicht nach Wert.
Ausgaben
None or System.Boolean
Wenn Sie den PassThru-Parameter verwenden, gibt dieses Cmdlet einen booleschen Wert zurück. Standardmäßig gibt dieses Cmdlet keine Ausgabe zurück.