Delen via


Set-AzEnvironment

Hiermee stelt u eigenschappen in voor een Azure-omgeving.

Syntax

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

Met de cmdlet Set-AzEnvironment worden eindpunten en metagegevens ingesteld om verbinding te maken met een exemplaar van Azure.

Voorbeelden

Voorbeeld 1: Een nieuwe omgeving maken en wijzigen

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 dit voorbeeld maken we een nieuwe Azure-omgeving met voorbeeldeindpunten met behulp van Add-AzEnvironment. Vervolgens wijzigen we de waarde van de kenmerken ActiveDirectoryEndpoint en GraphEndpoint van de gemaakte omgeving met behulp van de cmdlet Set-AzEnvironment.

Parameters

-ActiveDirectoryEndpoint

Hiermee geeft u de basisinstantie voor Azure Active Directory-verificatie.

Type:String
Aliases:AdEndpointUrl, ActiveDirectory, ActiveDirectoryAuthority
Position:5
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-ActiveDirectoryServiceEndpointResourceId

Hiermee geeft u de doelgroep op voor tokens die aanvragen verifiëren bij Azure Resource Manager- of Service Management-eindpunten (RDFE).

Type:String
Position:8
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-AdTenant

Hiermee geeft u de standaard Active Directory-tenant.

Type:String
Position:17
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-ARMEndpoint

Het Azure Resource Manager-eindpunt.

Type:String
Aliases:ArmUrl
Position:1
standaardwaarde:None
Vereist:True
Accept pipeline input:True
Accept wildcard characters:False

-AzureAnalysisServicesEndpointResourceId

De resource-id van de Azure Analysis Services-resource.

Type:String
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-AzureAnalysisServicesEndpointSuffix

Het eindpunt dat moet worden gebruikt bij het communiceren met de Azure Log Analytics-API.

Type:String
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-AzureAttestationServiceEndpointResourceId

De resource-id van de Azure Attestation-service die de ontvanger is van het aangevraagde token.

Type:String
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-AzureAttestationServiceEndpointSuffix

Dns-achtervoegsel van de Azure Attestation-service.

Type:String
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-AzureDataLakeAnalyticsCatalogAndJobEndpointSuffix

Dns-achtervoegsel van Azure Data Lake Analytics-taak- en catalogusservices

Type:String
Position:15
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-AzureDataLakeStoreFileSystemEndpointSuffix

Dns-achtervoegsel van Azure Data Lake Store FileSystem. Voorbeeld: azuredatalake.net

Type:String
Position:14
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-AzureKeyVaultDnsSuffix

Dns-achtervoegsel van de Azure Key Vault-service. Voorbeeld is vault-int.azure-int.net

Type:String
Position:10
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-AzureKeyVaultServiceEndpointResourceId

Resource-id van de Azure Key Vault-gegevensservice die de ontvanger is van het aangevraagde token.

Type:String
Position:11
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-AzureOperationalInsightsEndpoint

Het eindpunt dat moet worden gebruikt bij het communiceren met de Azure Log Analytics-API.

Type:String
Position:22
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-AzureOperationalInsightsEndpointResourceId

De doelgroep voor tokens die worden geverifieerd met de Azure Log Analytics-API.

Type:String
Position:21
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-AzureSynapseAnalyticsEndpointResourceId

De resource-id van de Azure Synapse Analytics die de ontvanger is van het aangevraagde token.

Type:String
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-AzureSynapseAnalyticsEndpointSuffix

Dns-achtervoegsel van Azure Synapse Analytics.

Type:String
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-BatchEndpointResourceId

De resource-id van de Azure Batch-service die de ontvanger is van het aangevraagde token

Type:String
Aliases:BatchResourceId, BatchAudience
Position:20
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliases:cf
Position:Named
standaardwaarde:False
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-ContainerRegistryEndpointSuffix

Achtervoegsel van Azure Container Registry.

Type:String
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-DataLakeAudience

De doelgroep voor tokens die worden geverifieerd met het EINDPUNT van ad Data Lake-services.

Type:String
Aliases:DataLakeEndpointResourceId, DataLakeResourceId
Position:19
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

De referenties, het account, de tenant en het abonnement die worden gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableAdfsAuthentication

Geeft aan dat on-premises verificatie van Active Directory Federation Services (ADFS) is toegestaan.

Type:SwitchParameter
Aliases:OnPremise
Position:16
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-GalleryEndpoint

Hiermee geeft u het eindpunt op voor de Azure Resource Manager-galerie met implementatiesjablonen. De parameter is het instellen van de waarde GalleryUrl op van PSAzureEnvironment. Zoals GalleryUrl wordt verwijderd uit ArmMetadata, biedt Azure PowerShell niet langer de waarde en wordt daarom niet meer aanbevolen om deze in te stellen GalleryEndpoint .

Type:String
Aliases:Gallery, GalleryUrl
Position:7
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-GraphAudience

De doelgroep voor tokens die worden geverifieerd met het AD Graph-eindpunt.

Type:String
Aliases:GraphEndpointResourceId, GraphResourceId
Position:18
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-GraphEndpoint

Hiermee geeft u de URL voor Graph-aanvragen (Active Directory-metagegevens) op.

Type:String
Aliases:Graph, GraphUrl
Position:9
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-ManagementPortalUrl

Hiermee geeft u de URL voor de beheerportal.

Type:String
Position:3
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-MicrosoftGraphEndpointResourceId

De resource-id van Microsoft Graph

Type:String
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-MicrosoftGraphUrl

Microsoft Graph Url

Type:String
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

Hiermee geeft u de naam van de omgeving die moet worden gewijzigd.

Type:String
Position:0
standaardwaarde:None
Vereist:True
Accept pipeline input:True
Accept wildcard characters:False

-PublishSettingsFileUrl

Hiermee geeft u de URL van waaruit .publishsettings-bestanden kunnen worden gedownload.

Type:String
Position:1
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceManagerEndpoint

Hiermee geeft u de URL voor Azure Resource Manager-aanvragen op.

Type:String
Aliases:ResourceManager, ResourceManagerUrl
Position:6
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-Scope

Bepaalt het bereik van contextwijzigingen, bijvoorbeeld of wijzigingen alleen van toepassing zijn op het huidige proces of op alle sessies die door deze gebruiker zijn gestart.

Type:ContextModificationScope
geaccepteerde waarden:Process, CurrentUser
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-ServiceEndpoint

Hiermee geeft u het eindpunt voor RDFE-aanvragen (Service Management).

Type:String
Aliases:ServiceManagement, ServiceManagementUrl
Position:2
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-SqlDatabaseDnsSuffix

Hiermee geeft u het achtervoegsel van de domeinnaam voor Azure SQL Database-servers.

Type:String
Position:13
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-StorageEndpoint

Hiermee geeft u het eindpunt voor opslagtoegang (blob, tabel, wachtrij en bestand).

Type:String
Aliases:StorageEndpointSuffix
Position:4
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-TrafficManagerDnsSuffix

Hiermee geeft u het achtervoegsel van de domeinnaam voor Azure Traffic Manager-services op.

Type:String
Position:12
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliases:wi
Position:Named
standaardwaarde:False
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

Invoerwaarden

String

SwitchParameter

Uitvoerwaarden

PSAzureEnvironment