Condividi tramite


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
Alias:AdEndpointUrl, ActiveDirectory, ActiveDirectoryAuthority
Posizione:5
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly: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
Posizione:8
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-AdTenant

Specifica il tenant di Active Directory predefinito.

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

-ARMEndpoint

Endpoint di Azure Resource Manager

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

-AzureAnalysisServicesEndpointSuffix

Suffisso DNS degli endpoint del servizio Azure Analysis Services

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

-AzureDataLakeAnalyticsCatalogAndJobEndpointSuffix

Suffisso DNS dei servizi di processo e catalogo di Azure Data Lake Analitica

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

-AzureDataLakeStoreFileSystemEndpointSuffix

Suffisso DNS del file system di Azure Data Lake Store. Esempio: azuredatalake.net

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

-AzureKeyVaultDnsSuffix

Specifica il suffisso del nome di dominio per i servizi di Key Vault.

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

-AzureKeyVaultServiceEndpointResourceId

Specifica i destinatari per i token di accesso che autorizzano le richieste di servizi di Key Vault.

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

-AzureOperationalInsightsEndpoint

Specifica l'endpoint per l'accesso alle query di Operational Insights.

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

-AzureOperationalInsightsEndpointResourceId

Specifica il gruppo di destinatari per i token di accesso che autorizzano le richieste per i servizi Operational Insights.

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

-BatchEndpointResourceId

Identificatore della risorsa del servizio Azure Batch che è il destinatario del token richiesto

Tipo:String
Alias:BatchResourceId, BatchAudience
Posizione:20
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DataLakeAudience

Destinatari per i token che eseguono l'autenticazione con l'endpoint di Servizi Data Lake di AD.

Tipo:String
Alias:DataLakeEndpointResourceId, DataLakeResourceId
Posizione:19
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-DefaultProfile

Credeetnails, tenant e sottoscrizione usati per la comunicazione con Azure

Tipo:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-EnableAdfsAuthentication

Indica che è consentita l'autenticazione locale di Active Directory Federation Services (ADFS).

Tipo:SwitchParameter
Alias:OnPremise
Posizione:16
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-GalleryEndpoint

Specifica l'endpoint per la raccolta di modelli di distribuzione di Azure Resource Manager.

Tipo:String
Alias:Gallery, GalleryUrl
Posizione:7
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-GraphAudience

Destinatari per i token che eseguono l'autenticazione con l'endpoint graph di Active Directory.

Tipo:String
Alias:GraphEndpointResourceId, GraphResourceId
Posizione:18
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-GraphEndpoint

Specifica l'URL per le richieste graph (metadati di Active Directory).

Tipo:String
Alias:Graph, GraphUrl
Posizione:9
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ManagementPortalUrl

Specifica l'URL per il portale di gestione.

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

-Name

Specifica il nome dell'ambiente da aggiungere.

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

-PublishSettingsFileUrl

Specifica l'URL da cui è possibile scaricare i file con estensione publishsettings.

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

-ResourceManagerEndpoint

Specifica l'URL per le richieste di Azure Resource Manager.

Tipo:String
Alias:ResourceManager, ResourceManagerUrl
Posizione:6
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly: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
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ServiceEndpoint

Specifica l'endpoint per le richieste rdFE (Service Management).

Tipo:String
Alias:ServiceManagement, ServiceManagementUrl
Posizione:2
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-SqlDatabaseDnsSuffix

Specifica il suffisso domain-name per database SQL di Azure server.

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

-StorageEndpoint

Specifica l'endpoint per l'accesso all'archiviazione (BLOB, tabella, coda e file).

Tipo:String
Alias:StorageEndpointSuffix
Posizione:4
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-TrafficManagerDnsSuffix

Specifica il suffisso domain-name per i servizi di Gestione traffico di Azure.

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

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

String

SwitchParameter

Output

PSAzureEnvironment