Add-AzEnvironment

Referentie

Module:: Az.Accounts

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

Syntaxis

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

De Add-AzEnvironment cmdlet voegt eindpunten en metagegevens toe 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
Aliassen:	AdEndpointUrl, ActiveDirectory, ActiveDirectoryAuthority
Position:	5
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	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
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-AdTenant

Hiermee geeft u de standaard Active Directory-tenant.

Type:	String
Position:	17
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-ARMEndpoint

Het Azure Resource Manager-eindpunt

Type:	String
Aliassen:	ArmUrl
Position:	1
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-AutoDiscover

Detecteert omgevingen via het standaard- of geconfigureerde eindpunt.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-AzureAnalysisServicesEndpointResourceId

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

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-AzureAnalysisServicesEndpointSuffix

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

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	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
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-AzureAttestationServiceEndpointSuffix

Dns-achtervoegsel van de Azure Attestation-service.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-AzureDataLakeAnalyticsCatalogAndJobEndpointSuffix

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

Type:	String
Position:	15
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-AzureDataLakeStoreFileSystemEndpointSuffix

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

Type:	String
Position:	14
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-AzureKeyVaultDnsSuffix

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

Type:	String
Position:	10
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-AzureKeyVaultServiceEndpointResourceId

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

Type:	String
Position:	11
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-AzureOperationalInsightsEndpoint

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

Type:	String
Position:	22
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-AzureOperationalInsightsEndpointResourceId

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

Type:	String
Position:	21
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	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
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-AzureSynapseAnalyticsEndpointSuffix

Dns-achtervoegsel van Azure Synapse Analytics.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-BatchEndpointResourceId

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

Type:	String
Aliassen:	BatchResourceId, BatchAudience
Position:	20
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:	SwitchParameter
Aliassen:	cf
Position:	Named
Default value:	False
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ContainerRegistryEndpointSuffix

Achtervoegsel van Azure Container Registry.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-DataLakeAudience

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

Type:	String
Aliassen:	DataLakeEndpointResourceId, DataLakeResourceId
Position:	19
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-DefaultProfile

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

Type:	IAzureContextContainer
Aliassen:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-EnableAdfsAuthentication

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

Type:	SwitchParameter
Aliassen:	OnPremise
Position:	16
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-GalleryEndpoint

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

Type:	String
Aliassen:	Gallery, GalleryUrl
Position:	7
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-GraphAudience

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

Type:	String
Aliassen:	GraphEndpointResourceId, GraphResourceId
Position:	18
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-GraphEndpoint

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

Type:	String
Aliassen:	Graph, GraphUrl
Position:	9
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-ManagementPortalUrl

Hiermee geeft u de URL voor de beheerportal.

Type:	String
Position:	3
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-MicrosoftGraphEndpointResourceId

De resource-id van Microsoft Graph

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-MicrosoftGraphUrl

Microsoft Graph Url

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-Name

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

Type:	String
Position:	0
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-PublishSettingsFileUrl

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

Type:	String
Position:	1
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-ResourceManagerEndpoint

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

Type:	String
Aliassen:	ResourceManager, ResourceManagerUrl
Position:	6
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	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
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ServiceEndpoint

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

Type:	String
Aliassen:	ServiceManagement, ServiceManagementUrl
Position:	2
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-SqlDatabaseDnsSuffix

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

Type:	String
Position:	13
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-StorageEndpoint

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

Type:	String
Aliassen:	StorageEndpointSuffix
Position:	4
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-TrafficManagerDnsSuffix

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

Type:	String
Position:	12
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-Uri

Hiermee geeft u de URI van de internetresource om omgevingen op te halen.

Type:	Uri
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:	SwitchParameter
Aliassen:	wi
Position:	Named
Default value:	False
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

Invoerwaarden

String

SwitchParameter

Uitvoerwaarden

PSAzureEnvironment

Delen via