Add-AzureRmEnvironment
Aggiunge endpoint e metadati per un'istanza di Azure Resource Manager.
Avviso
Il modulo AzureRM PowerShell è stato ufficialmente deprecato a partire dal 29 febbraio 2024. È consigliabile eseguire la migrazione da AzureRM al modulo Az PowerShell per garantire il supporto e gli aggiornamenti continui.
Anche se il modulo AzureRM può ancora funzionare, non è più gestito o supportato, posizionando qualsiasi uso continuo a discrezione e rischio dell'utente. Per indicazioni sulla transizione al modulo Az, vedere le risorse di migrazione.
Sintassi
Add-AzureRmEnvironment
[-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>]
[[-AzureDataLakeStoreFileSystemEndpointSuffix] <String>]
[[-AzureDataLakeAnalyticsCatalogAndJobEndpointSuffix] <String>]
[-EnableAdfsAuthentication]
[[-AdTenant] <String>]
[[-GraphAudience] <String>]
[[-DataLakeAudience] <String>]
[[-BatchEndpointResourceId] <String>]
[[-AzureOperationalInsightsEndpointResourceId] <String>]
[[-AzureOperationalInsightsEndpoint] <String>]
[-AzureAnalysisServicesEndpointSuffix <String>]
[-Scope <ContextModificationScope>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-AzureRmEnvironment
[-Name] <String>
[[-StorageEndpoint] <String>]
[-ARMEndpoint] <String>
[[-AzureKeyVaultDnsSuffix] <String>]
[[-AzureKeyVaultServiceEndpointResourceId] <String>]
[[-DataLakeAudience] <String>]
[[-BatchEndpointResourceId] <String>]
[[-AzureOperationalInsightsEndpointResourceId] <String>]
[[-AzureOperationalInsightsEndpoint] <String>]
[-Scope <ContextModificationScope>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Descrizione
Il cmdlet Add-AzureRmEnvironment aggiunge endpoint e metadati per consentire ai cmdlet di Azure Resource Manager di connettersi a una nuova istanza di Azure Resource Manager. Gli ambienti predefiniti AzureCloud e AzureChinaCloud hanno come destinazione le istanze pubbliche esistenti di Azure Resource Manager.
Esempio
Esempio 1: Creazione e modifica di un nuovo ambiente
PS C:\> Add-AzureRmEnvironment -Name TestEnvironment `
-ActiveDirectoryEndpoint TestADEndpoint `
-ActiveDirectoryServiceEndpointResourceId TestADApplicationId `
-ResourceManagerEndpoint TestRMEndpoint `
-GalleryEndpoint TestGalleryEndpoint `
-GraphEndpoint TestGraphEndpoint
Name Resource Manager Url ActiveDirectory Authority
---- -------------------- -------------------------
TestEnvironment TestRMEndpoint TestADEndpoint/
PS C:\> Set-AzureRmEnvironment -Name TestEnvironment `
-ActiveDirectoryEndpoint NewTestADEndpoint `
-GraphEndpoint NewTestGraphEndpoint | Format-List
Name : TestEnvironment
EnableAdfsAuthentication : False
OnPremise : False
ActiveDirectoryServiceEndpointResourceId : TestADApplicationId
AdTenant :
GalleryUrl : TestGalleryEndpoint
ManagementPortalUrl :
ServiceManagementUrl :
PublishSettingsFileUrl :
ResourceManagerUrl : TestRMEndpoint
SqlDatabaseDnsSuffix :
StorageEndpointSuffix :
ActiveDirectoryAuthority : NewTestADEndpoint
GraphUrl : NewTestGraphEndpoint
GraphEndpointResourceId :
TrafficManagerDnsSuffix :
AzureKeyVaultDnsSuffix :
DataLakeEndpointResourceId :
AzureDataLakeStoreFileSystemEndpointSuffix :
AzureDataLakeAnalyticsCatalogAndJobEndpointSuffix :
AzureKeyVaultServiceEndpointResourceId :
AzureOperationalInsightsEndpointResourceId :
AzureOperationalInsightsEndpoint :
AzureAnalysisServicesEndpointSuffix :
VersionProfiles : {}
ExtendedProperties : {}
BatchEndpointResourceId :
In this example we are creating a new Azure environment with sample endpoints using Add-AzureRmEnvironment, and then we are changing the value of the ActiveDirectoryEndpoint and GraphEndpoint attributes of the created environment using the cmdlet Set-AzureRmEnvironment.Parametri
-ActiveDirectoryEndpoint
Specifica l'autorità di base per l'autenticazione di Microsoft Entra.
| Tipo: | String |
| Aliases: | AdEndpointUrl, ActiveDirectory, ActiveDirectoryAuthority |
| Position: | 5 |
| valore predefinito: | None |
| Necessario: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ActiveDirectoryServiceEndpointResourceId
Specifica il gruppo di destinatari per i token che autenticano le richieste agli endpoint di Gestione risorse di Azure o di Gestione dei servizi (RDFE).
| Tipo: | String |
| Position: | 8 |
| valore predefinito: | None |
| Necessario: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-AdTenant
Specifica il tenant di Active Directory predefinito.
| Tipo: | String |
| Position: | 17 |
| valore predefinito: | None |
| Necessario: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ARMEndpoint
Endpoint di Azure Resource Manager
| Tipo: | String |
| Aliases: | ArmUrl |
| Position: | 1 |
| valore predefinito: | None |
| Necessario: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-AzureAnalysisServicesEndpointSuffix
Suffisso DNS degli endpoint del servizio Azure Analysis Services
| Tipo: | String |
| Position: | 15 |
| valore predefinito: | None |
| Necessario: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-AzureDataLakeAnalyticsCatalogAndJobEndpointSuffix
Suffisso DNS dei servizi di catalogo e processi di Azure Data Lake Analytics
| Tipo: | String |
| Position: | 15 |
| valore predefinito: | None |
| Necessario: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-AzureDataLakeStoreFileSystemEndpointSuffix
Suffisso DNS del file system di Azure Data Lake Store. Esempio: azuredatalake.net
| Tipo: | String |
| Position: | 14 |
| valore predefinito: | None |
| Necessario: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-AzureKeyVaultDnsSuffix
Specifica il suffisso del nome di dominio per i servizi di Key Vault.
| Tipo: | String |
| Position: | 10 |
| valore predefinito: | None |
| Necessario: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-AzureKeyVaultServiceEndpointResourceId
Specifica i destinatari per i token di accesso che autorizzano le richieste di servizi di Key Vault.
| Tipo: | String |
| Position: | 11 |
| valore predefinito: | None |
| Necessario: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-AzureOperationalInsightsEndpoint
Specifica l'endpoint per l'accesso alle query di Operational Insights.
| Tipo: | String |
| Position: | 22 |
| valore predefinito: | None |
| Necessario: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-AzureOperationalInsightsEndpointResourceId
Specifica il gruppo di destinatari per i token di accesso che autorizzano le richieste per i servizi Operational Insights.
| Tipo: | String |
| Position: | 21 |
| valore predefinito: | None |
| Necessario: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-BatchEndpointResourceId
Identificatore della risorsa del servizio Azure Batch che è il destinatario del token richiesto
| Tipo: | String |
| Aliases: | BatchResourceId, BatchAudience |
| Position: | 20 |
| valore predefinito: | None |
| Necessario: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Confirm
Richiede conferma prima di eseguire il cmdlet.
| Tipo: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| valore predefinito: | False |
| Necessario: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DataLakeAudience
Destinatari per i token che eseguono l'autenticazione con l'endpoint di Servizi Data Lake di AD.
| Tipo: | String |
| Aliases: | DataLakeEndpointResourceId, DataLakeResourceId |
| Position: | 19 |
| valore predefinito: | None |
| Necessario: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-DefaultProfile
Credeetnails, tenant e sottoscrizione usati per la comunicazione con Azure
| Tipo: | IAzureContextContainer |
| Aliases: | AzureRmContext, AzureCredential |
| Position: | Named |
| valore predefinito: | None |
| Necessario: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableAdfsAuthentication
Indica che è consentita l'autenticazione locale di Active Directory Federation Services (ADFS).
| Tipo: | SwitchParameter |
| Aliases: | OnPremise |
| Position: | 16 |
| valore predefinito: | None |
| Necessario: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-GalleryEndpoint
Specifica l'endpoint per la raccolta di modelli di distribuzione di Azure Resource Manager.
| Tipo: | String |
| Aliases: | Gallery, GalleryUrl |
| Position: | 7 |
| valore predefinito: | None |
| Necessario: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-GraphAudience
Destinatari per i token che eseguono l'autenticazione con l'endpoint graph di Active Directory.
| Tipo: | String |
| Aliases: | GraphEndpointResourceId, GraphResourceId |
| Position: | 18 |
| valore predefinito: | None |
| Necessario: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-GraphEndpoint
Specifica l'URL per le richieste graph (metadati di Active Directory).
| Tipo: | String |
| Aliases: | Graph, GraphUrl |
| Position: | 9 |
| valore predefinito: | None |
| Necessario: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ManagementPortalUrl
Specifica l'URL per il portale di gestione.
| Tipo: | String |
| Position: | 3 |
| valore predefinito: | None |
| Necessario: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
Specifica il nome dell'ambiente da aggiungere.
| Tipo: | String |
| Position: | 0 |
| valore predefinito: | None |
| Necessario: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PublishSettingsFileUrl
Specifica l'URL da cui è possibile scaricare i file con estensione publishsettings.
| Tipo: | String |
| Position: | 1 |
| valore predefinito: | None |
| Necessario: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ResourceManagerEndpoint
Specifica l'URL per le richieste di Azure Resource Manager.
| Tipo: | String |
| Aliases: | ResourceManager, ResourceManagerUrl |
| Position: | 6 |
| valore predefinito: | None |
| Necessario: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Scope
Determina l'ambito delle modifiche di contesto, ad esempio se le modifiche si applicano solo al processo corrente o a tutte le sessioni avviate dall'utente.
| Tipo: | ContextModificationScope |
| valori accettati: | Process, CurrentUser |
| Position: | Named |
| valore predefinito: | None |
| Necessario: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ServiceEndpoint
Specifica l'endpoint per le richieste rdFE (Service Management).
| Tipo: | String |
| Aliases: | ServiceManagement, ServiceManagementUrl |
| Position: | 2 |
| valore predefinito: | None |
| Necessario: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SqlDatabaseDnsSuffix
Specifica il suffisso domain-name per database SQL di Azure server.
| Tipo: | String |
| Position: | 13 |
| valore predefinito: | None |
| Necessario: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-StorageEndpoint
Specifica l'endpoint per l'accesso all'archiviazione (BLOB, tabella, coda e file).
| Tipo: | String |
| Aliases: | StorageEndpointSuffix |
| Position: | 4 |
| valore predefinito: | None |
| Necessario: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TrafficManagerDnsSuffix
Specifica il suffisso domain-name per i servizi di Gestione traffico di Azure.
| Tipo: | String |
| Position: | 12 |
| valore predefinito: | None |
| Necessario: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WhatIf
Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.
| Tipo: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| valore predefinito: | False |
| Necessario: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |