Add-AzureRmEnvironment
Lägger till slutpunkter och metadata för en instans av Azure Resource Manager.
Varning
AzureRM PowerShell-modulen är officiellt inaktuell från och med den 29 februari 2024. Användare rekommenderas att migrera från AzureRM till Az PowerShell-modulen för att säkerställa fortsatt support och uppdateringar.
Även om AzureRM-modulen fortfarande kan fungera, underhålls den inte längre eller stöds, vilket gör att användaren kan välja och riskera fortsatt användning. Se våra migreringsresurser för vägledning om övergången till Az-modulen.
Syntax
Add-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>] Add-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
Cmdleten Add-AzureRmEnvironment 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ö
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
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 :
VersionProfiles : {}
ExtendedProperties : {}
BatchEndpointResourceId :
In this example we are creating a new Azure environment with sample endpoints using Add-AzureRmEnvironment, and then we are changing the value of the ActiveDirectoryEndpoint and GraphEndpoint attributes of the created environment using the cmdlet Set-AzureRmEnvironment.Parametrar
-ActiveDirectoryEndpoint
Anger basutfärdaren för Microsoft Entra-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 |
-AzureAnalysisServicesEndpointSuffix
Dns-suffix för Azure Analysis Services-tjänstslutpunkter
| Typ: | String |
| Position: | 15 |
| 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
Anger domännamnssuffixet för Key Vault-tjänster.
| Typ: | String |
| Position: | 10 |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-AzureKeyVaultServiceEndpointResourceId
Anger målgruppen för åtkomsttoken som auktoriserar begäranden för Key Vault-tjänster.
| Typ: | String |
| Position: | 11 |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-AzureOperationalInsightsEndpoint
Anger slutpunkten för Operational Insights-frågans åtkomst.
| Typ: | String |
| Position: | 22 |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-AzureOperationalInsightsEndpointResourceId
Anger målgruppen för åtkomsttoken som auktoriserar begäranden för Operational Insights-tjänster.
| Typ: | String |
| Position: | 21 |
| 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 |
-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
Credeetnails, klientorganisation och prenumeration som används för kommunikation med Azure
| Typ: | IAzureContextContainer |
| Alias: | AzureRmContext, AzureCredential |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-EnableAdfsAuthentication
Anger att Active Directory usluge za ujedinjavanje 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.
| 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 |
-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 |
-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 |