Partilhar via

Suporte do PowerShell para clusters de gateway de dados locais

Os scripts do PowerShell estão disponíveis na galeria do PowerShell. Os scripts descritos neste artigo são para o PowerShell versão 5. Ao usar o PowerShell versão 7, consulte Cmdlets do PowerShell para gerenciamento de gateway de dados local. Você pode usar os scripts do PowerShell para executar as seguintes operações:

  • Recupere a lista de clusters de gateway disponíveis para um usuário.
  • Recupere a lista de instâncias de gateway registradas em um cluster e seu status online ou offline.
  • Modifique o estado de ativação ou desativação de uma instância de gateway dentro de um cluster e outras propriedades do gateway.
  • Exclua um gateway.

Executar os comandos do PowerShell

Para instalar esses cmdlets, execute o seguinte comando em uma sessão elevada do PowerShell:

Install-Module -Name OnPremisesDataGatewayHAMgmt

A lista completa de cmdlets pode ser encontrada usando o seguinte comando:

Get-Command -Module OnPremisesDataGateway*

Exemplos e descrições estão incluídos nos cmdlets e você pode acessá-los usando o seguinte comando:

get-help <cmdlet-name>

Agora você pode usar os comandos na tabela a seguir para gerenciar seus clusters de gateway.

Comando Descrição Parâmetros
Login-OnPremisesDataGateway Use este comando para entrar para gerenciar seus clusters de gateway de dados locais. Você deve executar este comando e entrar antes que outros comandos de alta disponibilidade possam funcionar corretamente. Nota: O token de autenticação do Microsoft Entra ID adquirido como parte de uma login chamada é válido por apenas 1 hora, após a qual expira. Você pode executar novamente o login comando para adquirir um novo token. Nome de usuário e senha do Microsoft Entra ID (fornecidos como parte da execução do comando, não da chamada inicial).
Get-OnPremisesDataGatewayClusters Recupera a lista de clusters de gateway para o usuário conectado. Opcionalmente, você pode passar parâmetros de formatação para este comando para melhor legibilidade, como Format-Table -AutoSize -Wrap.
Get-OnPremisesDataClusterGateways Recupera a lista de gateways dentro do cluster especificado e informações adicionais para cada gateway, como status online ou offline e nome da máquina. -ClusterObjectID xyz (onde xyz é substituído por um valor real de ID de objeto de cluster, que pode ser recuperado usando o comando Get-OnPremisesDataGatewayClusters ).
Set-OnPremisesDataGateway Use este comando para definir valores de propriedade para um determinado gateway dentro de um cluster, o que inclui a capacidade de habilitar ou desabilitar uma instância de gateway específica. -ClusterObjectID xyz (onde xyz é substituído por um valor real de ID de objeto de cluster, que pode ser recuperado usando o comando Get-OnPremisesDataGatewayClusters ).

-GatewayObjectID abc (onde abc é substituído por um valor real de ID de objeto de gateway, que pode ser recuperado usando o comando Get-OnPremisesDataClusterGateways , dado um ID de objeto de cluster).
Get-OnPremisesDataGatewayStatus Use este comando para recuperar o status de uma determinada instância de gateway em um cluster. -ClusterObjectID xyz (onde xyz é substituído por um valor real de ID de objeto de cluster, que pode ser recuperado usando o comando Get-OnPremisesDataGatewayClusters ).

-GatewayObjectID abc (onde abc é substituído por um valor real de ID de objeto de gateway, que pode ser recuperado usando o comando Get-OnPremisesDataClusterGateways , dado um ID de objeto de cluster).
Remove-OnPremisesDataGateway Use este comando para remover uma instância de gateway de um cluster. Nota: O gateway primário no cluster não pode ser removido até que todos os outros gateways no cluster sejam removidos. -ClusterObjectID xyz (onde xyz é substituído por um valor real de ID de objeto de cluster, que pode ser recuperado usando o comando Get-OnPremisesDataGatewayClusters ).

-GatewayObjectID abc (onde abc é substituído por um valor real de ID de objeto de gateway, que pode ser recuperado usando o comando Get-OnPremisesDataClusterGateways , dado um ID de objeto de cluster).

Conteúdo relacionado

  • Last updated on