Set-AzureEnvironment
Zmienia właściwości środowiska 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
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>] Opis
Polecenie cmdlet Set-AzureEnvironment zmienia właściwości środowiska platformy Azure. Zwraca obiekt reprezentujący środowisko z nowymi wartościami właściwości. Użyj parametru Name , aby zidentyfikować środowisko i inne parametry, aby zmienić wartości właściwości. Nie można użyć polecenia Set-AzureEnvironment , aby zmienić nazwę środowiska platformy Azure.
Ś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.
UWAGA: Nie zmieniaj właściwości środowisk AzureCloud lub AzureChinaCloud. Użyj tego polecenia cmdlet, aby zmienić wartości utworzonych środowisk prywatnych.
Przykłady
Przykład 1. Zmienianie właściwości środowiska
PS C:\> Set-AzureEnvironment -Name ContosoEnv -PublishSettingsFileUrl "https://contoso.com" -StorageEndpoint "contoso.com"To polecenie zmienia wartości właściwości PublishSettingsFileUrl i StorageEndpoint środowiska ContosoEnv.
Parametry
-ActiveDirectoryEndpoint
Zmienia punkt końcowy uwierzytelniania entra firmy Microsoft na określoną wartość.
| 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
Zmienia punkt końcowy galerii usługi Azure Resource Manager na określoną wartość. Punkt końcowy galerii to lokalizacja szablonów 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-AzureResourceGroupGalleryTemplate.
| 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
Zmienia adres URL portalu zarządzania Platformy Azure na określoną wartość.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-Name
Identyfikuje środowisko, które jest zmieniane. Ten parametr jest wymagany. W wartości parametru jest uwzględniana wielkość liter. Symbole wieloznaczne nie są dozwolone.
| 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
Zmienia adres URL plików ustawień publikowania w określonym środowisku. 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
Zmienia 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
Zmienia adres URL punktu końcowego usługi platformy Azure w określonym środowisku. 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
Zmienia domyślny punkt końcowy usług magazynu w określonym ś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