Set-AzureEnvironment
Ändert die Eigenschaften einer Azure-Umgebung.
Hinweis
Die Cmdlets, auf die in dieser Dokumentation verwiesen wird, dienen zum Verwalten von Azure-Legacyressourcen, die Azure Dienst-Manager (ASM) APIs verwenden. Dieses ältere PowerShell-Modul wird beim Erstellen neuer Ressourcen nicht empfohlen, da ASM für den Ruhestand geplant ist. Weitere Informationen finden Sie unter Einstellung des Azure Service Manager.
Das Az PowerShell-Modul ist das empfohlene PowerShell-Modul zum Verwalten von Azure Resource Manager (ARM)-Ressourcen mit 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>] Beschreibung
Das Cmdlet Set-AzureEnvironment ändert die Eigenschaften einer Azure-Umgebung. Es gibt ein Objekt zurück, das die Umgebung mit den neuen Eigenschaftswerten darstellt. Verwenden Sie den Parameter Name , um die Umgebung und die anderen Parameter zu identifizieren, um Eigenschaftswerte zu ändern. Sie können set-AzureEnvironment nicht verwenden, um den Namen einer Azure-Umgebung zu ändern.
Eine Azure-Umgebung eine unabhängige Bereitstellung von Microsoft Azure, z. B. AzureCloud für globale Azure und AzureChinaCloud für Azure, betrieben von 21Vianet in China. Sie können auch lokale Azure-Umgebungen mithilfe von Azure Pack und den WAPack-Cmdlets erstellen. Weitere Informationen finden Sie unter Azure Pack.
HINWEIS: Ändern Sie nicht die Eigenschaften der AzureCloud- oder AzureChinaCloud-Umgebungen. Verwenden Sie dieses Cmdlet, um die Werte privater Umgebungen zu ändern, die Sie erstellen.
Beispiele
Beispiel 1: Ändern von Umgebungseigenschaften
PS C:\> Set-AzureEnvironment -Name ContosoEnv -PublishSettingsFileUrl "https://contoso.com" -StorageEndpoint "contoso.com"Mit diesem Befehl werden die Werte der Eigenschaften PublishSettingsFileUrl und StorageEndpoint der ContosoEnv-Umgebung geändert.
Parameter
-ActiveDirectoryEndpoint
Ändert den Endpunkt für die Microsoft Entra-Authentifizierung in den angegebenen Wert.
| Typ: | String |
| Aliase: | AdEndpointUrl, ActiveDirectory, ActiveDirectoryAuthority |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-ActiveDirectoryServiceEndpointResourceId
Gibt die Ressourcen-ID einer Verwaltungs-API an, deren Zugriff von Microsoft Entra ID verwaltet wird.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-AdTenant
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-AzureKeyVaultDnsSuffix
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-AzureKeyVaultServiceEndpointResourceId
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-EnableAdfsAuthentication
| Typ: | SwitchParameter |
| Aliase: | OnPremise |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-GalleryEndpoint
Ändert den Endpunkt für den Azure Resource Manager-Katalog in den angegebenen Wert. Der Katalogendpunkt ist der Speicherort für Ressourcengruppenkatalogvorlagen. Weitere Informationen zu Azure-Ressourcengruppen und Katalogvorlagen finden Sie im Hilfethema zu Get-AzureResourceGroupGalleryTemplate.
| Typ: | String |
| Aliase: | Gallery, GalleryUrl |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-GraphEndpoint
| Typ: | String |
| Aliase: | Graph, GraphUrl |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-ManagementPortalUrl
Ändert die URL des Azure-Verwaltungsportals in den angegebenen Wert.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-Name
Identifiziert die Umgebung, die geändert wird. Dieser Parameter ist erforderlich. Bei dem Parameterwert wird die Groß-/Kleinschreibung beachtet. Platzhalterzeichen sind nicht zulässig.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-Profile
Gibt das Azure-Profil an, aus dem dieses Cmdlet liest. Wenn Sie kein Profil angeben, liest dieses Cmdlet aus dem lokalen Standardprofil.
| Typ: | AzureSMProfile |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-PublishSettingsFileUrl
Ändert die URL für Veröffentlichungseinstellungendateien in der angegebenen Umgebung. Eine Azure-Veröffentlichungseinstellungsdatei ist eine XML-Datei, die Informationen über Ihr Konto und ein Verwaltungszertifikat enthält, mit dem Windows PowerShell sich in Ihrem Auftrag bei Ihrem Azure-Konto anmelden kann.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-ResourceManagerEndpoint
Ändert den Endpunkt für Azure Resource Manager-Daten, einschließlich Daten zu Ressourcengruppen, die dem Konto zugeordnet sind. Weitere Informationen zu Azure Resource Manager finden Sie unter Azure Resource Manager Cmdlets (https://go.microsoft.com/fwlink/?LinkID=394765) und Verwenden von Windows PowerShell mit Ressourcen-Manager (https://go.microsoft.com/fwlink/?LinkID=394767).
| Typ: | String |
| Aliase: | ResourceManager, ResourceManagerUrl |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-ServiceEndpoint
Ändert die URL des Azure-Dienstendpunkts in der angegebenen Umgebung. Der Azure-Dienstendpunkt bestimmt, ob Ihre Anwendung von der globalen Azure-Plattform, azure betrieben von 21Vianet in China oder einer privaten Azure-Installation verwaltet wird.
| Typ: | String |
| Aliase: | ServiceManagement, ServiceManagementUrl |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-SqlDatabaseDnsSuffix
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-StorageEndpoint
Ändert den Standardendpunkt von Speicherdiensten in der angegebenen Umgebung.
| Typ: | String |
| Aliase: | StorageEndpointSuffix |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-TrafficManagerDnsSuffix
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
Eingaben
None
Sie können Eingaben nach Eigenschaftsname an dieses Cmdlet weiterleiten, aber nicht nach Wert.
Ausgaben
Microsoft.WindowsAzure.Commands.Utilities.Common.WindowsAzureEnvironment