Set-AzureRmEnvironment

Hiermee stelt u eigenschappen in voor een Azure-omgeving.

Waarschuwing

De AzureRM PowerShell-module is vanaf 29 februari 2024 officieel afgeschaft. Gebruikers wordt aangeraden om van AzureRM naar de Az PowerShell-module te migreren om ondersteuning en updates te garanderen.

Hoewel de AzureRM-module nog steeds kan functioneren, wordt deze niet meer onderhouden of ondersteund, waardoor het gebruik naar eigen goeddunken en risico van de gebruiker blijft bestaan. Raadpleeg onze migratiebronnen voor hulp bij de overgang naar de Az-module.

Syntax

Set-AzureRmEnvironment
   [-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>]
   [-Scope <ContextModificationScope>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzureRmEnvironment
   [-Name] <String>
   [[-StorageEndpoint] <String>]
   [-ARMEndpoint] <String>
   [[-AzureKeyVaultDnsSuffix] <String>]
   [[-AzureKeyVaultServiceEndpointResourceId] <String>]
   [[-DataLakeAudience] <String>]
   [[-BatchEndpointResourceId] <String>]
   [[-AzureOperationalInsightsEndpointResourceId] <String>]
   [[-AzureOperationalInsightsEndpoint] <String>]
   [-Scope <ContextModificationScope>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

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

Voorbeelden

Voorbeeld 1: Een nieuwe omgeving maken en wijzigen

PS C:\> Add-AzureRmEnvironment -Name TestEnvironment `
        -ActiveDirectoryEndpoint TestADEndpoint `
        -ActiveDirectoryServiceEndpointResourceId TestADApplicationId `
        -ResourceManagerEndpoint TestRMEndpoint `
        -GalleryEndpoint TestGalleryEndpoint `
        -GraphEndpoint TestGraphEndpoint

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

PS C:\> Set-AzureRmEnvironment -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        :

In dit voorbeeld maken we een nieuwe Azure-omgeving met voorbeeldeindpunten met behulp van Add-AzureRmEnvironment. Vervolgens wijzigen we de waarde van de kenmerken ActiveDirectoryEndpoint en GraphEndpoint van de gemaakte omgeving met behulp van de cmdlet Set-AzureRmEnvironment.

Parameters

-ActiveDirectoryEndpoint

Hiermee geeft u de basisinstantie voor Microsoft Entra-verificatie.

Type:String
Aliases:AdEndpointUrl, ActiveDirectory, ActiveDirectoryAuthority
Position:5
Default value:None
Required: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
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-AdTenant

Hiermee geeft u de standaard Active Directory-tenant.

Type:String
Position:17
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ARMEndpoint

Het Azure Resource Manager-eindpunt.

Type:String
Aliases:ArmUrl
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-AzureAnalysisServicesEndpointSuffix

Dns-achtervoegsel van Azure Analysis Services-service-eindpunten

Type:String
Position:15
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-AzureDataLakeAnalyticsCatalogAndJobEndpointSuffix

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

Type:String
Position:15
Default value:None
Required: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
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-AzureKeyVaultDnsSuffix

Hiermee geeft u het achtervoegsel van de domeinnaam voor Key Vault-services.

Type:String
Position:10
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-AzureKeyVaultServiceEndpointResourceId

Hiermee geeft u de doelgroep op voor toegangstokens die aanvragen voor Key Vault-services autoriseren.

Type:String
Position:11
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-AzureOperationalInsightsEndpoint

Hiermee geeft u het eindpunt voor de querytoegang van Operational Insights op.

Type:String
Position:22
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-AzureOperationalInsightsEndpointResourceId

Hiermee geeft u de doelgroep op voor toegangstokens die aanvragen voor Operational Insights-services autoriseren.

Type:String
Position:21
Default value:None
Required: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
Default value:None
Required: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
Default value:False
Required:False
Accept pipeline input:False
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
Default value:None
Required: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:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required: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
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-GalleryEndpoint

Hiermee geeft u het eindpunt op voor de Azure Resource Manager-galerie met implementatiesjablonen.

Type:String
Aliases:Gallery, GalleryUrl
Position:7
Default value:None
Required: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
Default value:None
Required: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
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ManagementPortalUrl

Hiermee geeft u de URL voor de beheerportal.

Type:String
Position:3
Default value:None
Required: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
Default value:None
Required: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
Default value:None
Required: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
Default value:None
Required: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
Accepted values:Process, CurrentUser
Position:Named
Default value:None
Required: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
Default value:None
Required: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
Default value:None
Required: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
Default value:None
Required: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
Default value:None
Required: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
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Invoerwaarden

String

SwitchParameter

Uitvoerwaarden

PSAzureEnvironment