Get-AzureSubscription

  • Référence
Module:
Azure

Obtient les abonnements Azure dans le compte Azure.

Remarque

Les cmdlets mentionnées dans cette documentation servent à gérer les ressources Azure héritées qui utilisent les API Azure Service Manager (ASM). Ce module PowerShell hérité n’est pas recommandé lors de la création de ressources, car ASM est planifié pour la mise hors service. Pour plus d’informations, consultez la mise hors service d’Azure Service Manager.

Le module Az PowerShell est le module PowerShell recommandé pour la gestion des ressources Azure Resource Manager (ARM) avec PowerShell.

Syntaxe

Get-AzureSubscription
   [-SubscriptionName <String>]
   [-ExtendedDetails]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]
Get-AzureSubscription
   [-SubscriptionId <String>]
   [-ExtendedDetails]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]
Get-AzureSubscription
   [-Default]
   [-ExtendedDetails]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]
Get-AzureSubscription
   [-Current]
   [-ExtendedDetails]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Description

L’applet de commande Get-AzureSubscription obtient les abonnements dans votre compte Azure. Vous pouvez utiliser cette applet de commande pour obtenir des informations sur l’abonnement et diriger l’abonnement vers d’autres applets de commande.

Get-AzureSubscription nécessite l’accès à vos comptes Azure. Avant d’exécuter Get-AzureSubscription, vous devez exécuter l’applet de commande Add-AzureAccount ou les applets de commande qui téléchargent et installent un fichier de paramètres de publication (Get-AzurePublishSettingsFile, Import-AzurePublishSettingsFile.

Cette rubrique décrit l’applet de commande dans la version 0.8.10 du module Microsoft Azure PowerShell. Pour obtenir la version du module que vous utilisez, dans la console Azure PowerShell, tapez (Get-Module -Name Azure).Version.

Exemples

Exemple 1 : Obtenir tous les abonnements

C:\PS>Get-AzureSubscription

Cette commande obtient tous les abonnements dans le compte.

Exemple 2 : Obtenir un abonnement par nom

C:\PS>Get-AzureSubscription -SubscriptionName "MyProdSubscription"

Cette commande obtient uniquement l’abonnement « MyProdSubsciption ».

Exemple 3 : Obtenir l’abonnement par défaut

C:\PS>(Get-AzureSubscription -Default).SubscriptionName

Cette commande obtient uniquement le nom de l’abonnement par défaut. La commande obtient d’abord l’abonnement, puis utilise la méthode dot pour obtenir la propriété SubscriptionName de l’abonnement.

Exemple 4 : Obtenir les propriétés d’abonnement sélectionnées

C:\PS>Get-AzureSubscription -Current | Format-List -Property SubscriptionName, Certificate

Cette commande retourne une liste portant le nom et le certificat de l’abonnement actuel. Il utilise une commande Get-AzureSubscription pour obtenir l’abonnement actuel. Ensuite, il canalise l’abonnement à une commande Format-List qui affiche les propriétés sélectionnées dans une liste.

Exemple 5 : Utiliser un autre fichier de données d’abonnement

C:\PS>Get-AzureSubscription -SubscriptionDataFile "C:\Temp\MySubscriptions.xml"

Cette commande obtient des abonnements à partir du fichier de données d’abonnement C :\Temp\MySubscriptions.xml. Utilisez le paramètre SubscriptionDataFile si vous avez spécifié un autre fichier de données d’abonnement lorsque vous avez exécuté les applets de commande Add-AzureAccount ou Import-PublishSettingsFile .

Paramètres

-Current

Obtient uniquement l’abonnement actuel, autrement dit, l’abonnement désigné comme « actif ». Par défaut, Get-AzureSubscription obtient tous les abonnements dans vos comptes Azure. Pour désigner un abonnement comme « actuel », utilisez le paramètre Actuel de l’applet de commande Select-AzureSubscription .

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Default

Obtient uniquement l’abonnement par défaut, autrement dit, l’abonnement désigné comme « par défaut ». Par défaut, Get-AzureSubscription obtient tous les abonnements dans vos comptes Azure. Pour désigner un abonnement comme « par défaut », utilisez le paramètre Par défaut de l’applet de commande Select-AzureSubscription .

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ExtendedDetails

Retourne des informations de quota pour l’abonnement, en plus des paramètres standard.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Profile

Spécifie le profil Azure à partir duquel cette applet de commande lit. Si vous ne spécifiez pas de profil, cette applet de commande lit le profil par défaut local.

Type:AzureSMProfile
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SubscriptionId

Type:String
Alias:Id
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-SubscriptionName

Obtient uniquement l’abonnement spécifié. Entrez le nom de l’abonnement. Cette valeur respecte la casse. Les caractères génériques ne sont pas pris en charge. Par défaut, Get-AzureSubscription obtient tous les abonnements dans vos comptes Azure.

Type:String
Alias:Name
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

Entrées

None

Vous pouvez diriger l’entrée vers la propriété SubscriptionName par nom, mais pas par valeur.

Sorties

Microsoft.WindowsAzure.Commands.Utilities.Common.WindowsAzureSubscription

Notes

  • Get-AzureSubscription obtient les données du fichier de données d’abonnement que les applets de commande Add-AzureAccount et Import-PublishSettingsFile créent.