Add-AzureEnvironment
Skapar en Azure-miljö.
Kommentar
De cmdletar som refereras i den här dokumentationen används för att hantera äldre Azure-resurser som använder API:er för Azure Service Manager (ASM). Den här äldre PowerShell-modulen rekommenderas inte när du skapar nya resurser eftersom ASM är schemalagt för tillbakadragning. Mer information finns i Azure Service Manager-tillbakadragning.
Az PowerShell-modulen är den rekommenderade PowerShell-modulen för hantering av Arm-resurser (Azure Resource Manager) med PowerShell.
Syntax
Add-AzureEnvironment
-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>]
[-EnableAdfsAuthentication]
[-AdTenant <String>]
[-Profile <AzureSMProfile>]
[<CommonParameters>] Description
Cmdleten Add-AzureEnvironment skapar en ny anpassad Azure-kontomiljö och sparar den i din centrala användarprofil. Cmdleten returnerar ett objekt som representerar den nya miljön. När kommandot har slutförts kan du använda miljön i Windows PowerShell.
En Azure-miljö en oberoende distribution av Microsoft Azure, till exempel AzureCloud för globala Azure och AzureChinaCloud för Azure som drivs av 21Vianet i Kina. Du kan också skapa lokala Azure-miljöer med hjälp av Azure Pack och WAPack-cmdletarna. Mer information finns i Azure Pack.
Endast namnparametern för den här cmdleten är obligatorisk. Om du utelämnar en parameter är dess värde null ($Null) och tjänsten som använder slutpunkten kanske inte fungerar korrekt. Om du vill lägga till eller ändra värdet för en miljöegenskap använder du cmdleten Set-AzureEnvironment .
Obs! Om du ändrar din miljö kan ditt konto misslyckas. Vanligtvis läggs miljöer bara till för testning eller felsökning.
Det här avsnittet beskriver cmdleten i 0.8.10-versionen av Microsoft Azure PowerShell-modulen.
Om du vill hämta den version av modulen som du använder skriver (Get-Module -Name Azure).Versiondu i Azure PowerShell-konsolen .
Exempel
Exempel 1: Lägg till en Azure-miljö
PS C:\> Add-AzureEnvironment -Name ContosoEnv -PublishSettingsFileUrl https://contoso.com/fwlink/?LinkID=101 -ServiceEndpoint https://contoso.com/fwlink/?LinkID=102
Name : ContosoEnv
PublishSettingsFileUrl : https://contoso.com/fwlink/?LinkID=101
ServiceEndpoint : https://contoso.com/fwlink/?LinkID=102
ResourceManagerEndpoint :
ManagementPortalUrl :
ActiveDirectoryEndpoint :
ActiveDirectoryCommonTenantId :
StorageEndpointSuffix :
StorageBlobEndpointFormat :
StorageQueueEndpointFormat :
StorageTableEndpointFormat :
GalleryEndpoint :Det här kommandot skapar ContosoEnv Azure-miljön.
Parametrar
-ActiveDirectoryEndpoint
Anger slutpunkten för Microsoft Entra-autentisering i den nya miljön.
| Typ: | String |
| Alias: | AdEndpointUrl, ActiveDirectory, ActiveDirectoryAuthority |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-ActiveDirectoryServiceEndpointResourceId
Anger resurs-ID för ett hanterings-API vars åtkomst hanteras av Microsoft Entra-ID.
| Typ: | String |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-AdTenant
| Typ: | String |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-AzureKeyVaultDnsSuffix
| Typ: | String |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-AzureKeyVaultServiceEndpointResourceId
| Typ: | String |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-EnableAdfsAuthentication
| Typ: | SwitchParameter |
| Alias: | OnPremise |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-GalleryEndpoint
Anger slutpunkten för Azure Resource Manager-galleriet, som lagrar mallar för resursgruppsgalleri. Mer information om Azure-resursgrupper och gallerimallar finns i hjälpavsnittet för Get-AzureResourceGroupGalleryTemplatehttps://go.microsoft.com/fwlink/?LinkID=393052.
| Typ: | String |
| Alias: | Gallery, GalleryUrl |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-GraphEndpoint
| Typ: | String |
| Alias: | Graph, GraphUrl |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-ManagementPortalUrl
Anger URL:en för Azure Management Portal i den nya miljön.
| Typ: | String |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-Name
Anger ett namn på miljön. Den här parametern krävs. Använd inte namnen på standardmiljöerna AzureCloud och AzureChinaCloud.
| Typ: | String |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | True |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-Profile
Anger den Azure-profil som den här cmdleten läser från. Om du inte anger någon profil läser den här cmdleten från den lokala standardprofilen.
| Typ: | AzureSMProfile |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-PublishSettingsFileUrl
Anger URL:en för publiceringsinställningsfilerna för ditt konto. En Azure-fil för publiceringsinställningar är en XML-fil som innehåller information om ditt konto och ett hanteringscertifikat som gör att Windows PowerShell kan logga in på ditt Azure-konto åt dig.
| Typ: | String |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-ResourceManagerEndpoint
Anger slutpunkten för Azure Resource Manager-data, inklusive data om resursgrupper som är associerade med kontot. Mer information om Azure Resource Manager finns i Azure Resource Manager-cmdletar (https://go.microsoft.com/fwlink/?LinkID=394765) och Använda Windows PowerShell med Resource Manager (https://go.microsoft.com/fwlink/?LinkID=394767).
| Typ: | String |
| Alias: | ResourceManager, ResourceManagerUrl |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-ServiceEndpoint
Anger URL:en för Azure-tjänstslutpunkten. Azure-tjänstslutpunkten avgör om ditt program hanteras av den globala Azure-plattformen, Azure som drivs av 21Vianet i Kina eller en privat Azure-installation.
| Typ: | String |
| Alias: | ServiceManagement, ServiceManagementUrl |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-SqlDatabaseDnsSuffix
| Typ: | String |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-StorageEndpoint
Anger standardslutpunkten för lagringstjänster i den nya miljön.
| Typ: | String |
| Alias: | StorageEndpointSuffix |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-TrafficManagerDnsSuffix
| Typ: | String |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
Indata
None
Du kan skicka indata till den här cmdleten efter egenskapsnamn, men inte efter värde.
Utdata
Microsoft.WindowsAzure.Commands.Utilities.Common.WindowsAzureEnvironment