Add-AzureEnvironment
Erstellt eine Azure-Umgebung.
Hinweis
Die Cmdlets, auf die in dieser Dokumentation verwiesen wird, dienen zum Verwalten von Azure-Legacyressourcen, die Dienstverwaltungs-APIs verwenden. Cmdlets zum Verwalten von Azure Ressource Manager-Ressourcen finden Sie im Az PowerShell-Modul.
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.
Type: | String |
Aliases: | AdEndpointUrl, ActiveDirectory, ActiveDirectoryAuthority |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ActiveDirectoryServiceEndpointResourceId
Gibt die Ressourcen-ID einer Verwaltungs-API an, deren Zugriff von Microsoft Entra ID verwaltet wird.
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
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.
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
Gibt die URL des Azure-Verwaltungsportals in der neuen Umgebung an.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Gibt einen Namen für die Umgebung an. Dieser Parameter ist erforderlich. Verwenden Sie nicht die Namen der Standardumgebungen, AzureCloud und AzureChinaCloud.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Profile
Gibt das Azure-Profil an, aus dem dieses Cmdlet liest. Wenn Sie kein Profil angeben, liest dieses Cmdlet aus dem lokalen Standardprofil.
Type: | AzureSMProfile |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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).
Type: | String |
Aliases: | ResourceManager, ResourceManagerUrl |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
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
Gibt den Standardendpunkt von Speicherdiensten in der neuen Umgebung an.
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 |
Eingaben
None
Sie können Eingaben nach Eigenschaftsname an dieses Cmdlet weiterleiten, aber nicht nach Wert.
Ausgaben
Microsoft.WindowsAzure.Commands.Utilities.Common.WindowsAzureEnvironment