Set-AzureEnvironment
Ändrar egenskaperna för en Azure-miljö.
Kommentar
De cmdletar som refereras i den här dokumentationen är till för att hantera äldre Azure-resurser som använder Service Management-API:er. Se Az PowerShell-modulen för cmdletar för att hantera Azure Resource Manager-resurser.
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 Publish Inställningar FileUrl och StorageEndpoint för ContosoEnv-miljön.
Parametrar
-ActiveDirectoryEndpoint
Ändrar slutpunkten för Microsoft Entra-autentisering till det angivna värdet.
Type: | String |
Aliases: | AdEndpointUrl, ActiveDirectory, ActiveDirectoryAuthority |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ActiveDirectoryServiceEndpointResourceId
Anger resurs-ID för ett hanterings-API vars åtkomst hanteras av Microsoft Entra-ID.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-AdTenant
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-AzureKeyVaultDnsSuffix
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-AzureKeyVaultServiceEndpointResourceId
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-EnableAdfsAuthentication
Type: | SwitchParameter |
Aliases: | OnPremise |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | String |
Aliases: | Gallery, GalleryUrl |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-GraphEndpoint
Type: | String |
Aliases: | Graph, GraphUrl |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ManagementPortalUrl
Ändrar URL:en för Azure Management Portal till det angivna värdet.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Identifierar den miljö som ändras. Den här parametern krävs. Parametervärdet är skiftlägeskänsligt. Jokertecken tillåts inte.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | AzureSMProfile |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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).
Type: | String |
Aliases: | ResourceManager, ResourceManagerUrl |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | String |
Aliases: | ServiceManagement, ServiceManagementUrl |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SqlDatabaseDnsSuffix
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-StorageEndpoint
Ändrar standardslutpunkten för lagringstjänster i den angivna miljön.
Type: | String |
Aliases: | StorageEndpointSuffix |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TrafficManagerDnsSuffix
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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