Set-AzureSubscription

Referenz

Modul:: Azure

Ändert ein Azure-Abonnement.

Hinweis

Die Cmdlets, auf die in dieser Dokumentation verwiesen wird, dienen zum Verwalten von Azure-Legacyressourcen, die Dienstverwaltungs-APIs verwenden. Cmdlets zum Verwalten von Azure Ressource Manager-Ressourcen finden Sie im Az PowerShell-Modul.

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 Datendatei "C:\Azure\SubscriptionData.xml" zu ändern. Standardmäßig verwendet Set-AzureSubscription die Standardabonnementdatendatei in Ihrem Roamingbenutzerprofil.

Parameter

-Certificate

Type:	X509Certificate2
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Context

Type:	AzureStorageContext
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-CurrentStorageAccountName

Type:	String
Position:	Named
Default value:	None
Required:	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.

Type:	String
Position:	Named
Default value:	None
Required:	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.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	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.

Type:	AzureSMProfile
Position:	Named
Default value:	None
Required:	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).

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ServiceEndpoint

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-SubscriptionId

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-SubscriptionName

Type:	String
Position:	Named
Default value:	None
Required:	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.