Sdílet prostřednictvím


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 PSAzureEnvironmenthodnotu . 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

Vstupy

String

SwitchParameter

Výstupy

PSAzureEnvironment