Visão geral dos cmdlets do PowerShell para os grupos de disponibilidade Always On

Aplica-se a:SQL Server

O Microsoft PowerShell é um shell de linha de comando baseado em tarefas e linguagem de script projetado especialmente para a administração do sistema. Os grupos de disponibilidade Always On fornecem um conjunto de cmdlets do PowerShell no SQL Server que permitem implantar, gerenciar e monitorar grupos de disponibilidade, réplicas de disponibilidade e bancos de dados de disponibilidade.

Observação

Um cmdlet do PowerShell pode ser concluído iniciando com êxito uma ação. Isso não indica que o trabalho previsto, como o failover de um grupo de disponibilidade, foi concluído. Ao criar scripts para uma sequência de ações, talvez seja necessário verificar o status das ações e aguardar a conclusão delas.

Observação

Para obter uma lista de tópicos nos Manuais Online do SQL Server que descrevem como usar cmdlets para executar tarefas de grupos de disponibilidade Always On, consulte a seção "Tarefas relacionadas" de Overview of Always On Availability Groups (SQL Server).

Configurando uma instância de servidor para Always On Availability Groups

Cmdlets	Descrição	Compatível com
Disable-SqlAlwaysOn	Desabilita o recurso de grupos de disponibilidade Always On em uma instância do servidor.	A instância de servidor especificada pelo parâmetro Path, InputObjectou Name. (Deve ser uma edição do SQL Server que ofereça suporte a grupos de disponibilidade Always On.)
Enable-SqlAlwaysOn	Habilita grupos de disponibilidade Always On em uma instância do SQL Server que dá suporte ao recurso de grupos de disponibilidade Always On. Para obter informações sobre o suporte para grupos de disponibilidade Always On, consulte Pré-requisitos, restrições e recomendações para grupos de disponibilidade Always On (SQL Server).	Qualquer edição do SQL Server que ofereça suporte a grupos de disponibilidade Always On.
New-SqlHadrEndPoint	Cria um novo endpoint de espelhamento de base de dados numa instância de servidor. Esse ponto de extremidade é necessário para a movimentação de dados entre bancos de dados primários e secundários.	Qualquer instância do SQL Server
Set-SqlHadrEndpoint	Altera as propriedades de um ponto de extremidade de espelhamento de base de dados existente, tais como o nome, o estado ou as propriedades de autenticação.	Uma instância de servidor que suporta grupos de disponibilidade Always On e não possui um ponto de extremidade de espelhamento de banco de dados

Fazendo backup e restaurando bancos de dados e logs de transações

Cmdlets	Descrição	Compatível com
Backup-SqlDatabase	Cria um backup de dados ou log.	Qualquer banco de dados online (para grupos de disponibilidade Always On, um banco de dados na instância do servidor que hospeda a réplica primária)
Restore-SqlDatabase	Restaura um backup.	Qualquer instância do SQL Server (para grupos de disponibilidade Always On, uma instância de servidor que hospeda uma réplica secundária)

Importante

Ao preparar um banco de dados secundário, deve usar o parâmetro -NoRecovery em cada comando Restore-SqlDatabase.

Para obter informações sobre como usar esses cmdlets para preparar um banco de dados secundário, consulte preparar manualmente um banco de dados secundário para um grupo de disponibilidade (SQL Server).

Criando e gerenciando um grupo de disponibilidade

Cmdlets	Descrição	Compatível com
New-SqlAvailabilityGroup	Cria um novo grupo de disponibilidade.	Instância do servidor para hospedar a réplica primária
Remove-SqlAvailabilityGroup	Exclui o grupo de disponibilidade.	Instância do servidor habilitada para HADR
Set-SqlAvailabilityGroup	Defina as propriedades de um grupo de disponibilidade; coloque um grupo de disponibilidade online/offline.	Instância do servidor que hospeda a réplica primária
Switch-SqlAvailabilityGroup	Inicia uma das seguintes formas de failover: Um failover forçado de um grupo de disponibilidade (com possível perda de dados). Um failover manual de um grupo de alta disponibilidade.	Instância do servidor que hospeda a réplica secundária de destino

Criando e gerindo um ouvinte de grupo de disponibilidade

