Udostępnij za pośrednictwem

Add-AzureEnvironment

  • Odwołanie
Moduł:
Azure

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
Aliasy:AdEndpointUrl, ActiveDirectory, ActiveDirectoryAuthority
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych: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
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-AdTenant

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-AzureKeyVaultDnsSuffix

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-AzureKeyVaultServiceEndpointResourceId

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-EnableAdfsAuthentication

Typ:SwitchParameter
Aliasy:OnPremise
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych: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
Aliasy:Gallery, GalleryUrl
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-GraphEndpoint

Typ:String
Aliasy:Graph, GraphUrl
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ManagementPortalUrl

Określa adres URL portalu zarządzania Azure w nowym środowisku.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych: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
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych: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
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych: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
Aliasy:ResourceManager, ResourceManagerUrl
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych: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
Aliasy:ServiceManagement, ServiceManagementUrl
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-SqlDatabaseDnsSuffix

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-StorageEndpoint

Określa domyślny punkt końcowy usług magazynu w nowym środowisku.

Typ:String
Aliasy:StorageEndpointSuffix
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-TrafficManagerDnsSuffix

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych: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