Get-AzureEnvironment

  • Riferimento
Modulo:
Azure

Ottiene gli ambienti di Azure

Nota

I cmdlet a cui si fa riferimento in questa documentazione sono per la gestione delle risorse di Azure legacy che usano le API di Azure Service Manager (ASM). Questo modulo di PowerShell legacy non è consigliato durante la creazione di nuove risorse perché ASM è pianificato per il ritiro. Per altre informazioni, vedere Ritiro di Azure Service Manager.

Il modulo Az PowerShell è il modulo PowerShell consigliato per la gestione delle risorse di Azure Resource Manager (ARM) con PowerShell.

Sintassi

Get-AzureEnvironment
   [-Name <String>]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Descrizione

Il cmdlet Get-AzureEnvironment ottiene gli ambienti azure disponibili per Windows PowerShell.

Un ambiente Azure una distribuzione indipendente di Microsoft Azure, ad esempio AzureCloud per Azure globale e AzureChinaCloud per Azure gestito da 21Vianet in Cina. È anche possibile creare ambienti di Azure locali usando Azure Pack e i cmdlet WAPack. Per altre informazioni, vedere Azure Pack.

Il cmdlet Get-AzureEnvironment ottiene gli ambienti dal file di dati della sottoscrizione, non da Azure. Se il file di dati della sottoscrizione non è aggiornato, eseguire il cmdlet Add-AzureAccount o Import-PublishSettingsFile per aggiornarlo.

Questo argomento descrive il cmdlet nella versione 0.8.10 del modulo Microsoft Azure PowerShell. Per ottenere la versione del modulo in uso, nella console di Azure PowerShell digitare (Get-Module -Name Azure).Version.

Esempio

Esempio 1: Ottenere tutti gli ambienti

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...

Questo comando ottiene tutti gli ambienti disponibili per Windows PowerShell.

Esempio 2: Ottenere un ambiente in base al nome

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/

Questo esempio ottiene l'ambiente AzureCloud.

Esempio 3: Ottenere tutte le proprietà di tutti gli ambienti

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

Questo comando ottiene tutte le proprietà di tutti gli ambienti.

Il comando usa il cmdlet Get-AzureEnvironment per ottenere tutti gli ambienti di Azure per questo account. Usa quindi il cmdlet Foreach-Object per eseguire un comando Get-AzureEnvironment con il parametro Name in ogni ambiente. Il valore del parametro Name è la proprietà EnvironmentName di ogni ambiente.

Senza parametri, Get-AzureEnvironment ottiene solo le proprietà selezionate di un ambiente.

Parametri

-Name

Ottiene solo l'ambiente specificato. Digitare il nome dell'ambiente. Il valore del parametro fa distinzione tra maiuscole e minuscole. I caratteri jolly non sono consentiti.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Profile

Specifica il profilo di Azure da cui viene letto questo cmdlet. Se non si specifica un profilo, questo cmdlet legge dal profilo predefinito locale.

Tipo:AzureSMProfile
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

None

È possibile inviare tramite pipe l'input a questo cmdlet in base al nome della proprietà, ma non in base al valore.

Output

PSCustomObject

Per impostazione predefinita, Get-AzureEnvironment restituisce un oggetto personalizzato.

Microsoft.WindowsAzure.Commands.Utilities.Common.WindowsAzureEnvironment

Quando si esegue Get-AzureEnvironment con il parametro Name , restituisce un oggetto WindowsAzureEnvironment .