Cmdlet	Descrição	Compatível com
New-SqlAvailabilityGroupListener	Cria um novo ouvinte de grupo de alta disponibilidade e anexa-o a um grupo de alta disponibilidade existente.	Instância do servidor que hospeda a réplica primária
Set-SqlAvailabilityGroupListener	Modifica a configuração de porta em um ouvinte de grupo de disponibilidade existente.	Instância do servidor que hospeda a réplica primária
Add-SqlAvailabilityGroupListenerStaticIp	Adiciona um endereço IP estático a uma configuração de ouvinte de grupo de disponibilidade existente. O endereço IP pode ser um endereço IPv4 com sub-rede ou um endereço IPv6.	Instância do servidor que hospeda a réplica primária

Criando e gerenciando uma réplica de disponibilidade

Cmdlets	Descrição	Compatível com
New-SqlAvailabilityReplica	Cria uma nova réplica de disponibilidade. Você pode usar o parâmetro -AsTemplate para criar um objeto de réplica de disponibilidade na memória para cada nova réplica de disponibilidade.	Instância do servidor que hospeda a réplica primária
Join-SqlAvailabilityGroup	Associa uma réplica secundária ao grupo de disponibilidade.	Instância do servidor que hospeda réplica secundária
Remove-SqlAvailabilityReplica	Exclui uma réplica de disponibilidade.	Instância do servidor que hospeda a réplica primária
Set-SqlAvailabilityReplica	Define as propriedades de uma réplica de disponibilidade.	Instância do servidor que hospeda a réplica primária

Adicionando e gerenciando um banco de dados de disponibilidade

Cmdlets	Descrição	Compatível com
Add-SqlAvailabilityDatabase	Na réplica primária, adiciona uma base de dados a um grupo de disponibilidade. Em uma réplica secundária, une um banco de dados secundário a um grupo de disponibilidade.	Qualquer instância de servidor que hospede uma réplica de disponibilidade (o comportamento difere para réplicas primárias e secundárias)
Remover-BaseDeDadosSqlDisponibilidade	Na réplica primária, remove o banco de dados do grupo de disponibilidade. Em uma réplica secundária, remove o banco de dados secundário local dessa réplica.	Qualquer instância de servidor que hospede uma réplica de disponibilidade (o comportamento difere para réplicas primárias e secundárias)
Resume-SqlAvailabilityDatabase	Retoma a movimentação de dados para um banco de dados de disponibilidade suspenso.	A instância do servidor na qual o banco de dados foi suspenso.
Suspend-SqlAvailabilityDatabase	Suspende a movimentação de dados para um banco de dados de disponibilidade.	Qualquer instância de servidor que hospede uma réplica de disponibilidade.

Monitorizar a saúde do grupo de disponibilidade

Os cmdlets do SQL Server a seguir permitem monitorar a integridade de um grupo de disponibilidade e suas réplicas e bancos de dados.

Importante

Você deve ter permissões CONNECT, VIEW SERVER STATE e VIEW ANY DEFINITION para executar esses cmdlets.

Cmdlet	Descrição	Compatível com
Test-SqlAvailabilityGroup	Avalia a integridade de um grupo de disponibilidade avaliando as diretivas de gerenciamento baseado em políticas (PBM) do SQL Server.	Qualquer instância de servidor que hospede uma réplica de disponibilidade.*
Test-SqlAvailabilityReplica	Avalia a integridade das réplicas de disponibilidade avaliando as políticas de gerenciamento baseado em políticas (PBM) do SQL Server.	Qualquer instância de servidor que hospede uma réplica de disponibilidade.*
Test-SqlDatabaseReplicaState	Avalia a integridade de um banco de dados de disponibilidade em todas as réplicas de disponibilidade associadas avaliando as diretivas de gerenciamento baseado em políticas (PBM) do SQL Server.	Qualquer instância de servidor que hospede uma réplica de disponibilidade.*

*Para exibir informações sobre todas as réplicas de disponibilidade em um grupo de disponibilidade, use a instância do servidor que hospeda a réplica primária.

Para obter mais informações, consulte Utilize Políticas Always On para verificar a integridade de um Grupo de Disponibilidade (SQL Server).

Ver também

Visão geral dos grupos de disponibilidade Always On (SQL Server)
Obter Ajuda do SQL Server PowerShell