Add-AzEnvironment

Module:

Az.Accounts

Hiermee worden eindpunten en metagegevens toegevoegd voor een exemplaar van Azure Resource Manager.

Notitie

Dit is de vorige versie van onze documentatie. Raadpleeg de meest recente versie voor actuele informatie.

Syntax

Add-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>]

Add-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>]

Add-AzEnvironment
   [-AutoDiscover]
   [-Uri <Uri>]
   [-Scope <ContextModificationScope>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Met de Add-AzEnvironment cmdlet worden eindpunten en metagegevens toegevoegd om Azure Resource Manager-cmdlets in staat te stellen verbinding te maken met een nieuw exemplaar van Azure Resource Manager. De ingebouwde omgevingen AzureCloud en AzureChinaCloud zijn gericht op bestaande openbare exemplaren van Azure Resource Manager.

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
OnPremise                                         : False
ActiveDirectoryServiceEndpointResourceId          : TestADApplicationId
AdTenant                                          :
GalleryUrl                                        : TestGalleryEndpoint
ManagementPortalUrl                               :
ServiceManagementUrl                              :
PublishSettingsFileUrl                            :
ResourceManagerUrl                                : TestRMEndpoint
SqlDatabaseDnsSuffix                              :
StorageEndpointSuffix                             :
ActiveDirectoryAuthority                          : NewTestADEndpoint
GraphUrl                                          : NewTestGraphEndpoint
GraphEndpointResourceId                           :
TrafficManagerDnsSuffix                           :
AzureKeyVaultDnsSuffix                            :
DataLakeEndpointResourceId                        :
AzureDataLakeStoreFileSystemEndpointSuffix        :
AzureDataLakeAnalyticsCatalogAndJobEndpointSuffix :
AzureKeyVaultServiceEndpointResourceId            :
AzureOperationalInsightsEndpointResourceId        :
AzureOperationalInsightsEndpoint                  :
AzureAnalysisServicesEndpointSuffix               :
AzureAttestationServiceEndpointSuffix             :
AzureAttestationServiceEndpointResourceId         :
AzureSynapseAnalyticsEndpointSuffix               :
AzureSynapseAnalyticsEndpointResourceId           :
VersionProfiles                                   : {}
ExtendedProperties                                : {}
BatchEndpointResourceId                           :

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.

Voorbeeld 2: Een nieuwe omgeving detecteren via Uri

<#
Uri https://configuredmetadata.net returns an array of environment metadata. The following example contains a payload for the AzureCloud default environment.

[
  {
    "portal": "https://portal.azure.com",
    "authentication": {
      "loginEndpoint": "https://login.microsoftonline.com/",
      "audiences": [
        "https://management.core.windows.net/"
      ],
      "tenant": "common",
      "identityProvider": "AAD"
    },
    "media": "https://rest.media.azure.net",
    "graphAudience": "https://graph.windows.net/",
    "graph": "https://graph.windows.net/",
    "name": "AzureCloud",
    "suffixes": {
      "azureDataLakeStoreFileSystem": "azuredatalakestore.net",
      "acrLoginServer": "azurecr.io",
      "sqlServerHostname": ".database.windows.net",
      "azureDataLakeAnalyticsCatalogAndJob": "azuredatalakeanalytics.net",
      "keyVaultDns": "vault.azure.net",
      "storage": "core.windows.net",
      "azureFrontDoorEndpointSuffix": "azurefd.net"
    },
    "batch": "https://batch.core.windows.net/",
    "resourceManager": "https://management.azure.com/",
    "vmImageAliasDoc": "https://raw.githubusercontent.com/Azure/azure-rest-api-specs/master/arm-compute/quickstart-templates/aliases.json",
    "activeDirectoryDataLake": "https://datalake.azure.net/",
    "sqlManagement": "https://management.core.windows.net:8443/",
    "gallery": "https://gallery.azure.com/"
  },
……
]
#>

Add-AzEnvironment -AutoDiscover -Uri https://configuredmetadata.net

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

In dit voorbeeld detecteren we een nieuwe Azure-omgeving vanuit de https://configuredmetadata.net URI.

Parameters

-ActiveDirectoryEndpoint

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

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

-ActiveDirectoryServiceEndpointResourceId

Hiermee geeft u de doelgroep op voor tokens waarmee aanvragen worden geverifieerd bij Azure Resource Manager- of RDFE-eindpunten (Service Management).

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

-AdTenant

Hiermee geeft u de standaard Active Directory-tenant.

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

-ARMEndpoint

Het Azure Resource Manager-eindpunt

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

-AutoDiscover

Detecteert omgevingen via standaard of geconfigureerd eindpunt.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-AzureAnalysisServicesEndpointResourceId

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

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

-AzureAttestationServiceEndpointSuffix

Dns-achtervoegsel van Azure Attestation service.

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

-AzureKeyVaultDnsSuffix

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

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

-AzureKeyVaultServiceEndpointResourceId

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

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

-AzureSynapseAnalyticsEndpointSuffix

Dns-achtervoegsel van Azure Synapse Analytics.

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

-ContainerRegistryEndpointSuffix

Achtervoegsel van Azure Container Registry.

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

-DataLakeAudience

De doelgroep voor tokens die worden geverifieerd met het AD Data Lake-services-eindpunt.

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

-DefaultProfile

De referenties, tenant en abonnementen die worden gebruikt voor communicatie met Azure

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

-GalleryEndpoint

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

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

-ManagementPortalUrl

Hiermee geeft u de URL voor de beheerportal.

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

-MicrosoftGraphEndpointResourceId

De resource-id van Microsoft Graph

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

-MicrosoftGraphUrl

Microsoft Graph Url

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

-Name

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

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

-StorageEndpoint

Hiermee geeft u het eindpunt op voor toegang tot opslag (blob, tabel, wachtrij en bestand).

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

-Uri

Hiermee geeft u de URI van de internetresource op voor het ophalen van omgevingen.

Type:	Uri
Position:	Named
Default value:	None
Accept pipeline input:	False
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
Accept pipeline input:	False
Accept wildcard characters:	False

Invoerwaarden

String

SwitchParameter

Uitvoerwaarden

PSAzureEnvironment

Verwante koppelingen

• Get-AzEnvironment
• Remove-AzEnvironment
• Set-AzEnvironment