Set-AzEnvironment
Nastaví vlastnosti pro prostředí Azure.
Syntaxe
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>]
[-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>]
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>]
Description
Rutina Set-AzEnvironment nastavuje koncové body a metadata pro připojení k instanci Azure.
Příklady
Příklad 1: Vytvoření a úprava nového prostředí
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 :
V tomto příkladu vytváříme nové prostředí Azure s ukázkovými koncovými body pomocí Add-AzEnvironmentu a pak měníme hodnotu atributů ActiveDirectoryEndpoint a GraphEndpoint vytvořeného prostředí pomocí rutiny Set-AzEnvironment.
Parametry
-ActiveDirectoryEndpoint
Určuje základní autoritu pro ověřování Azure Active Directory.
Typ: | String |
Aliasy: | AdEndpointUrl, ActiveDirectory, ActiveDirectoryAuthority |
Position: | 5 |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-ActiveDirectoryServiceEndpointResourceId
Určuje cílovou skupinu pro tokeny, které ověřují požadavky na koncové body Azure Resource Manageru nebo správy služeb (RDFE).
Typ: | String |
Position: | 8 |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-AdTenant
Určuje výchozího tenanta služby Active Directory.
Typ: | String |
Position: | 17 |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-ARMEndpoint
Koncový bod Azure Resource Manageru
Typ: | String |
Aliasy: | ArmUrl |
Position: | 1 |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-AzureAnalysisServicesEndpointResourceId
Identifikátor prostředku služby Azure Analysis Services.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-AzureAnalysisServicesEndpointSuffix
Koncový bod, který se má použít při komunikaci s rozhraním API služby Azure Log Analytics.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-AzureAttestationServiceEndpointResourceId
Identifikátor prostředku služby Azure Attestation, která je příjemcem požadovaného tokenu.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-AzureAttestationServiceEndpointSuffix
Přípona DNS služby Azure Attestation.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-AzureDataLakeAnalyticsCatalogAndJobEndpointSuffix
Přípona DNS pro úlohy a katalogové služby Azure Data Lake Analytics
Typ: | String |
Position: | 15 |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-AzureDataLakeStoreFileSystemEndpointSuffix
Přípona DNS systému souborů Azure Data Lake Store Příklad: azuredatalake.net
Typ: | String |
Position: | 14 |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-AzureKeyVaultDnsSuffix
Přípona DNS služby Azure Key Vault Příklad je vault-int.azure-int.net
Typ: | String |
Position: | 10 |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-AzureKeyVaultServiceEndpointResourceId
Identifikátor prostředku datové služby Azure Key Vault, která je příjemcem požadovaného tokenu.
Typ: | String |
Position: | 11 |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-AzureOperationalInsightsEndpoint
Koncový bod, který se má použít při komunikaci s rozhraním API služby Azure Log Analytics.
Typ: | String |
Position: | 22 |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-AzureOperationalInsightsEndpointResourceId
Cílová skupina pro tokeny ověřující pomocí rozhraní API služby Azure Log Analytics
Typ: | String |
Position: | 21 |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-AzureSynapseAnalyticsEndpointResourceId
Identifikátor prostředku služby Azure Synapse Analytics, který je příjemcem požadovaného tokenu.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-AzureSynapseAnalyticsEndpointSuffix
Přípona DNS služby Azure Synapse Analytics
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-BatchEndpointResourceId
Identifikátor prostředku služby Azure Batch, která je příjemcem požadovaného tokenu
Typ: | String |
Aliasy: | BatchResourceId, BatchAudience |
Position: | 20 |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-Confirm
Před spuštěním rutiny zobrazí výzvu k potvrzení.
Typ: | SwitchParameter |
Aliasy: | cf |
Position: | Named |
Default value: | False |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-ContainerRegistryEndpointSuffix
Přípona služby Azure Container Registry
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-DataLakeAudience
Cílová skupina tokenů, které se ověřují pomocí koncového bodu služby AD Data Lake
Typ: | String |
Aliasy: | DataLakeEndpointResourceId, DataLakeResourceId |
Position: | 19 |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-DefaultProfile
Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.
Typ: | IAzureContextContainer |
Aliasy: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-EnableAdfsAuthentication
Označuje, že je povolené místní ověřování Active Directory Federation Services (AD FS) (ADFS).
Typ: | SwitchParameter |
Aliasy: | OnPremise |
Position: | 16 |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-GalleryEndpoint
Určuje koncový bod pro galerii šablon nasazení Azure Resource Manageru.
Parametr je nastavit hodnotu na GalleryUrl
PSAzureEnvironment
hodnotu . Jak GalleryUrl
je odebráno z ArmMetadata, Azure PowerShell už tuto hodnotu nezadá a proto se už nedoporučuje nastavit GalleryEndpoint
.
Typ: | String |
Aliasy: | Gallery, GalleryUrl |
Position: | 7 |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-GraphAudience
Cílová skupina pro tokeny ověřující pomocí koncového bodu grafu AD.
Typ: | String |
Aliasy: | GraphEndpointResourceId, GraphResourceId |
Position: | 18 |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-GraphEndpoint
Určuje adresu URL pro požadavky Graphu (metadata služby Active Directory).
Typ: | String |
Aliasy: | Graph, GraphUrl |
Position: | 9 |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-ManagementPortalUrl
Určuje adresu URL portálu pro správu.
Typ: | String |
Position: | 3 |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-MicrosoftGraphEndpointResourceId
Identifikátor prostředku Microsoft Graphu
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-MicrosoftGraphUrl
Adresa URL Microsoft Graphu
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-Name
Určuje název prostředí, které se má upravit.
Typ: | String |
Position: | 0 |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-PublishSettingsFileUrl
Určuje adresu URL, ze které lze stáhnout soubory .publishsettings.
Typ: | String |
Position: | 1 |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-ResourceManagerEndpoint
Určuje adresu URL pro požadavky Azure Resource Manageru.
Typ: | String |
Aliasy: | ResourceManager, ResourceManagerUrl |
Position: | 6 |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-Scope
Určuje rozsah změn kontextu, například zda se změny vztahují pouze na aktuální proces, nebo na všechny relace spuštěné tímto uživatelem.
Typ: | ContextModificationScope |
Přípustné hodnoty: | Process, CurrentUser |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-ServiceEndpoint
Určuje koncový bod pro požadavky správy služeb (RDFE).
Typ: | String |
Aliasy: | ServiceManagement, ServiceManagementUrl |
Position: | 2 |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-SqlDatabaseDnsSuffix
Určuje příponu názvu domény pro servery Azure SQL Database.
Typ: | String |
Position: | 13 |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-StorageEndpoint
Určuje koncový bod pro přístup k úložišti (přístup k objektům blob, tabulce, frontě a souboru).
Typ: | String |
Aliasy: | StorageEndpointSuffix |
Position: | 4 |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-TrafficManagerDnsSuffix
Určuje příponu názvu domény pro služby Azure Traffic Manager.
Typ: | String |
Position: | 12 |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-WhatIf
Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.
Typ: | SwitchParameter |
Aliasy: | wi |
Position: | Named |
Default value: | False |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |