Obsługa programu PowerShell dla lokalnych klastrów bramy danych
Skrypty programu PowerShell są dostępne w galerii programu PowerShell. Skrypty opisane w tym artykule dotyczą programu PowerShell w wersji 5. Jeśli używasz programu PowerShell w wersji 7, zapoznaj się z tematem PowerShell Cmdlets for on-premises data gateway management (Polecenia cmdlet programu PowerShell do lokalnego zarządzania bramą danych). Skrypty programu PowerShell umożliwiają wykonywanie następujących operacji:
- Pobierz listę klastrów bramy dostępnych dla użytkownika.
- Pobierz listę wystąpień bramy zarejestrowanych w klastrze oraz ich stan online lub offline.
- Zmodyfikuj stan włączania lub wyłączania wystąpienia bramy w klastrze i innych właściwościach bramy.
- Usuwanie bramy.
Uruchamianie poleceń programu PowerShell
Aby zainstalować te polecenia cmdlet, uruchom następujące polecenie w sesji programu PowerShell z podwyższonym poziomem uprawnień:
Install-Module -Name OnPremisesDataGatewayHAMgmt
Cała lista poleceń cmdlet można znaleźć przy użyciu następującego polecenia:
Get-Command -Module OnPremisesDataGateway*
Przykłady i opisy są zawarte w poleceniach cmdlet i można uzyskać do nich dostęp przy użyciu następującego polecenia:
get-help <cmdlet-name>
Teraz możesz użyć poleceń w poniższej tabeli do zarządzania klastrami bramy.
| Command | Opis | Parametry |
|---|---|---|
| Login-OnPremisesDataGateway | Użyj tego polecenia, aby zalogować się do zarządzania lokalnymi klastrami bramy danych. Należy uruchomić to polecenie i zalogować się , aby inne polecenia wysokiej dostępności mogły działać prawidłowo. Uwaga: token uwierzytelniania identyfikatora entra firmy Microsoft uzyskany w ramach login wywołania jest ważny tylko przez 1 godzinę, po upływie którego wygasa. Możesz ponownie uruchomić polecenie, login aby uzyskać nowy token. |
Nazwa użytkownika i hasło identyfikatora entra firmy Microsoft (podane w ramach wykonywania polecenia, a nie początkowe wywołanie). |
| Get-OnPremisesDataGatewayClusters | Pobiera listę klastrów bramy dla zalogowanego użytkownika. | Opcjonalnie możesz przekazać parametry formatowania do tego polecenia, aby uzyskać lepszą czytelność, taką jak Format-Tabela -AutoSize -Wrap. |
| Get-OnPremisesDataClusterGateways | Pobiera listę bram w określonym klastrze i dodatkowe informacje dla każdej bramy, takie jak stan online lub offline i nazwa maszyny. | -ClusterObjectID xyz (gdzie xyz jest zastępowany rzeczywistą wartością identyfikatora obiektu klastra, którą można pobrać za pomocą polecenia Get-OnPremisesDataGatewayClusters). |
| Set-OnPremisesDataGateway | Użyj tego polecenia, aby ustawić wartości właściwości dla danej bramy w klastrze, co obejmuje możliwość włączania lub wyłączania określonego wystąpienia bramy. | -ClusterObjectID xyz (gdzie xyz jest zastępowany rzeczywistą wartością identyfikatora obiektu klastra, którą można pobrać za pomocą polecenia Get-OnPremisesDataGatewayClusters). -GatewayObjectID abc (gdzie abc jest zastępowany rzeczywistą wartością identyfikatora obiektu bramy, którą można pobrać przy użyciu polecenia Get-OnPremisesDataClusterGateways , na podstawie identyfikatora obiektu klastra). |
| Get-OnPremisesDataGatewayStatus | Użyj tego polecenia, aby pobrać stan danego wystąpienia bramy w klastrze. | -ClusterObjectID xyz (gdzie xyz jest zastępowany rzeczywistą wartością identyfikatora obiektu klastra, którą można pobrać za pomocą polecenia Get-OnPremisesDataGatewayClusters). -GatewayObjectID abc (gdzie abc jest zastępowany rzeczywistą wartością identyfikatora obiektu bramy, którą można pobrać przy użyciu polecenia Get-OnPremisesDataClusterGateways , na podstawie identyfikatora obiektu klastra). |
| Remove-OnPremisesDataGateway | Użyj tego polecenia, aby usunąć wystąpienie bramy z klastra. Uwaga: brama podstawowa w klastrze nie może zostać usunięta, dopóki wszystkie inne bramy w klastrze nie zostaną usunięte. | -ClusterObjectID xyz (gdzie xyz jest zastępowany rzeczywistą wartością identyfikatora obiektu klastra, którą można pobrać za pomocą polecenia Get-OnPremisesDataGatewayClusters). -GatewayObjectID abc (gdzie abc jest zastępowany rzeczywistą wartością identyfikatora obiektu bramy, którą można pobrać przy użyciu polecenia Get-OnPremisesDataClusterGateways , na podstawie identyfikatora obiektu klastra). |