Udostępnij za pośrednictwem

Select-AzureSubscription

  • Odwołanie
Moduł:
Azure

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

Select-AzureSubscription
      -SubscriptionName <String>
      [-Account <String>]
      [-Current]
      [-PassThru]
      [-Profile <AzureSMProfile>]
      [<CommonParameters>]
Select-AzureSubscription
      -SubscriptionName <String>
      [-Account <String>]
      [-Default]
      [-PassThru]
      [-Profile <AzureSMProfile>]
      [<CommonParameters>]
Select-AzureSubscription
      -SubscriptionId <String>
      [-Account <String>]
      [-Current]
      [-PassThru]
      [-Profile <AzureSMProfile>]
      [<CommonParameters>]
Select-AzureSubscription
      -SubscriptionId <String>
      [-Account <String>]
      [-Default]
      [-PassThru]
      [-Profile <AzureSMProfile>]
      [<CommonParameters>]
Select-AzureSubscription
      [-Account <String>]
      [-NoCurrent]
      [-PassThru]
      [-Profile <AzureSMProfile>]
      [<CommonParameters>]
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

Typ:String
Position:Named
wartość domyślna:None
Wymagane:False
Accept pipeline input:True
Accept wildcard characters:False

-Current

Typ:SwitchParameter
Position:Named
wartość domyślna:None
Wymagane:False
Accept pipeline input:False
Accept wildcard characters:False

-Default

Typ:SwitchParameter
Position:Named
wartość domyślna:None
Wymagane:True
Accept pipeline input:False
Accept wildcard characters:False

-NoCurrent

Typ:SwitchParameter
Position:Named
wartość domyślna:None
Wymagane:True
Accept pipeline input:False
Accept wildcard characters:False

-NoDefault

Typ:SwitchParameter
Position:Named
wartość domyślna:None
Wymagane:True
Accept pipeline input:False
Accept wildcard characters: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
wartość domyślna:None
Wymagane:False
Accept pipeline input:False
Accept wildcard characters: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
wartość domyślna:None
Wymagane:False
Accept pipeline input:False
Accept wildcard characters:False

-SubscriptionId

Typ:String
Aliases:Id
Position:Named
wartość domyślna:None
Wymagane:True
Accept pipeline input:True
Accept wildcard characters:False

-SubscriptionName

Typ:String
Aliases:Name
Position:Named
wartość domyślna:None
Wymagane:True
Accept pipeline input:True
Accept wildcard characters: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 nie generuje żadnych danych wyjściowych.