Delen via

Set-AzureSubscription

  • Referentie
Module:
Azure

Hiermee wijzigt u een Azure-abonnement.

Notitie

De cmdlets waarnaar in deze documentatie wordt verwezen, zijn bedoeld voor het beheren van verouderde Azure-resources die gebruikmaken van ASM-API's (Azure Service Manager). Deze verouderde PowerShell-module wordt niet aanbevolen bij het maken van nieuwe resources, omdat ASM is gepland voor buitengebruikstelling. Zie Buitengebruikstelling van Azure Service Manager voor meer informatie.

De Az PowerShell-module is de aanbevolen PowerShell-module voor het beheren van ARM-resources (Azure Resource Manager) met PowerShell.

Syntaxis

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

Met de cmdlet Set-AzureSubscription worden de eigenschappen van een Azure-abonnementsobject vastgelegd en gewijzigd. U kunt deze cmdlet gebruiken om te werken in een Azure-abonnement dat niet uw standaardabonnement is of om uw huidige opslagaccount te wijzigen. Zie de cmdlet Select-AzureSubscription voor informatie over huidige en standaardabonnementen.

Deze cmdlet werkt op een Azure-abonnementsobject, niet uw werkelijke Azure-abonnement. Als u een Azure-abonnement wilt maken en inrichten, gaat u naar Azure Portal (https://azure.microsoft.com/).

Met deze cmdlet worden de gegevens in het abonnementsgegevensbestand gewijzigd dat u maakt wanneer u de cmdlet Add-AzureAccount of Import-AzurePublishSettingsFile gebruikt om een Azure-account toe te voegen aan Windows PowerShell.

In dit onderwerp wordt de cmdlet in de versie 0.8.10 van de Microsoft Azure PowerShell-module beschreven. Als u de versie van de module wilt ophalen die u gebruikt, typt (Get-Module -Name Azure).Versionu in de Azure PowerShell-console.

Voorbeelden

Voorbeeld 1: Een bestaand abonnement1 wijzigen

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

In dit voorbeeld wordt het certificaat voor het abonnement met de naam ContosoEngineering gewijzigd.

Voorbeeld 2: Het service-eindpunt wijzigen

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

Met deze opdracht wordt een aangepast service-eindpunt toegevoegd of gewijzigd voor het ContosoEngineering-abonnement.

Voorbeeld 3: Eigenschapswaarden wissen

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

Met deze opdracht worden de waarden van de eigenschappen Certificate en ResourceManagerEndpoint ingesteld op null ($Null). Hiermee worden de waarden van deze eigenschappen gewist zonder andere instellingen te wijzigen.

Voorbeeld 4: Een alternatief abonnementsgegevensbestand gebruiken

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

Met deze opdracht wordt het huidige opslagaccount van het ContosoFinance-abonnement gewijzigd in ContosoStorage01. De opdracht maakt gebruik van de parameter SubscriptionDataFile om de gegevens in het gegevensbestand C:\Azure\SubscriptionData.xml-abonnement te wijzigen. Set-AzureSubscription maakt standaard gebruik van het standaardgegevensbestand voor abonnementen in uw zwervende gebruikersprofiel.

Parameters

-Certificate

Type:X509Certificate2
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Context

Type:AzureStorageContext
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-CurrentStorageAccountName

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Environment

Hiermee geeft u een Azure-omgeving op.

Een Azure-omgeving een onafhankelijke implementatie van Microsoft Azure, zoals AzureCloud voor wereldwijde Azure en AzureChinaCloud voor Azure beheerd door 21Vianet in China. U kunt ook on-premises Azure-omgevingen maken met behulp van Azure Pack en de WAPack-cmdlets. Zie Azure Pack voor meer informatie.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PassThru

Retourneert $True als de opdracht slaagt en $False als deze mislukt. Deze cmdlet retourneert standaard geen uitvoer.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Profile

Hiermee geeft u het Azure-profiel op waaruit deze cmdlet wordt gelezen. Als u geen profiel opgeeft, leest deze cmdlet uit het lokale standaardprofiel.

Type:AzureSMProfile
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ResourceManagerEndpoint

Hiermee geeft u het eindpunt voor Azure Resource Manager-gegevens op, inclusief gegevens over resourcegroepen die zijn gekoppeld aan het account. Zie Azure Resource Manager-cmdlets () en Windows PowerShell gebruiken met Resource Manager (https://go.microsoft.com/fwlink/?LinkID=394767) voor meer informatie over Azure Resource Manager.https://go.microsoft.com/fwlink/?LinkID=394765

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ServiceEndpoint

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-SubscriptionId

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-SubscriptionName

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

Invoerwaarden

None

U kunt invoer naar deze cmdlet doorsluisen op eigenschapsnaam, maar niet op waarde.

Uitvoerwaarden

None or System.Boolean

Wanneer u de parameter PassThru gebruikt, retourneert deze cmdlet een Booleaanse waarde. Deze cmdlet retourneert standaard geen uitvoer.