Add-AzureEnvironment
Tworzy środowisko platformy Azure.
Uwaga
Polecenia cmdlet, do których odwołuje się ta dokumentacja, służą do zarządzania starszymi zasobami platformy Azure korzystającymi z interfejsów API programu Azure Service Manager (ASM). Ten starszy moduł programu PowerShell nie jest zalecany podczas tworzenia nowych zasobów, ponieważ usługa ASM ma zostać wycofana. Aby uzyskać więcej informacji, zobacz Wycofywanie programu Azure Service Manager.
Moduł Az programu PowerShell jest zalecanym modułem programu PowerShell do zarządzania zasobami usługi Azure Resource Manager (ARM) przy użyciu programu PowerShell.
Składnia
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>] Opis
Polecenie cmdlet Add-AzureEnvironment tworzy nowe niestandardowe środowisko konta platformy Azure i zapisuje je w profilu użytkownika mobilnego. Polecenie cmdlet zwraca obiekt reprezentujący nowe środowisko. Po zakończeniu wykonywania polecenia można użyć środowiska w programie Windows PowerShell.
Środowisko platformy Azure niezależne wdrożenie platformy Microsoft Azure, takie jak AzureCloud for global Azure i AzureChinaCloud for Azure obsługiwane przez firmę 21Vianet w Chinach. Możesz również tworzyć lokalne środowiska platformy Azure przy użyciu pakietu Azure Pack i poleceń cmdlet WAPack. Aby uzyskać więcej informacji, zobacz Azure Pack.
Tylko parametr Name tego polecenia cmdlet jest obowiązkowy. Jeśli pominięto parametr, jego wartość ma wartość null ($Null), a usługa korzystająca z tego punktu końcowego może nie działać prawidłowo. Aby dodać lub zmienić wartość właściwości środowiska, użyj polecenia cmdlet Set-AzureEnvironment .
UWAGA: Zmiana środowiska może spowodować niepowodzenie konta. Zazwyczaj środowiska są dodawane tylko do testowania lub rozwiązywania problemów.
W tym temacie opisano polecenie cmdlet w wersji 0.8.10 modułu Microsoft Azure PowerShell.
Aby uzyskać wersję używanego modułu, w konsoli programu Azure PowerShell wpisz (Get-Module -Name Azure).Version.
Przykłady
Przykład 1. Dodawanie środowiska platformy Azure
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 :To polecenie tworzy środowisko platformy Azure ContosoEnv.
Parametry
-ActiveDirectoryEndpoint
Określa punkt końcowy uwierzytelniania firmy Microsoft Entra w nowym środowisku.
| Typ: | String |
| Aliases: | AdEndpointUrl, ActiveDirectory, ActiveDirectoryAuthority |
| Position: | Named |
| wartość domyślna: | None |
| Wymagane: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ActiveDirectoryServiceEndpointResourceId
Określa identyfikator zasobu interfejsu API zarządzania, którego dostęp jest zarządzany przez identyfikator Entra firmy Microsoft.
| Typ: | String |
| Position: | Named |
| wartość domyślna: | None |
| Wymagane: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-AdTenant
| Typ: | String |
| Position: | Named |
| wartość domyślna: | None |
| Wymagane: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-AzureKeyVaultDnsSuffix
| Typ: | String |
| Position: | Named |
| wartość domyślna: | None |
| Wymagane: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-AzureKeyVaultServiceEndpointResourceId
| Typ: | String |
| Position: | Named |
| wartość domyślna: | None |
| Wymagane: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-EnableAdfsAuthentication
| Typ: | SwitchParameter |
| Aliases: | OnPremise |
| Position: | Named |
| wartość domyślna: | None |
| Wymagane: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-GalleryEndpoint
Określa punkt końcowy dla galerii usługi Azure Resource Manager, która przechowuje szablony galerii grup zasobów. Aby uzyskać więcej informacji na temat grup zasobów platformy Azure i szablonów galerii, zobacz temat pomocy dotyczący polecenia Get-AzureResourceGroupGalleryTemplatehttps://go.microsoft.com/fwlink/?LinkID=393052.
| Typ: | String |
| Aliases: | Gallery, GalleryUrl |
| Position: | Named |
| wartość domyślna: | None |
| Wymagane: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-GraphEndpoint
| Typ: | String |
| Aliases: | Graph, GraphUrl |
| Position: | Named |
| wartość domyślna: | None |
| Wymagane: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ManagementPortalUrl
Określa adres URL portalu zarządzania Azure w nowym środowisku.
| Typ: | String |
| Position: | Named |
| wartość domyślna: | None |
| Wymagane: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
Określa nazwę środowiska. Ten parametr jest wymagany. Nie używaj nazw środowisk domyślnych, usług AzureCloud i AzureChinaCloud.
| Typ: | String |
| Position: | Named |
| wartość domyślna: | None |
| Wymagane: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Profile
Określa profil platformy Azure, z którego to polecenie cmdlet odczytuje. Jeśli nie określisz profilu, to polecenie cmdlet odczytuje z lokalnego profilu domyślnego.
| Typ: | AzureSMProfile |
| Position: | Named |
| wartość domyślna: | None |
| Wymagane: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PublishSettingsFileUrl
Określa adres URL plików ustawień publikowania dla konta. Plik ustawień publikowania platformy Azure to plik XML zawierający informacje o twoim koncie i certyfikacie zarządzania, który umożliwia programowi Windows PowerShell logowanie się do konta platformy Azure w Twoim imieniu.
| Typ: | String |
| Position: | Named |
| wartość domyślna: | None |
| Wymagane: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ResourceManagerEndpoint
Określa punkt końcowy dla danych usługi Azure Resource Manager, w tym dane dotyczące grup zasobów skojarzonych z kontem. Aby uzyskać więcej informacji na temat usługi Azure Resource Manager, zobacz Polecenia cmdlet usługi Azure Resource Manager (https://go.microsoft.com/fwlink/?LinkID=394765) i Używanie programu Windows PowerShell z usługą Resource Manager (https://go.microsoft.com/fwlink/?LinkID=394767).
| Typ: | String |
| Aliases: | ResourceManager, ResourceManagerUrl |
| Position: | Named |
| wartość domyślna: | None |
| Wymagane: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ServiceEndpoint
Określa adres URL punktu końcowego usługi platformy Azure. Punkt końcowy usługi platformy Azure określa, czy aplikacja jest zarządzana przez globalną platformę Azure, platformę Azure obsługiwaną przez firmę 21Vianet w Chinach, czy prywatną instalację platformy Azure.
| Typ: | String |
| Aliases: | ServiceManagement, ServiceManagementUrl |
| Position: | Named |
| wartość domyślna: | None |
| Wymagane: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SqlDatabaseDnsSuffix
| Typ: | String |
| Position: | Named |
| wartość domyślna: | None |
| Wymagane: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-StorageEndpoint
Określa domyślny punkt końcowy usług magazynu w nowym środowisku.
| Typ: | String |
| Aliases: | StorageEndpointSuffix |
| Position: | Named |
| wartość domyślna: | None |
| Wymagane: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TrafficManagerDnsSuffix
| Typ: | String |
| Position: | Named |
| wartość domyślna: | None |
| Wymagane: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Dane wejściowe
None
Możesz przekazać dane wejściowe do tego polecenia cmdlet według nazwy właściwości, ale nie według wartości.
Dane wyjściowe
Microsoft.WindowsAzure.Commands.Utilities.Common.WindowsAzureEnvironment