Partager via

Get-AzureEnvironment

  • Référence
Module:
Azure

Obtient les environnements Azure

Remarque

Les applets de commande référencées dans cette documentation concernent la gestion des 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-AzureEnvironment
   [-Name <String>]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Description

L’applet de commande Get-AzureEnvironment obtient les environnements Azure disponibles pour Windows PowerShell.

Un environnement Azure un déploiement indépendant de Microsoft Azure, tel qu’AzureCloud pour Azure global et AzureChinaCloud pour Azure géré par 21Vianet en Chine. Vous pouvez également créer des environnements Azure locaux à l’aide d’Azure Pack et des applets de commande WAPack. Pour plus d’informations, consultez Azure Pack).

L’applet de commande Get-AzureEnvironment obtient des environnements à partir de votre fichier de données d’abonnement, et non à partir d’Azure. Si le fichier de données d’abonnement est obsolète, exécutez l’applet de commande Add-AzureAccount ou Import-PublishSettingsFile pour l’actualiser.

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 environnements

PS C:\> Get-AzureEnvironment

EnvironmentName               ServiceEndpoint               ResourceManagerEndpoint       PublishSettingsFileUrl
---------------               ---------------               -----------------------       ----------------------

AzureCloud                    https://management.core.wi... https://management.azure.com/ https://go.microsoft.com/fw...
AzureChinaCloud               https://management.core.ch... https://not-supported-serv... https://go.microsoft.com/fw...

Cette commande obtient tous les environnements disponibles pour Windows PowerShell.

Exemple 2 : Obtenir un environnement par nom

PS C:\> Get-AzureEnvironment -Name AzureCloud

Name                          : AzureCloud

PublishSettingsFileUrl        : https://go.microsoft.com/fwlink/?LinkID=301775

ServiceEndpoint               : https://management.core.windows.net/

ResourceManagerEndpoint       : https://management.azure.com/

ManagementPortalUrl           : https://go.microsoft.com/fwlink/?LinkId=254433

ActiveDirectoryEndpoint       : https://login.windows.net/

ActiveDirectoryCommonTenantId : common

StorageEndpointSuffix         : core.windows.net

StorageBlobEndpointFormat     : {0}://{1}.blob.core.windows.net/

StorageQueueEndpointFormat    : {0}://{1}.queue.core.windows.net/

StorageTableEndpointFormat    : {0}://{1}.table.core.windows.net/

GalleryEndpoint               : https://gallery.azure.com/

Cet exemple obtient l’environnement AzureCloud.

Exemple 3 : Obtenir toutes les propriétés de tous les environnements

PS C:\> Get-AzureEnvironment | ForEach-Object {Get-AzureEnvironment -Name $_.EnvironmentName}

Cette commande obtient toutes les propriétés de tous les environnements.

La commande utilise l’applet de commande Get-AzureEnvironment pour obtenir tous les environnements Azure pour ce compte. Ensuite, il utilise l’applet de commande Foreach-Object pour exécuter une commande Get-AzureEnvironment avec le paramètre Name sur chaque environnement. La valeur du paramètre Name est la propriété EnvironmentName de chaque environnement.

Sans paramètres, Get-AzureEnvironment obtient uniquement les propriétés sélectionnées d’un environnement.

Paramètres

-Name

Obtient uniquement l’environnement spécifié. Tapez le nom de l’environnement. La valeur du paramètre respecte la casse. Les caractères génériques ne sont pas autorisés.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
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

Entrées

None

Vous pouvez diriger l’entrée vers cette applet de commande par nom de propriété, mais pas par valeur.

Sorties

PSCustomObject

Par défaut, Get-AzureEnvironment retourne un objet personnalisé.

Microsoft.WindowsAzure.Commands.Utilities.Common.WindowsAzureEnvironment

Lorsque vous exécutez Get-AzureEnvironment avec le paramètre Name, il retourne un objet WindowsAzureEnvironment.