Add-AzEnvironment

Modulo:

Az.Accounts

Aggiunge endpoint e metadati per un'istanza di Azure Resource Manager.

Sintassi

Add-AzEnvironment
   [-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>]
   [-AzureAnalysisServicesEndpointResourceId <String>]
   [-AzureAttestationServiceEndpointSuffix <String>]
   [-AzureAttestationServiceEndpointResourceId <String>]
   [-AzureSynapseAnalyticsEndpointSuffix <String>]
   [-ContainerRegistryEndpointSuffix <String>]
   [-AzureSynapseAnalyticsEndpointResourceId <String>]
   [-MicrosoftGraphEndpointResourceId <String>]
   [-MicrosoftGraphUrl <String>]
   [-Scope <ContextModificationScope>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-AzEnvironment
   [-Name] <String>
   [[-StorageEndpoint] <String>]
   [-ARMEndpoint] <String>
   [[-AzureKeyVaultDnsSuffix] <String>]
   [[-AzureKeyVaultServiceEndpointResourceId] <String>]
   [[-DataLakeAudience] <String>]
   [[-BatchEndpointResourceId] <String>]
   [[-AzureOperationalInsightsEndpointResourceId] <String>]
   [[-AzureOperationalInsightsEndpoint] <String>]
   [-AzureAnalysisServicesEndpointSuffix <String>]
   [-AzureAnalysisServicesEndpointResourceId <String>]
   [-AzureAttestationServiceEndpointSuffix <String>]
   [-AzureAttestationServiceEndpointResourceId <String>]
   [-AzureSynapseAnalyticsEndpointSuffix <String>]
   [-ContainerRegistryEndpointSuffix <String>]
   [-AzureSynapseAnalyticsEndpointResourceId <String>]
   [-Scope <ContextModificationScope>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-AzEnvironment
   [-AutoDiscover]
   [-Uri <Uri>]
   [-Scope <ContextModificationScope>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Descrizione

Il cmdlet Add-AzEnvironment aggiunge endpoint e metadati per consentire ai cmdlet di Azure Resource Manager di connettersi con 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

Add-AzEnvironment -Name TestEnvironment `
        -ActiveDirectoryEndpoint TestADEndpoint `
        -ActiveDirectoryServiceEndpointResourceId TestADApplicationId `
        -ResourceManagerEndpoint TestRMEndpoint `
        -GalleryEndpoint TestGalleryEndpoint `
        -GraphEndpoint TestGraphEndpoint

Name            Resource Manager Url ActiveDirectory Authority
----            -------------------- -------------------------
TestEnvironment TestRMEndpoint       TestADEndpoint/

Set-AzEnvironment -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               :
AzureAttestationServiceEndpointSuffix             :
AzureAttestationServiceEndpointResourceId         :
AzureSynapseAnalyticsEndpointSuffix               :
AzureSynapseAnalyticsEndpointResourceId           :
VersionProfiles                                   : {}
ExtendedProperties                                : {}
BatchEndpointResourceId                           :

In questo esempio viene creato un nuovo ambiente Azure con endpoint di esempio usando Add-AzEnvironment e quindi si sta modificando il valore degli attributi ActiveDirectoryEndpoint e GraphEndpoint dell'ambiente creato usando il cmdlet Set-AzEnvironment.

Esempio 2: Individuazione di un nuovo ambiente tramite Uri

<#
Uri https://configuredmetadata.net returns an array of environment metadata. The following example contains a payload for the AzureCloud default environment.

[
  {
    "portal": "https://portal.azure.com",
    "authentication": {
      "loginEndpoint": "https://login.microsoftonline.com/",
      "audiences": [
        "https://management.core.windows.net/"
      ],
      "tenant": "common",
      "identityProvider": "AAD"
    },
    "media": "https://rest.media.azure.net",
    "graphAudience": "https://graph.windows.net/",
    "graph": "https://graph.windows.net/",
    "name": "AzureCloud",
    "suffixes": {
      "azureDataLakeStoreFileSystem": "azuredatalakestore.net",
      "acrLoginServer": "azurecr.io",
      "sqlServerHostname": ".database.windows.net",
      "azureDataLakeAnalyticsCatalogAndJob": "azuredatalakeanalytics.net",
      "keyVaultDns": "vault.azure.net",
      "storage": "core.windows.net",
      "azureFrontDoorEndpointSuffix": "azurefd.net"
    },
    "batch": "https://batch.core.windows.net/",
    "resourceManager": "https://management.azure.com/",
    "vmImageAliasDoc": "https://raw.githubusercontent.com/Azure/azure-rest-api-specs/master/arm-compute/quickstart-templates/aliases.json",
    "activeDirectoryDataLake": "https://datalake.azure.net/",
    "sqlManagement": "https://management.core.windows.net:8443/",
    "gallery": "https://gallery.azure.com/"
  },
……
]
#>

Add-AzEnvironment -AutoDiscover -Uri https://configuredmetadata.net

Name            Resource Manager Url ActiveDirectory Authority
----            -------------------- -------------------------
TestEnvironment TestRMEndpoint       TestADEndpoint/

In questo esempio viene individuato un nuovo ambiente Azure dall'URI https://configuredmetadata.net .

Parametri

-ActiveDirectoryEndpoint

Specifica l'autorità di base per l'autenticazione di Azure Active Directory.

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

-AutoDiscover

Individua gli ambienti tramite l'endpoint predefinito o configurato.

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

-AzureAnalysisServicesEndpointResourceId

Identificatore della risorsa di Azure Analysis Services.

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

-AzureAnalysisServicesEndpointSuffix

Endpoint da usare per la comunicazione con l'API Di Azure Log Analytics.

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

-AzureAttestationServiceEndpointResourceId

Identificatore della risorsa del servizio attestazione di Azure che è il destinatario del token richiesto.

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

-AzureAttestationServiceEndpointSuffix

Suffisso DNS del servizio attestazione di Azure.

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

-AzureDataLakeAnalyticsCatalogAndJobEndpointSuffix

Suffisso DNS dei servizi di catalogo e processi di Azure Data Lake Analytics

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

Suffisso DNS del servizio Azure Key Vault. L'esempio è vault-int.azure-int.net

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

-AzureKeyVaultServiceEndpointResourceId

Identificatore di risorsa del servizio dati di Azure Key Vault che è il destinatario del token richiesto.

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

-AzureOperationalInsightsEndpoint

Endpoint da usare per la comunicazione con l'API Di Azure Log Analytics.

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

-AzureOperationalInsightsEndpointResourceId

Destinatari dei token che eseguono l'autenticazione con l'API di Azure Log Analytics.

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

-AzureSynapseAnalyticsEndpointResourceId

Identificatore della risorsa di Azure Synapse Analytics che è il destinatario del token richiesto.

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

-AzureSynapseAnalyticsEndpointSuffix

Suffisso DNS di Azure Synapse Analytics.

Tipo:	String
Posizione:	Named
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

-ContainerRegistryEndpointSuffix

Suffisso di Registro Azure Container.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
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

Credenziali, tenant e sottoscrizione usate per la comunicazione con Azure

Tipo:	IAzureContextContainer
Alias:	AzContext, 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. Il parametro consiste nell'impostare il valore su GalleryUrl di PSAzureEnvironment. Poiché GalleryUrl viene rimosso da ArmMetadata, Azure PowerShell non fornirà più il valore e pertanto non è più consigliabile impostare GalleryEndpoint .

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

-MicrosoftGraphEndpointResourceId

Identificatore della risorsa di Microsoft Graph

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

-MicrosoftGraphUrl

Microsoft Graph Url

Tipo:	String
Posizione:	Named
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

-Uri

Specifica l'URI della risorsa Internet per recuperare gli ambienti.

Tipo:	Uri
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
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

Collegamenti correlati

• Get-AzEnvironment
• Remove-AzEnvironment
• Set-AzEnvironment