Add-AzEnvironment

Modul:

Az.Accounts

Lägger till slutpunkter och metadata för en instans av Azure Resource Manager.

Anteckning

Det här är den tidigare versionen av vår dokumentation. Se den senaste versionen för uppdaterad information.

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

Cmdleten Add-AzEnvironment lägger till slutpunkter och metadata så att Azure Resource Manager-cmdletar kan ansluta till en ny instans av Azure Resource Manager. De inbyggda miljöerna AzureCloud och AzureChinaCloud riktar in sig på befintliga offentliga instanser av Azure Resource Manager.

Exempel

Exempel 1: Skapa och ändra en ny miljö

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                           :

I det här exemplet skapar vi en ny Azure-miljö med exempelslutpunkter med hjälp av Add-AzEnvironment, och sedan ändrar vi värdet för ActiveDirectoryEndpoint- och GraphEndpoint-attributen för den skapade miljön med hjälp av cmdleten Set-AzEnvironment.

Exempel 2: Identifiera en ny miljö 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/

I det här exemplet identifierar vi en ny Azure-miljö från URI:n https://configuredmetadata.net .

Parametrar

-ActiveDirectoryEndpoint

Anger basutfärdare för Azure Active Directory-autentisering.

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

-ActiveDirectoryServiceEndpointResourceId

Anger målgruppen för token som autentiserar begäranden till Slutpunkter för Azure Resource Manager eller Service Management (RDFE).

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

-AdTenant

Anger standardklientorganisationen för Active Directory.

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

-ARMEndpoint

Azure Resource Manager-slutpunkten

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

-AutoDiscover

Identifierar miljöer via standard eller konfigurerad slutpunkt.

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

-AzureAnalysisServicesEndpointResourceId

Resursidentifieraren för den Azure Analysis Services resursen.

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

-AzureAnalysisServicesEndpointSuffix

Slutpunkten som ska användas när du kommunicerar med Azure Log Analytics-API:et.

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

-AzureAttestationServiceEndpointResourceId

Resursidentifieraren för den Azure Attestation tjänst som är mottagare av den begärda token.

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

-AzureAttestationServiceEndpointSuffix

Dns-suffix för Azure Attestation-tjänsten.

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

-AzureDataLakeAnalyticsCatalogAndJobEndpointSuffix

Dns-suffix för Jobb- och katalogtjänster i Azure Data Lake Analytics

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

-AzureDataLakeStoreFileSystemEndpointSuffix

Dns-suffix för Azure Data Lake Store FileSystem. Exempel: azuredatalake.net

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

-AzureKeyVaultDnsSuffix

Dns-suffix för Azure Key Vault-tjänsten. Exempel är vault-int.azure-int.net

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

-AzureKeyVaultServiceEndpointResourceId

Resursidentifierare för Azure Key Vault datatjänst som är mottagare av den begärda token.

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

-AzureOperationalInsightsEndpoint

Slutpunkten som ska användas när du kommunicerar med Azure Log Analytics-API:et.

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

-AzureOperationalInsightsEndpointResourceId

Målgruppen för token som autentiseras med Azure Log Analytics-API:et.

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

-AzureSynapseAnalyticsEndpointResourceId

Resursidentifieraren för Azure Synapse Analytics som är mottagare av den begärda token.

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

-AzureSynapseAnalyticsEndpointSuffix

Dns-suffix för Azure Synapse Analytics.

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

-BatchEndpointResourceId

Resursidentifieraren för den Azure Batch tjänst som är mottagare av den begärda token

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

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

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

-ContainerRegistryEndpointSuffix

Suffixet för Azure Container Registry.

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

-DataLakeAudience

Målgruppen för token som autentiserar med AD Data Lake-tjänstslutpunkten.

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

-DefaultProfile

Autentiseringsuppgifterna, klientorganisationen och prenumerationen som används för kommunikation med Azure

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

-EnableAdfsAuthentication

Anger att Active Directory Federation Services (AD FS) lokal autentisering (ADFS) tillåts.

Type:	SwitchParameter
Aliases:	OnPremise
Position:	16
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-GalleryEndpoint

Anger slutpunkten för Azure Resource Manager-galleriet med distributionsmallar.

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

-GraphAudience

Målgruppen för token som autentiserar med AD Graph-slutpunkten.

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

-GraphEndpoint

Anger URL:en för Graph-begäranden (Active Directory-metadata).

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

-ManagementPortalUrl

Anger URL:en för hanteringsportalen.

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

-MicrosoftGraphEndpointResourceId

Resursidentifieraren för 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

Anger namnet på den miljö som ska läggas till.

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

-PublishSettingsFileUrl

Anger den URL som .publishsettings-filer kan laddas ned från.

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

-ResourceManagerEndpoint

Anger URL:en för Azure Resource Manager-begäranden.

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

-Scope

Avgör omfånget för kontextändringar, till exempel om ändringar endast gäller för den aktuella processen eller för alla sessioner som startats av den här användaren.

Type:	ContextModificationScope
Accepted values:	Process, CurrentUser
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ServiceEndpoint

Anger slutpunkten för RDFE-begäranden (Service Management).

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

-SqlDatabaseDnsSuffix

Anger domännamnssuffixet för Azure SQL Database-servrar.

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

-StorageEndpoint

Anger slutpunkten för åtkomst till lagring (blob, tabell, kö och fil).

Type:	String
Aliases:	StorageEndpointSuffix
Position:	4
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-TrafficManagerDnsSuffix

Anger domännamnssuffixet för Azure Traffic Manager-tjänster.

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

-Uri

Anger URI för Internetresursen för att hämta miljöer.

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

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

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

Indata

String

SwitchParameter

Utdata

PSAzureEnvironment

Relaterade länkar

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