Set-AzureEnvironment
Ändrar egenskaperna för 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
Set-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 Set-AzureEnvironment ändrar egenskaperna för en Azure-miljö. Det returnerar ett objekt som representerar miljön med sina nya egenskapsvärden. Använd parametern Namn för att identifiera miljön och de andra parametrarna för att ändra egenskapsvärden. Du kan inte använda Set-AzureEnvironment för att ändra namnet på en Azure-miljö.
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.
Obs! Ändra inte egenskaperna för AzureCloud- eller AzureChinaCloud-miljöerna. Använd den här cmdleten för att ändra värdena för privata miljöer som du skapar.
Exempel
Exempel 1: Ändra miljöegenskaper
PS C:\> Set-AzureEnvironment -Name ContosoEnv -PublishSettingsFileUrl "https://contoso.com" -StorageEndpoint "contoso.com"Det här kommandot ändrar värdena för egenskaperna PublishSettingsFileUrl och StorageEndpoint för ContosoEnv-miljön.
Parametrar
-ActiveDirectoryEndpoint
Ändrar slutpunkten för Microsoft Entra-autentisering till det angivna värdet.
| 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
Ändrar slutpunkten för Azure Resource Manager-galleriet till det angivna värdet. Gallerislutpunkten är platsen för mallar för resursgruppsgalleri. Mer information om Azure-resursgrupper och gallerimallar finns i hjälpavsnittet för Get-AzureResourceGroupGalleryTemplate.
| 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
Ändrar URL:en för Azure Management Portal till det angivna värdet.
| Typ: | String |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-Name
Identifierar den miljö som ändras. Den här parametern krävs. Parametervärdet är skiftlägeskänsligt. Jokertecken tillåts inte.
| 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
Ändrar URL:en för publiceringsinställningar i den angivna miljön. 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
Ändrar 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
Ändrar URL:en för Azure-tjänstslutpunkten i den angivna miljön. 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
Ändrar standardslutpunkten för lagringstjänster i den angivna 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