Dela via


Add-AzEnvironment

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

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.

Typ:String
Alias:AdEndpointUrl, ActiveDirectory, ActiveDirectoryAuthority
Position:5
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ActiveDirectoryServiceEndpointResourceId

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

Typ:String
Position:8
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-AdTenant

Anger active directory-standardklientorganisationen.

Typ:String
Position:17
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ARMEndpoint

Azure Resource Manager-slutpunkten

Typ:String
Alias:ArmUrl
Position:1
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-AutoDiscover

Identifierar miljöer via standard eller konfigurerad slutpunkt.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-AzureAnalysisServicesEndpointResourceId

Resursidentifieraren för Azure Analysis Services-resursen.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-AzureAnalysisServicesEndpointSuffix

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

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-AzureAttestationServiceEndpointResourceId

Resursidentifieraren för azure-attesteringstjänsten som är mottagare av den begärda token.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-AzureAttestationServiceEndpointSuffix

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

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-AzureDataLakeAnalyticsCatalogAndJobEndpointSuffix

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

Typ:String
Position:15
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-AzureDataLakeStoreFileSystemEndpointSuffix

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

Typ:String
Position:14
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-AzureKeyVaultDnsSuffix

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

Typ:String
Position:10
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-AzureKeyVaultServiceEndpointResourceId

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

Typ:String
Position:11
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-AzureOperationalInsightsEndpoint

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

Typ:String
Position:22
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-AzureOperationalInsightsEndpointResourceId

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

Typ:String
Position:21
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-AzureSynapseAnalyticsEndpointResourceId

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

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-AzureSynapseAnalyticsEndpointSuffix

Dns-suffix för Azure Synapse Analytics.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-BatchEndpointResourceId

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

Typ:String
Alias:BatchResourceId, BatchAudience
Position:20
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Confirm

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

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ContainerRegistryEndpointSuffix

Suffix för Azure Container Registry.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-DataLakeAudience

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

Typ:String
Alias:DataLakeEndpointResourceId, DataLakeResourceId
Position:19
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-DefaultProfile

Autentiseringsuppgifter, klientorganisation och prenumeration som används för kommunikation med Azure

Typ:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-EnableAdfsAuthentication

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

Typ:SwitchParameter
Alias:OnPremise
Position:16
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-GalleryEndpoint

Anger slutpunkten för Azure Resource Manager-galleriet med distributionsmallar. Parametern är att ange värdet till för GalleryUrl PSAzureEnvironment. Som GalleryUrl tas bort från ArmMetadata tillhandahåller Azure PowerShell inte längre värdet och därför rekommenderas det inte att ange GalleryEndpoint längre.

Typ:String
Alias:Gallery, GalleryUrl
Position:7
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-GraphAudience

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

Typ:String
Alias:GraphEndpointResourceId, GraphResourceId
Position:18
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-GraphEndpoint

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

Typ:String
Alias:Graph, GraphUrl
Position:9
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ManagementPortalUrl

Anger URL:en för hanteringsportalen.

Typ:String
Position:3
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-MicrosoftGraphEndpointResourceId

Resursidentifieraren för Microsoft Graph

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-MicrosoftGraphUrl

Microsoft Graph Url

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Name

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

Typ:String
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-PublishSettingsFileUrl

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

Typ:String
Position:1
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ResourceManagerEndpoint

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

Typ:String
Alias:ResourceManager, ResourceManagerUrl
Position:6
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken: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 startas av den här användaren.

Typ:ContextModificationScope
Godkända värden:Process, CurrentUser
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ServiceEndpoint

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

Typ:String
Alias:ServiceManagement, ServiceManagementUrl
Position:2
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-SqlDatabaseDnsSuffix

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

Typ:String
Position:13
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-StorageEndpoint

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

Typ:String
Alias:StorageEndpointSuffix
Position:4
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-TrafficManagerDnsSuffix

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

Typ:String
Position:12
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Uri

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

Typ:Uri
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WhatIf

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

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

String

SwitchParameter

Utdata

PSAzureEnvironment