Sdílet prostřednictvím

Set-AzureSubscription

  • Reference
Modul:
Azure

Změní předplatné Azure.

Poznámka:

Rutiny, na které odkazuje tato dokumentace, slouží ke správě starších prostředků Azure, které používají rozhraní API Azure Service Manageru (ASM). Tento starší modul PowerShellu se nedoporučuje při vytváření nových prostředků, protože ASM je naplánované pro vyřazení z provozu. Další informace najdete v části Vyřazení Azure Service Manageru.

Modul Az PowerShell je doporučený modul PowerShellu pro správu prostředků Azure Resource Manageru (ARM) pomocí PowerShellu.

Syntaxe

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

Rutina Set-AzureSubscription vytvoří a změní vlastnosti objektu předplatného Azure. Tuto rutinu můžete použít k práci v předplatném Azure, které není vaším výchozím předplatným, nebo ke změně aktuálního účtu úložiště. Informace o aktuálních a výchozích předplatných najdete v rutině Select-AzureSubscription .

Tato rutina pracuje s objektem předplatného Azure, ne se skutečným předplatným Azure. Pokud chcete vytvořit a zřídit předplatné Azure, navštivte web Azure Portal (https://azure.microsoft.com/).

Tato rutina změní data v datovém souboru předplatného, který vytvoříte při použití rutiny Add-AzureAccount nebo Import-AzurePublishSettingsFile pro přidání účtu Azure do Prostředí Windows PowerShell.

Toto téma popisuje rutinu ve verzi 0.8.10 modulu Microsoft Azure PowerShell. Pokud chcete získat verzi modulu, který používáte, zadejte (Get-Module -Name Azure).Versionv konzole Azure PowerShellu .

Příklady

Příklad 1: Změna existujícího předplatného 1

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

Tento příklad změní certifikát pro předplatné s názvem ContosoEngineering.

Příklad 2: Změna koncového bodu služby

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

Tento příkaz přidá nebo změní vlastní koncový bod služby pro předplatné ContosoEngineering.

Příklad 3: Vymazání hodnot vlastností

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

Tento příkaz nastaví hodnoty vlastností Certificate a ResourceManagerEndpoint na hodnotu null ($Null). Tím se vymažou hodnoty těchto vlastností beze změny jiných nastavení.

Příklad 4: Použití alternativního datového souboru předplatného

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

Tento příkaz změní aktuální účet úložiště předplatného ContosoFinance na ContosoStorage01. Příkaz pomocí parametru SubscriptionDataFile změní data v datovém souboru C:\Azure\SubscriptionData.xml předplatného. Ve výchozím nastavení používá Set-AzureSubscription výchozí datový soubor předplatného ve vašem cestovním profilu uživatele.

Parametry

-Certificate

Typ:X509Certificate2
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Context

Typ:AzureStorageContext
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-CurrentStorageAccountName

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Environment

Určuje prostředí Azure.

Prostředí Azure nezávislé nasazení Microsoft Azure, jako je AzureCloud pro globální Azure a AzureChinaCloud pro Azure provozované společností 21Vianet v Číně. Místní prostředí Azure můžete vytvořit také pomocí azure Packu a rutin WAPacku. Další informace najdete v tématu Azure Pack.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-PassThru

Vrátí $True, pokud příkaz proběhne úspěšně a $False, pokud selže. Ve výchozím nastavení tato rutina nevrací žádný výstup.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Profile

Určuje profil Azure, ze kterého se tato rutina čte. Pokud nezadáte profil, tato rutina načte z místního výchozího profilu.

Typ:AzureSMProfile
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ResourceManagerEndpoint

Určuje koncový bod pro data Azure Resource Manageru, včetně dat o skupinách prostředků přidružených k účtu. Další informace o Azure Resource Manageru najdete v tématu Rutiny Azure Resource Manageru (https://go.microsoft.com/fwlink/?LinkID=394765) a Použití Prostředí Windows PowerShell s Resource Managerem (https://go.microsoft.com/fwlink/?LinkID=394767).

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ServiceEndpoint

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-SubscriptionId

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-SubscriptionName

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

Vstupy

None

Vstup do této rutiny můžete řadit podle názvu vlastnosti, ale ne podle hodnoty.

Výstupy

None or System.Boolean

Pokud použijete parametr PassThru , vrátí tato rutina logickou hodnotu. Ve výchozím nastavení tato rutina nevrací žádný výstup.