Get-AzureEnvironment
Obtiene entornos de Azure.
Nota:
Los cmdlets a los que se hace referencia en esta documentación son para administrar recursos de Azure heredados que usan las API de Azure Service Management (ASM). Este módulo heredado de PowerShell no se recomienda al crear nuevos recursos, ya que ASM está programado para la retirada. Para más información, consulte Retirada de Azure Service Manager.
El módulo Az de PowerShell es el módulo de PowerShell recomendado para administrar recursos de Azure Resource Manager (ARM) con PowerShell.
Sintaxis
Get-AzureEnvironment
[-Name <String>]
[-Profile <AzureSMProfile>]
[<CommonParameters>] Description
El cmdlet Get-AzureEnvironment obtiene los entornos de Azure que están disponibles para Windows PowerShell.
Un entorno de Azure que es una implementación independiente de Microsoft Azure, como AzureCloud para Azure global y AzureChinaCloud para Azure operado por 21Vianet en China. También puede crear entornos de Azure locales mediante Azure Pack y los cmdlets WAPack. Para más información, consulte Azure Pack).
El cmdlet Get-AzureEnvironment obtiene entornos del archivo de datos de suscripción, no de Azure. Si el archivo de datos de la suscripción está obsoleto, ejecute el cmdlet Add-AzureAccount o Import-PublishSettingsFile para actualizarlo.
En este tema se describe el cmdlet en la versión 0.8.10 del módulo de Microsoft Azure PowerShell.
Para obtener la versión del módulo que usa, en la consola de Azure PowerShell, escriba (Get-Module -Name Azure).Version.
Ejemplos
Ejemplo 1: Obtener todos los entornos
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...Este comando obtiene todos los entornos disponibles para Windows PowerShell.
Ejemplo 2: Obtener un entorno por nombre
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/En este ejemplo se obtiene el entorno de AzureCloud.
Ejemplo 3: Obtener todas las propiedades de todos los entornos
PS C:\> Get-AzureEnvironment | ForEach-Object {Get-AzureEnvironment -Name $_.EnvironmentName}Este comando obtiene todas las propiedades de todos los entornos.
El comando usa el cmdlet Get-AzureEnvironment para obtener todos los entornos de Azure para esta cuenta. A continuación, usa el cmdlet Foreach-Object para ejecutar un comando Get-AzureEnvironment con el parámetro Name en cada entorno. El valor del parámetro Name es la propiedad EnvironmentName de cada entorno.
Sin parámetros, Get-AzureEnvironment solo obtiene las propiedades seleccionadas de un entorno.
Parámetros
-Name
Obtiene solo el entorno especificado. Escriba el nombre del entorno. El valor del parámetro distingue mayúsculas de minúsculas. No se admite el uso de caracteres comodín.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-Profile
Especifica el perfil de Azure del que lee este cmdlet. Si no especifica un perfil, este cmdlet lee del perfil predeterminado local.
| Tipo: | AzureSMProfile |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
Entradas
None
Puede canalizar la entrada a este cmdlet por nombre de propiedad, pero no por valor.
Salidas
De forma predeterminada, Get-AzureEnvironment devuelve un objeto personalizado.
Microsoft.WindowsAzure.Commands.Utilities.Common.WindowsAzureEnvironment
Al ejecutar Get-AzureEnvironment con el parámetro Name, devuelve un objeto WindowsAzureEnvironment.