Add-AzureEnvironment
Erstellt eine Azure-Umgebung.
Hinweis
Die in dieser Dokumentation referenzierten Cmdlets dienen zum Verwalten von älteren Azure-Ressourcen, die Azure Service 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
Add-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 "Add-AzureEnvironment " erstellt eine neue benutzerdefinierte Azure-Kontoumgebung und speichert sie in Ihrem Roamingbenutzerprofil. Das Cmdlet gibt ein Objekt zurück, das die neue Umgebung darstellt. Nach Abschluss des Befehls können Sie die Umgebung in Windows PowerShell verwenden.
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.
Nur der Name-Parameter dieses Cmdlets ist obligatorisch. Wenn Sie einen Parameter weglassen, ist der Wert null ($Null), und der Dienst, der diesen Endpunkt verwendet, funktioniert möglicherweise nicht ordnungsgemäß. Verwenden Sie das Cmdlet Set-AzureEnvironment , um den Wert einer Umgebungseigenschaft hinzuzufügen oder zu ändern.
HINWEIS: Das Ändern Ihrer Umgebung kann dazu führen, dass Ihr Konto fehlschlägt. In der Regel werden Umgebungen nur zu Testzwecken oder zur Problembehandlung hinzugefügt.
In diesem Thema wird das Cmdlet in der Version 0.8.10 des Microsoft Azure PowerShell-Moduls beschrieben.
Um die Version des verwendeten Moduls abzurufen, geben Sie in der Azure PowerShell-Konsole folgendes ein (Get-Module -Name Azure).Version.
Beispiele
Beispiel 1: Hinzufügen einer Azure-Umgebung
PS C:\> Add-AzureEnvironment -Name ContosoEnv -PublishSettingsFileUrl https://contoso.com/fwlink/?LinkID=101 -ServiceEndpoint https://contoso.com/fwlink/?LinkID=102
Name : ContosoEnv
PublishSettingsFileUrl : https://contoso.com/fwlink/?LinkID=101
ServiceEndpoint : https://contoso.com/fwlink/?LinkID=102
ResourceManagerEndpoint :
ManagementPortalUrl :
ActiveDirectoryEndpoint :
ActiveDirectoryCommonTenantId :
StorageEndpointSuffix :
StorageBlobEndpointFormat :
StorageQueueEndpointFormat :
StorageTableEndpointFormat :
GalleryEndpoint :Mit diesem Befehl wird die Azure-Umgebung "ContosoEnv" erstellt.
Parameter
-ActiveDirectoryEndpoint
Gibt den Endpunkt für die Microsoft Entra-Authentifizierung in der neuen Umgebung an.
| 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
Gibt den Endpunkt für den Azure Resource Manager-Katalog an, in dem Ressourcengruppenkatalogvorlagen gespeichert werden. Weitere Informationen zu Azure-Ressourcengruppen und Katalogvorlagen finden Sie im Hilfethema zu Get-AzureResourceGroupGalleryTemplatehttps://go.microsoft.com/fwlink/?LinkID=393052.
| 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
Gibt die URL des Azure-Verwaltungsportals in der neuen Umgebung an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-Name
Gibt einen Namen für die Umgebung an. Dieser Parameter ist erforderlich. Verwenden Sie nicht die Namen der Standardumgebungen, AzureCloud und AzureChinaCloud.
| 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
Gibt die URL der Veröffentlichungseinstellungsdateien für Ihr Konto an. 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
Gibt den Endpunkt für Azure Resource Manager-Daten an, 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
Gibt die URL des Azure-Dienstendpunkts an. 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
Gibt den Standardendpunkt von Speicherdiensten in der neuen Umgebung an.
| 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