Dela via


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