Set-AzEnvironment
Imposta le proprietà per un ambiente Azure.
Sintassi
Name (Impostazione predefinita)
Set-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>]
[[-AdTenant] <String>]
[[-GraphAudience] <String>]
[[-DataLakeAudience] <String>]
[[-BatchEndpointResourceId] <String>]
[[-AzureOperationalInsightsEndpointResourceId] <String>]
[[-AzureOperationalInsightsEndpoint] <String>]
[-EnableAdfsAuthentication]
[-AzureAnalysisServicesEndpointSuffix <String>]
[-AzureAnalysisServicesEndpointResourceId <String>]
[-AzureAttestationServiceEndpointSuffix <String>]
[-AzureAttestationServiceEndpointResourceId <String>]
[-AzureSynapseAnalyticsEndpointSuffix <String>]
[-ContainerRegistryEndpointSuffix <String>]
[-AzureSynapseAnalyticsEndpointResourceId <String>]
[-MicrosoftGraphEndpointResourceId <String>]
[-MicrosoftGraphUrl <String>]
[-SshAuthScope <String>]
[-Scope <ContextModificationScope>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ARMEndpoint
Set-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>]
Descrizione
Il cmdlet Set-AzEnvironment imposta endpoint e metadati per la connessione a un'istanza di Azure.
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
ActiveDirectoryServiceEndpointResourceId : TestADApplicationId
AdTenant :
GalleryUrl : TestGalleryEndpoint
ManagementPortalUrl :
ServiceManagementUrl :
PublishSettingsFileUrl :
ResourceManagerUrl : TestRMEndpoint
SqlDatabaseDnsSuffix :
StorageEndpointSuffix :
ActiveDirectoryAuthority : NewTestADEndpoint
GraphUrl : NewTestGraphEndpoint
GraphEndpointResourceId :
TrafficManagerDnsSuffix :
AzureKeyVaultDnsSuffix :
AzureDataLakeStoreFileSystemEndpointSuffix :
AzureDataLakeAnalyticsCatalogAndJobEndpointSuffix :
AzureKeyVaultServiceEndpointResourceId :
BatchEndpointResourceId :
AzureOperationalInsightsEndpoint :
AzureOperationalInsightsEndpointResourceId :
AzureAttestationServiceEndpointSuffix :
AzureAttestationServiceEndpointResourceId :
AzureSynapseAnalyticsEndpointSuffix :
AzureSynapseAnalyticsEndpointResourceId :
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.
Parametri
-ActiveDirectoryEndpoint
Specifica l'autorità di base per l'autenticazione Azure Active Directory.
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Alias: AdEndpointUrl, Istanza di ActiveDirectory, ActiveDirectoryAuthority
Set di parametri
Name
Posizione: 5
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
-ActiveDirectoryServiceEndpointResourceId
Specifica il gruppo di destinatari per i token che autenticano le richieste a Azure Resource Manager o agli endpoint di gestione dei servizi (RDFE).
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
Name
Posizione: 8
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
-AdTenant
Specifica il tenant Active Directory predefinito.
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
Name
Posizione: 17
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
-ARMEndpoint
Endpoint Azure Resource Manager.
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Alias: ArmUrl
Set di parametri
ARMEndpoint
Posizione: 1
Obbligatorio: True
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
-AzureAnalysisServicesEndpointResourceId
Identificatore di risorsa della risorsa Azure Analysis Services.
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
(All)
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-AzureAnalysisServicesEndpointSuffix
Endpoint da usare per la comunicazione con l'API Azure Log Analytics.
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
(All)
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-AzureAttestationServiceEndpointResourceId
Identificatore della risorsa del servizio Azure Attestation che è il destinatario del token richiesto.
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
(All)
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
-AzureAttestationServiceEndpointSuffix
Suffisso DNS del servizio Azure Attestation.
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
(All)
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
-AzureDataLakeAnalyticsCatalogAndJobEndpointSuffix
Suffisso DNS di Azure Data Lake Analytics processi e servizi di catalogo
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
Name
Posizione: 15
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
-AzureDataLakeStoreFileSystemEndpointSuffix
Suffisso DNS di Azure Data Lake Store FileSystem. Esempio: azuredatalake.net
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
Name
Posizione: 14
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
-AzureKeyVaultDnsSuffix
Suffisso DNS del servizio Azure Key Vault. L'esempio è vault-int.azure-int.net
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
(All)
Posizione: 10
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
-AzureKeyVaultServiceEndpointResourceId
Identificatore della risorsa di Azure Key Vault servizio dati che è il destinatario del token richiesto.
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
(All)
Posizione: 11
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
-AzureOperationalInsightsEndpoint
Endpoint da usare per la comunicazione con l'API Azure Log Analytics.
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
(All)
Posizione: 22
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
-AzureOperationalInsightsEndpointResourceId
Destinatari per i token che eseguono l'autenticazione con l'API Azure Log Analytics.
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
(All)
Posizione: 21
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
-AzureSynapseAnalyticsEndpointResourceId
Identificatore della risorsa del Azure Synapse Analytics che è il destinatario del token richiesto.
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
(All)
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
-AzureSynapseAnalyticsEndpointSuffix
Suffisso DNS di Azure Synapse Analytics.
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
(All)
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
-BatchEndpointResourceId
Identificatore della risorsa del servizio Azure Batch che è il destinatario del token richiesto
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Alias: BatchResourceId, BatchAudience
Set di parametri
(All)
Posizione: 20
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
-Confirm
Richiede conferma prima di eseguire il cmdlet.
Proprietà dei parametri
Tipo: SwitchParameter
Valore predefinito: False
Supporta i caratteri jolly: False
DontShow: False
Alias: Cfr
Set di parametri
(All)
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-ContainerRegistryEndpointSuffix
Suffisso di Azure Container Registry.
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
(All)
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
-DataLakeAudience
Destinatari per i token che eseguono l'autenticazione con l'endpoint dei servizi di Active Directory Data Lake.
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Alias: DataLakeEndpointResourceId, DataLakeResourceId
Set di parametri
(All)
Posizione: 19
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
-DefaultProfile
Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.
Proprietà dei parametri
Tipo: IAzureContextContainer
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Alias: AzContext, AzureRmContext, AzureCredential
Set di parametri
(All)
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-EnableAdfsAuthentication
Indica che è consentita l'autenticazione locale di Active Directory Federation Services (ADFS).
Proprietà dei parametri
Tipo: SwitchParameter
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Alias: OnPremise
Set di parametri
Name
Posizione: 16
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
-GalleryEndpoint
Specifica l'endpoint per la raccolta Azure Resource Manager di modelli di distribuzione.
Il parametro consiste nell'impostare il valore su di . Poiché GalleryUrl viene rimosso da ArmMetadata, Azure PowerShell non fornirà più il valore e pertanto non è più consigliabile impostare GalleryEndpoint.
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Alias: Galleria, GalleryUrl
Set di parametri
Name
Posizione: 7
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
-GraphAudience
Destinatari per i token che eseguono l'autenticazione con l'endpoint graph di Active Directory.
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Alias: GraphEndpointResourceId, GraphResourceId
Set di parametri
Name
Posizione: 18
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
-GraphEndpoint
Specifica l'URL per le richieste graph (metadati Active Directory).
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Alias: Graph, GraphUrl
Set di parametri
Name
Posizione: 9
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
-ManagementPortalUrl
Specifica l'URL per il portale di gestione.
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
Name
Posizione: 3
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
-MicrosoftGraphEndpointResourceId
Identificatore della risorsa di Microsoft Graph
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
Name
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
-MicrosoftGraphUrl
URL Microsoft Graph
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
Name
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
-Name
Specifica il nome dell'ambiente da modificare.
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
(All)
Posizione: 0
Obbligatorio: True
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
-PublishSettingsFileUrl
Specifica l'URL da cui è possibile scaricare i file con estensione publishsettings.
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
Name
Posizione: 1
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
-ResourceManagerEndpoint
Specifica l'URL per le richieste di Azure Resource Manager.
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Alias: ResourceManager, ResourceManagerUrl
Set di parametri
Name
Posizione: 6
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: 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.
Proprietà dei parametri
Tipo: ContextModificationScope
Valore predefinito: None
Valori accettati: Process, CurrentUser
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
(All)
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-ServiceEndpoint
Specifica l'endpoint per le richieste rdFE (Service Management).
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Alias: ServiceManagement, ServiceManagementUrl
Set di parametri
Name
Posizione: 2
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
-SqlDatabaseDnsSuffix
Specifica il suffisso domain-name per i server Azure SQL Database.
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
Name
Posizione: 13
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
-SshAuthScope
Ambito per l'autenticazione quando si esegue SSH in una macchina virtuale Azure.
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
Name
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
-StorageEndpoint
Specifica l'endpoint per l'accesso all'archiviazione (BLOB, tabella, coda e file).
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Alias: StorageEndpointSuffix
Set di parametri
(All)
Posizione: 4
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-TrafficManagerDnsSuffix
Specifica il suffisso domain-name per i servizi di Azure Traffic Manager.
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
Name
Posizione: 12
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
-WhatIf
Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.
Proprietà dei parametri
Tipo: SwitchParameter
Valore predefinito: False
Supporta i caratteri jolly: False
DontShow: False
Alias: Wi
Set di parametri
(All)
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.
Output