Udostępnij za pośrednictwem

Set-AzureSubscription

  • Odwołanie
Moduł:
Azure

Zmienia subskrypcję platformy Azure.

Uwaga

Polecenia cmdlet, do których odwołuje się ta dokumentacja, służą do zarządzania starszymi zasobami platformy Azure korzystającymi z interfejsów API programu Azure Service Manager (ASM). Ten starszy moduł programu PowerShell nie jest zalecany podczas tworzenia nowych zasobów, ponieważ usługa ASM ma zostać wycofana. Aby uzyskać więcej informacji, zobacz Wycofywanie programu Azure Service Manager.

Moduł Az programu PowerShell jest zalecanym modułem programu PowerShell do zarządzania zasobami usługi Azure Resource Manager (ARM) przy użyciu programu PowerShell.

Składnia

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

Opis

Polecenie cmdlet Set-AzureSubscription ustanawia i zmienia właściwości obiektu subskrypcji platformy Azure. Za pomocą tego polecenia cmdlet możesz pracować w subskrypcji platformy Azure, która nie jest subskrypcją domyślną lub zmienić bieżące konto magazynu. Aby uzyskać informacje o bieżących i domyślnych subskrypcjach, zobacz polecenie cmdlet Select-AzureSubscription .

To polecenie cmdlet działa na obiekcie subskrypcji platformy Azure, a nie na rzeczywistej subskrypcji platformy Azure. Aby utworzyć i aprowizować subskrypcję platformy Azure, odwiedź witrynę Azure Portal (https://azure.microsoft.com/).

To polecenie cmdlet zmienia dane w pliku danych subskrypcji tworzonym podczas korzystania z polecenia cmdlet Add-AzureAccount lub Import-AzurePublishSettingsFile w celu dodania konta platformy Azure do programu Windows PowerShell.

W tym temacie opisano polecenie cmdlet w wersji 0.8.10 modułu Microsoft Azure PowerShell. Aby uzyskać wersję używanego modułu, w konsoli programu Azure PowerShell wpisz (Get-Module -Name Azure).Version.

Przykłady

Przykład 1. Zmiana istniejącej subskrypcji1

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

W tym przykładzie zmienia się certyfikat subskrypcji o nazwie ContosoEngineering.

Przykład 2. Zmiana punktu końcowego usługi

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

To polecenie dodaje lub zmienia niestandardowy punkt końcowy usługi dla subskrypcji ContosoEngineering.

Przykład 3. Wyczyść wartości właściwości

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

To polecenie ustawia wartości właściwości Certificate i ResourceManagerEndpoint na null ($Null). Spowoduje to wyczyszczenie wartości tych właściwości bez zmiany innych ustawień.

Przykład 4. Używanie alternatywnego pliku danych subskrypcji

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

To polecenie zmienia bieżące konto magazynu subskrypcji ContosoFinance na ContosoStorage01. Polecenie używa parametru SubscriptionDataFile , aby zmienić dane w pliku danych subskrypcji C:\Azure\SubscriptionData.xml. Domyślnie ustawienie Set-AzureSubscription używa domyślnego pliku danych subskrypcji w profilu użytkownika mobilnego.

Parametry

-Certificate

Typ:X509Certificate2
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Context

Typ:AzureStorageContext
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-CurrentStorageAccountName

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Environment

Określa środowisko platformy Azure.

Środowisko platformy Azure niezależne wdrożenie platformy Microsoft Azure, takie jak AzureCloud for global Azure i AzureChinaCloud for Azure obsługiwane przez firmę 21Vianet w Chinach. Możesz również tworzyć lokalne środowiska platformy Azure przy użyciu pakietu Azure Pack i poleceń cmdlet WAPack. Aby uzyskać więcej informacji, zobacz Azure Pack.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-PassThru

Zwraca $True, jeśli polecenie powiedzie się i $False, jeśli zakończy się niepowodzeniem. Domyślnie to polecenie cmdlet nie zwraca żadnych danych wyjściowych.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Profile

Określa profil platformy Azure, z którego to polecenie cmdlet odczytuje. Jeśli nie określisz profilu, to polecenie cmdlet odczytuje z lokalnego profilu domyślnego.

Typ:AzureSMProfile
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ResourceManagerEndpoint

Określa punkt końcowy dla danych usługi Azure Resource Manager, w tym dane dotyczące grup zasobów skojarzonych z kontem. Aby uzyskać więcej informacji na temat usługi Azure Resource Manager, zobacz Polecenia cmdlet usługi Azure Resource Manager (https://go.microsoft.com/fwlink/?LinkID=394765) i Używanie programu Windows PowerShell z usługą Resource Manager (https://go.microsoft.com/fwlink/?LinkID=394767).

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ServiceEndpoint

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-SubscriptionId

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-SubscriptionName

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

None

Możesz przekazać dane wejściowe do tego polecenia cmdlet według nazwy właściwości, ale nie według wartości.

Dane wyjściowe

None or System.Boolean

Jeśli używasz parametru PassThru , to polecenie cmdlet zwraca wartość logiczną. Domyślnie to polecenie cmdlet nie zwraca żadnych danych wyjściowych.