Select-AzureSubscription
Zmienia bieżące i domyślne subskrypcje 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
SelectSubscriptionByNameParameterSet (Domyślna)
Select-AzureSubscription
-SubscriptionName <String>
[-Account <String>]
[-Current]
[-PassThru]
[-Profile <AzureSMProfile>]
[<CommonParameters>]
SelectDefaultSubscriptionByNameParameterSet
Select-AzureSubscription
-SubscriptionName <String>
[-Account <String>]
[-Default]
[-PassThru]
[-Profile <AzureSMProfile>]
[<CommonParameters>]
SelectSubscriptionByIdParameterSet
Select-AzureSubscription
-SubscriptionId <String>
[-Account <String>]
[-Current]
[-PassThru]
[-Profile <AzureSMProfile>]
[<CommonParameters>]
SelectDefaultSubscriptionByIdParameterSet
Select-AzureSubscription
-SubscriptionId <String>
[-Account <String>]
[-Default]
[-PassThru]
[-Profile <AzureSMProfile>]
[<CommonParameters>]
NoCurrentSubscriptionParameterSet
Select-AzureSubscription
[-Account <String>]
[-NoCurrent]
[-PassThru]
[-Profile <AzureSMProfile>]
[<CommonParameters>]
NoDefaultSubscriptionParameterSet
Select-AzureSubscription
[-Account <String>]
[-NoDefault]
[-PassThru]
[-Profile <AzureSMProfile>]
[<CommonParameters>]
Opis
Polecenie cmdlet Select-AzureSubscription ustawia i czyści bieżące i domyślne subskrypcje platformy Azure.
"Bieżąca subskrypcja" to subskrypcja używana domyślnie w bieżącej sesji programu Windows PowerShell. Domyślna subskrypcja jest używana domyślnie we wszystkich sesjach programu Windows PowerShell. Etykieta "bieżąca subskrypcja" umożliwia określenie innej subskrypcji, która ma być używana domyślnie dla bieżącej sesji bez zmiany "domyślnej subskrypcji" dla wszystkich innych sesji.
Oznaczenie subskrypcji "domyślne" jest zapisywane w pliku danych subskrypcji. Nie zapisano oznaczenia "current" specyficznego dla sesji.
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. Ustawianie bieżącej subskrypcji
C:\PS> Select-AzureSubscription -Current -SubscriptionName ContosoEngineering
To polecenie sprawia, że bieżąca subskrypcja jest "ContosoEngineering".
Przykład 2. Ustawianie subskrypcji domyślnej
C:\PS> Select-AzureSubscription -Default -SubscriptionName ContosoFinance -SubscriptionDataFile "C:\subs\MySubscriptions.xml"
To polecenie zmienia domyślną subskrypcję na "ContosoFinance". Zapisuje to ustawienie w pliku danych subskrypcji Subscriptions.xml zamiast domyślnego pliku danych subskrypcji.
Parametry
-Account
Polecenie cmdlet Select-AzureSubscription ustawia i czyści bieżące i domyślne subskrypcje platformy Azure.
"Bieżąca subskrypcja" to subskrypcja używana domyślnie w bieżącej sesji programu Windows PowerShell. Domyślna subskrypcja jest używana domyślnie we wszystkich sesjach programu Windows PowerShell. Etykieta "bieżąca subskrypcja" umożliwia określenie innej subskrypcji, która ma być używana domyślnie dla bieżącej sesji bez zmiany "domyślnej subskrypcji" dla wszystkich innych sesji.
Oznaczenie subskrypcji "domyślne" jest zapisywane w pliku danych subskrypcji. Nie zapisano oznaczenia "current" specyficznego dla sesji.
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.
Właściwości parametru
| Typ: | String |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-Current
Polecenie cmdlet Select-AzureSubscription ustawia i czyści bieżące i domyślne subskrypcje platformy Azure.
"Bieżąca subskrypcja" to subskrypcja używana domyślnie w bieżącej sesji programu Windows PowerShell. Domyślna subskrypcja jest używana domyślnie we wszystkich sesjach programu Windows PowerShell. Etykieta "bieżąca subskrypcja" umożliwia określenie innej subskrypcji, która ma być używana domyślnie dla bieżącej sesji bez zmiany "domyślnej subskrypcji" dla wszystkich innych sesji.
Oznaczenie subskrypcji "domyślne" jest zapisywane w pliku danych subskrypcji. Nie zapisano oznaczenia "current" specyficznego dla sesji.
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.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
SelectSubscriptionByNameParameterSet
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
SelectSubscriptionByIdParameterSet
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Default
Polecenie cmdlet Select-AzureSubscription ustawia i czyści bieżące i domyślne subskrypcje platformy Azure.
"Bieżąca subskrypcja" to subskrypcja używana domyślnie w bieżącej sesji programu Windows PowerShell. Domyślna subskrypcja jest używana domyślnie we wszystkich sesjach programu Windows PowerShell. Etykieta "bieżąca subskrypcja" umożliwia określenie innej subskrypcji, która ma być używana domyślnie dla bieżącej sesji bez zmiany "domyślnej subskrypcji" dla wszystkich innych sesji.
Oznaczenie subskrypcji "domyślne" jest zapisywane w pliku danych subskrypcji. Nie zapisano oznaczenia "current" specyficznego dla sesji.
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.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
SelectDefaultSubscriptionByNameParameterSet
| Position: | Named |
| Obowiązkowy: | True |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
SelectDefaultSubscriptionByIdParameterSet
| Position: | Named |
| Obowiązkowy: | True |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-NoCurrent
Polecenie cmdlet Select-AzureSubscription ustawia i czyści bieżące i domyślne subskrypcje platformy Azure.
"Bieżąca subskrypcja" to subskrypcja używana domyślnie w bieżącej sesji programu Windows PowerShell. Domyślna subskrypcja jest używana domyślnie we wszystkich sesjach programu Windows PowerShell. Etykieta "bieżąca subskrypcja" umożliwia określenie innej subskrypcji, która ma być używana domyślnie dla bieżącej sesji bez zmiany "domyślnej subskrypcji" dla wszystkich innych sesji.
Oznaczenie subskrypcji "domyślne" jest zapisywane w pliku danych subskrypcji. Nie zapisano oznaczenia "current" specyficznego dla sesji.
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.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
NoCurrentSubscriptionParameterSet
| Position: | Named |
| Obowiązkowy: | True |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-NoDefault
Polecenie cmdlet Select-AzureSubscription ustawia i czyści bieżące i domyślne subskrypcje platformy Azure.
"Bieżąca subskrypcja" to subskrypcja używana domyślnie w bieżącej sesji programu Windows PowerShell. Domyślna subskrypcja jest używana domyślnie we wszystkich sesjach programu Windows PowerShell. Etykieta "bieżąca subskrypcja" umożliwia określenie innej subskrypcji, która ma być używana domyślnie dla bieżącej sesji bez zmiany "domyślnej subskrypcji" dla wszystkich innych sesji.
Oznaczenie subskrypcji "domyślne" jest zapisywane w pliku danych subskrypcji. Nie zapisano oznaczenia "current" specyficznego dla sesji.
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.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
NoDefaultSubscriptionParameterSet
| Position: | Named |
| Obowiązkowy: | True |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | 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.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | 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.
Właściwości parametru
| Typ: | AzureSMProfile |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-SubscriptionId
Polecenie cmdlet Select-AzureSubscription ustawia i czyści bieżące i domyślne subskrypcje platformy Azure.
"Bieżąca subskrypcja" to subskrypcja używana domyślnie w bieżącej sesji programu Windows PowerShell. Domyślna subskrypcja jest używana domyślnie we wszystkich sesjach programu Windows PowerShell. Etykieta "bieżąca subskrypcja" umożliwia określenie innej subskrypcji, która ma być używana domyślnie dla bieżącej sesji bez zmiany "domyślnej subskrypcji" dla wszystkich innych sesji.
Oznaczenie subskrypcji "domyślne" jest zapisywane w pliku danych subskrypcji. Nie zapisano oznaczenia "current" specyficznego dla sesji.
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.
Właściwości parametru
| Typ: | String |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | Id |
Zestawy parametrów
SelectSubscriptionByIdParameterSet
| Position: | Named |
| Obowiązkowy: | True |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
SelectDefaultSubscriptionByIdParameterSet
| Position: | Named |
| Obowiązkowy: | True |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-SubscriptionName
Polecenie cmdlet Select-AzureSubscription ustawia i czyści bieżące i domyślne subskrypcje platformy Azure.
"Bieżąca subskrypcja" to subskrypcja używana domyślnie w bieżącej sesji programu Windows PowerShell. Domyślna subskrypcja jest używana domyślnie we wszystkich sesjach programu Windows PowerShell. Etykieta "bieżąca subskrypcja" umożliwia określenie innej subskrypcji, która ma być używana domyślnie dla bieżącej sesji bez zmiany "domyślnej subskrypcji" dla wszystkich innych sesji.
Oznaczenie subskrypcji "domyślne" jest zapisywane w pliku danych subskrypcji. Nie zapisano oznaczenia "current" specyficznego dla sesji.
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.
Właściwości parametru
| Typ: | String |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | Nazwa |
Zestawy parametrów
SelectSubscriptionByNameParameterSet
| Position: | Named |
| Obowiązkowy: | True |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
SelectDefaultSubscriptionByNameParameterSet
| Position: | Named |
| Obowiązkowy: | True |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
CommonParameters
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.
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 nie generuje żadnych danych wyjściowych.