Set-AzureEnvironment
Modifica le proprietà di 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
Set-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 Set-AzureEnvironment modifica le proprietà di un ambiente Azure. Restituisce un oggetto che rappresenta l'ambiente con i nuovi valori delle proprietà. Usare il parametro Name per identificare l'ambiente e gli altri parametri per modificare i valori delle proprietà. Non è possibile usare Set-AzureEnvironment per modificare il nome di un ambiente Azure.
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.
NOTA: non modificare le proprietà degli ambienti AzureCloud o AzureChinaCloud. Usare questo cmdlet per modificare i valori degli ambienti privati creati.
Esempio
Esempio 1: Modificare le proprietà dell'ambiente
PS C:\> Set-AzureEnvironment -Name ContosoEnv -PublishSettingsFileUrl "https://contoso.com" -StorageEndpoint "contoso.com"Questo comando modifica i valori delle proprietà PublishSettingsFileUrl e StorageEndpoint dell'ambiente ContosoEnv.
Parametri
-ActiveDirectoryEndpoint
Modifica l'endpoint per l'autenticazione di Microsoft Entra con il valore specificato.
| 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
Modifica l'endpoint per la raccolta di Azure Resource Manager impostando il valore specificato. L'endpoint della raccolta è il percorso per i modelli della raccolta di gruppi di risorse. Per altre informazioni sui gruppi di risorse e i modelli di raccolta di Azure, vedere l'argomento della Guida per Get-AzureResourceGroupGalleryTemplate.
| 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
Modifica l'URL del portale di gestione di Azure con il valore specificato.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-Name
Identifica l'ambiente da modificare. Questo parametro è obbligatorio. Il valore del parametro fa distinzione tra maiuscole e minuscole. I caratteri jolly non sono consentiti.
| 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
Modifica l'URL per i file delle impostazioni di pubblicazione nell'ambiente specificato. 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
Modifica 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
Modifica l'URL dell'endpoint del servizio di Azure nell'ambiente specificato. 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
Modifica l'endpoint predefinito dei servizi di archiviazione nell'ambiente specificato.
| 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