Dela via

Set-AzureSubscription

  • Referens
Modul:
Azure

Ändrar en Azure-prenumeration.

Kommentar

De cmdletar som refereras i den här dokumentationen är till för att hantera äldre Azure-resurser som använder Service Management-API:er. Se Az PowerShell-modulen för cmdletar för att hantera Azure Resource Manager-resurser.

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

Description

Cmdleten Set-AzureSubscription upprättar och ändrar egenskaperna för ett Azure-prenumerationsobjekt. Du kan använda den här cmdleten för att arbeta i en Azure-prenumeration som inte är din standardprenumeration eller för att ändra ditt aktuella lagringskonto. Information om aktuella prenumerationer och standardprenumerationer finns i cmdleten Select-AzureSubscription .

Den här cmdleten fungerar på ett Azure-prenumerationsobjekt, inte din faktiska Azure-prenumeration. Om du vill skapa och etablera en Azure-prenumeration går du till Azure Portal (https://azure.microsoft.com/).

Den här cmdleten ändrar data i prenumerationsdatafilen som du skapar när du använder cmdleten Add-AzureAccount eller Import-AzurePublishSettingsFile för att lägga till ett Azure-konto i Windows PowerShell.

Det här avsnittet beskriver cmdleten i 0.8.10-versionen av Microsoft Azure PowerShell-modulen. Om du vill hämta den version av modulen som du använder skriver (Get-Module -Name Azure).Versiondu i Azure PowerShell-konsolen .

Exempel

Exempel 1: Ändra en befintlig prenumeration1

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

I det här exemplet ändras certifikatet för prenumerationen med namnet ContosoEngineering.

Exempel 2: Ändra tjänstslutpunkten

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

Det här kommandot lägger till eller ändrar en anpassad tjänstslutpunkt för ContosoEngineering-prenumerationen.

Exempel 3: Rensa egenskapsvärden

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

Det här kommandot anger värdena för egenskaperna Certifikat och ResourceManagerEndpoint till null ($Null). Detta rensar värdena för dessa egenskaper utan att ändra andra inställningar.

Exempel 4: Använd en alternativ prenumerationsdatafil

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

Det här kommandot ändrar det aktuella lagringskontot för ContosoFinance-prenumerationen till ContosoStorage01. Kommandot använder parametern SubscriptionDataFile för att ändra data i prenumerationsdatafilen C:\Azure\SubscriptionData.xml. Som standard använder Set-AzureSubscription standardprenumerationsdatafilen i din centrala användarprofil.

Parametrar

-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

Anger en Azure-miljö.

En Azure-miljö en oberoende distribution av Microsoft Azure, till exempel AzureCloud för globala Azure och AzureChinaCloud för Azure som drivs av 21Vianet i Kina. Du kan också skapa lokala Azure-miljöer med hjälp av Azure Pack och WAPack-cmdletarna. Mer information finns i Azure Pack.

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

-PassThru

Returnerar $True om kommandot lyckas och $False om det misslyckas. Som standard returnerar den här cmdleten inga utdata.

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

-Profile

Anger den Azure-profil som den här cmdleten läser från. Om du inte anger någon profil läser den här cmdleten från den lokala standardprofilen.

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

-ResourceManagerEndpoint

Anger slutpunkten för Azure Resource Manager-data, inklusive data om resursgrupper som är associerade med kontot. Mer information om Azure Resource Manager finns i Azure Resource Manager-cmdletar (https://go.microsoft.com/fwlink/?LinkID=394765) och Använda Windows PowerShell med Resource 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

Indata

None

Du kan skicka indata till den här cmdleten efter egenskapsnamn, men inte efter värde.

Utdata

None or System.Boolean

När du använder parametern PassThru returnerar den här cmdleten ett booleskt värde. Som standard returnerar den här cmdleten inga utdata.