Add-AzureEnvironment
Crea un ambiente 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
Add-AzureEnvironment
-Name <String>
[-PublishSettingsFileUrl <String>]
[-ServiceEndpoint <String>]
[-ManagementPortalUrl <String>]
[-StorageEndpoint <String>]
[-ActiveDirectoryEndpoint <String>]
[-ResourceManagerEndpoint <String>]
[-GalleryEndpoint <String>]
[-ActiveDirectoryServiceEndpointResourceId <String>]
[-GraphEndpoint <String>]
[-AzureKeyVaultDnsSuffix <String>]
[-AzureKeyVaultServiceEndpointResourceId <String>]
[-TrafficManagerDnsSuffix <String>]
[-SqlDatabaseDnsSuffix <String>]
[-EnableAdfsAuthentication]
[-AdTenant <String>]
[-Profile <AzureSMProfile>]
[<CommonParameters>] Descrizione
Il cmdlet Add-AzureEnvironment crea un nuovo ambiente account Azure personalizzato e lo salva nel profilo utente mobile. Il cmdlet restituisce un oggetto che rappresenta il nuovo ambiente. Al termine del comando, è possibile usare l'ambiente in 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.
Solo il parametro Name di questo cmdlet è obbligatorio. Se si omette un parametro, il relativo valore è null ($Null) e il servizio che usa tale endpoint potrebbe non funzionare correttamente. Per aggiungere o modificare il valore di una proprietà di ambiente, usare il cmdlet Set-AzureEnvironment .
NOTA: la modifica dell'ambiente può causare l'esito negativo dell'account. In genere, gli ambienti vengono aggiunti solo per i test o la risoluzione dei problemi.
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: Aggiungere un ambiente Azure
PS C:\> Add-AzureEnvironment -Name ContosoEnv -PublishSettingsFileUrl https://contoso.com/fwlink/?LinkID=101 -ServiceEndpoint https://contoso.com/fwlink/?LinkID=102
Name : ContosoEnv
PublishSettingsFileUrl : https://contoso.com/fwlink/?LinkID=101
ServiceEndpoint : https://contoso.com/fwlink/?LinkID=102
ResourceManagerEndpoint :
ManagementPortalUrl :
ActiveDirectoryEndpoint :
ActiveDirectoryCommonTenantId :
StorageEndpointSuffix :
StorageBlobEndpointFormat :
StorageQueueEndpointFormat :
StorageTableEndpointFormat :
GalleryEndpoint :Questo comando crea l'ambiente Azure ContosoEnv.
Parametri
-ActiveDirectoryEndpoint
Specifica l'endpoint per l'autenticazione di Microsoft Entra nel nuovo ambiente.
| Tipo: | String |
| Alias: | AdEndpointUrl, ActiveDirectory, ActiveDirectoryAuthority |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-ActiveDirectoryServiceEndpointResourceId
Specifica l'ID risorsa di un'API di gestione il cui accesso è gestito dall'ID Microsoft Entra.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-AdTenant
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-AzureKeyVaultDnsSuffix
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-AzureKeyVaultServiceEndpointResourceId
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-EnableAdfsAuthentication
| Tipo: | SwitchParameter |
| Alias: | OnPremise |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-GalleryEndpoint
Specifica l'endpoint per la raccolta di Azure Resource Manager, che archivia i modelli della raccolta di gruppi di risorse. Per altre informazioni sui gruppi di risorse di Azure e i modelli di raccolta, vedere l'argomento della Guida per Get-AzureResourceGroupGalleryTemplatehttps://go.microsoft.com/fwlink/?LinkID=393052.
| Tipo: | String |
| Alias: | Gallery, GalleryUrl |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-GraphEndpoint
| Tipo: | String |
| Alias: | Graph, GraphUrl |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-ManagementPortalUrl
Specifica l'URL del portale di gestione di Azure nel nuovo ambiente.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-Name
Specifica un nome per l'ambiente. Questo parametro è obbligatorio. Non usare i nomi degli ambienti predefiniti, AzureCloud e AzureChinaCloud.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| 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 |
-PublishSettingsFileUrl
Specifica l'URL dei file di impostazioni di pubblicazione per l'account. Un file di impostazioni di pubblicazione di Azure è un file XML che contiene informazioni sull'account e un certificato di gestione che consente a Windows PowerShell di accedere all'account Azure per conto dell'utente.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-ResourceManagerEndpoint
Specifica l'endpoint per i dati di Azure Resource Manager, inclusi i dati sui gruppi di risorse associati all'account. Per altre informazioni su Azure Resource Manager, vedere Cmdlet di Azure Resource Manager (https://go.microsoft.com/fwlink/?LinkID=394765) e Uso di Windows PowerShell con Resource Manager (https://go.microsoft.com/fwlink/?LinkID=394767).
| Tipo: | String |
| Alias: | ResourceManager, ResourceManagerUrl |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-ServiceEndpoint
Specifica l'URL dell'endpoint del servizio di Azure. L'endpoint di servizio di Azure determina se l'applicazione è gestita dalla piattaforma Azure globale, da Azure gestita da 21Vianet in Cina o da un'installazione privata di Azure.
| Tipo: | String |
| Alias: | ServiceManagement, ServiceManagementUrl |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-SqlDatabaseDnsSuffix
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-StorageEndpoint
Specifica l'endpoint predefinito dei servizi di archiviazione nel nuovo ambiente.
| Tipo: | String |
| Alias: | StorageEndpointSuffix |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-TrafficManagerDnsSuffix
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | True |
| 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
Microsoft.WindowsAzure.Commands.Utilities.Common.WindowsAzureEnvironment