Delen via


Set-AzureEnvironment

Hiermee wijzigt u de eigenschappen van een Azure-omgeving.

Notitie

De cmdlets waarnaar in deze documentatie wordt verwezen, zijn bedoeld voor het beheren van verouderde Azure-resources die gebruikmaken van Service Management-API's. Zie de Az PowerShell-module voor cmdlets voor het beheren van Azure Resource Manager-resources.

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

Met de cmdlet Set-AzureEnvironment worden de eigenschappen van een Azure-omgeving gewijzigd. Het retourneert een object dat de omgeving vertegenwoordigt met de nieuwe eigenschapswaarden. Gebruik de parameter Name om de omgeving en de andere parameters te identificeren om eigenschapswaarden te wijzigen. U kunt Set-AzureEnvironment niet gebruiken om de naam van een Azure-omgeving te wijzigen.

Een Azure-omgeving een onafhankelijke implementatie van Microsoft Azure, zoals AzureCloud voor wereldwijde Azure en AzureChinaCloud voor Azure beheerd door 21Vianet in China. U kunt ook on-premises Azure-omgevingen maken met behulp van Azure Pack en de WAPack-cmdlets. Zie Azure Pack voor meer informatie.

OPMERKING: Wijzig de eigenschappen van de AzureCloud- of AzureChinaCloud-omgevingen niet. Gebruik deze cmdlet om de waarden te wijzigen van privéomgevingen die u maakt.

Voorbeelden

Voorbeeld 1: Omgevingseigenschappen wijzigen

PS C:\> Set-AzureEnvironment -Name ContosoEnv -PublishSettingsFileUrl "https://contoso.com" -StorageEndpoint "contoso.com"

Met deze opdracht worden de waarden van de eigenschappen Publish Instellingen FileUrl en StorageEndpoint van de ContosoEnv-omgeving gewijzigd.

Parameters

-ActiveDirectoryEndpoint

Hiermee wijzigt u het eindpunt voor Microsoft Entra-verificatie in de opgegeven waarde.

Type:String
Aliases:AdEndpointUrl, ActiveDirectory, ActiveDirectoryAuthority
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ActiveDirectoryServiceEndpointResourceId

Hiermee geeft u de resource-id van een beheer-API waarvan de toegang wordt beheerd door 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

Hiermee wijzigt u het eindpunt voor de Azure Resource Manager-galerie in de opgegeven waarde. Het eindpunt van de galerie is de locatie voor galeriesjablonen voor resourcegroepen. Zie het Help-onderwerp voor Get-AzureResourceGroupGalleryTemplate voor meer informatie over Azure-resourcegroepen en galeriesjablonen.

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

Hiermee wijzigt u de URL van Azure Management Portal in de opgegeven waarde.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

Identificeert de omgeving die wordt gewijzigd. Deze parameter is vereist. De parameterwaarde is hoofdlettergevoelig. Jokertekens zijn niet toegestaan.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Profile

Hiermee geeft u het Azure-profiel op waaruit deze cmdlet wordt gelezen. Als u geen profiel opgeeft, leest deze cmdlet uit het lokale standaardprofiel.

Type:AzureSMProfile
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PublishSettingsFileUrl

Hiermee wijzigt u de URL voor het publiceren van instellingenbestanden in de opgegeven omgeving. Een Bestand met publicatie-instellingen voor Azure is een XML-bestand met informatie over uw account en een beheercertificaat waarmee Windows PowerShell zich namens u kan aanmelden bij uw Azure-account.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceManagerEndpoint

Hiermee wijzigt u het eindpunt voor Azure Resource Manager-gegevens, inclusief gegevens over resourcegroepen die zijn gekoppeld aan het account. Zie Azure Resource Manager-cmdlets () en Windows PowerShell gebruiken met Resource Manager (https://go.microsoft.com/fwlink/?LinkID=394767) voor meer informatie over Azure Resource Manager.https://go.microsoft.com/fwlink/?LinkID=394765

Type:String
Aliases:ResourceManager, ResourceManagerUrl
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ServiceEndpoint

Hiermee wijzigt u de URL van het Azure-service-eindpunt in de opgegeven omgeving. Het Azure-service-eindpunt bepaalt of uw toepassing wordt beheerd door het wereldwijde Azure-platform, Azure beheerd door 21Vianet in China of een persoonlijke Azure-installatie.

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

Hiermee wijzigt u het standaardeindpunt van opslagservices in de opgegeven omgeving.

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

Invoerwaarden

None

U kunt invoer naar deze cmdlet doorsluisen op eigenschapsnaam, maar niet op waarde.

Uitvoerwaarden

Microsoft.WindowsAzure.Commands.Utilities.Common.WindowsAzureEnvironment