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 ASM-API's (Azure Service Manager). Deze verouderde PowerShell-module wordt niet aanbevolen bij het maken van nieuwe resources, omdat ASM is gepland voor buitengebruikstelling. Zie Buitengebruikstelling van Azure Service Manager voor meer informatie.
De Az PowerShell-module is de aanbevolen PowerShell-module voor het beheren van ARM-resources (Azure Resource Manager) met PowerShell.
Syntaxis
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 PublishSettingsFileUrl en StorageEndpoint van de ContosoEnv-omgeving gewijzigd.
Parameters
-ActiveDirectoryEndpoint
Hiermee wijzigt u het eindpunt voor Microsoft Entra-verificatie in de opgegeven waarde.
| Type: | String |
| Aliassen: | AdEndpointUrl, ActiveDirectory, ActiveDirectoryAuthority |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | 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 |
| Vereist: | False |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-AdTenant
| Type: | String |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-AzureKeyVaultDnsSuffix
| Type: | String |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-AzureKeyVaultServiceEndpointResourceId
| Type: | String |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-EnableAdfsAuthentication
| Type: | SwitchParameter |
| Aliassen: | OnPremise |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | 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 |
| Aliassen: | Gallery, GalleryUrl |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-GraphEndpoint
| Type: | String |
| Aliassen: | Graph, GraphUrl |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-ManagementPortalUrl
Hiermee wijzigt u de URL van Azure Management Portal in de opgegeven waarde.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | 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 |
| Vereist: | True |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | 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 |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | 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 |
| Vereist: | False |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | 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 |
| Aliassen: | ResourceManager, ResourceManagerUrl |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | 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 |
| Aliassen: | ServiceManagement, ServiceManagementUrl |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-SqlDatabaseDnsSuffix
| Type: | String |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-StorageEndpoint
Hiermee wijzigt u het standaardeindpunt van opslagservices in de opgegeven omgeving.
| Type: | String |
| Aliassen: | StorageEndpointSuffix |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-TrafficManagerDnsSuffix
| Type: | String |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
Invoerwaarden
None
U kunt invoer naar deze cmdlet doorsluisen op eigenschapsnaam, maar niet op waarde.
Uitvoerwaarden
Microsoft.WindowsAzure.Commands.Utilities.Common.WindowsAzureEnvironment