Visão geral de cmdlets do PowerShell para grupos de disponibilidade AlwaysOn

Aplica-se a: SQL Server

Microsoft O PowerShell é um shell de linha de comando baseado em tarefa e linguagem de script criado especialmente para a administração do sistema. Grupos de disponibilidade AlwaysOn fornece 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 executado com o início bem-sucedido de uma ação. Isso não indica que o trabalho planejado, como o failover de um grupo de disponibilidade, foi concluído. Ao gerar o script de uma sequência de ações, talvez seja necessário verificar o status das ações e esperar que elas sejam concluídas.

Observação

Para obter uma lista de tópicos nos Manuais Online do SQL Server que descrevem como usar os cmdlets para executar tarefas do Grupos de disponibilidade AlwaysOn , confira a seção “Tarefas relacionadas” de Visão geral dos grupos de disponibilidade Always On (SQL Server).

Configurando uma instância de servidor para grupos de disponibilidade AlwaysOn

Cmdlets	Descrição	Com suporte em
Disable-SqlAlwaysOn	Desabilita o recurso Grupos de disponibilidade AlwaysOn em uma instância de servidor.	A instância de servidor especificada pelo parâmetro Path, InputObjectou Name . (Deve ser uma edição do SQL Server que dê suporte ao Grupos de disponibilidade AlwaysOn.)
Enable-SqlAlwaysOn	Habilita o Grupos de disponibilidade AlwaysOn em uma instância do SQL Server que dá suporte ao recurso Grupos de disponibilidade AlwaysOn . Para obter informações sobre suporte dos grupos de disponibilidade AlwaysOn, confira Pré-requisitos, restrições e recomendações para grupos de disponibilidade AlwaysOn (SQL Server).	Qualquer edição do SQL Server que dê suporte ao Grupos de disponibilidade AlwaysOn.
New-SqlHadrEndPoint	Cria um novo ponto de extremidade de espelhamento de banco de dados em uma instância de servidor. Esse ponto de extremidade é necessário para a movimentação de dados entre os bancos de dados primário e secundário.	Qualquer instância do SQL Server
Set-SqlHadrEndpoint	Altera as propriedades de um ponto de extremidade de espelhamento de banco de dados existente, como o nome, o estado ou as propriedades de autenticação.	Uma instância de servidor que dá suporte ao Grupos de disponibilidade AlwaysOn e não tem 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	Com suporte em
Backup-SqlDatabase	Cria um backup de dados ou de log.	Qualquer banco de dados online (para o Grupos de disponibilidade AlwaysOn, 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 o Grupos de disponibilidade AlwaysOn, uma instância de servidor que hospeda uma réplica secundária)

Importante

Ao preparar um banco de dados secundário, é necessário 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, confira Preparar um banco de dados secundário manualmente para um grupo de disponibilidade (SQL Server).

Criando e gerenciando um grupo de disponibilidade

Cmdlets	Descrição	Com suporte em
New-SqlAvailabilityGroup	Cria um novo grupo de disponibilidade.	Instância de servidor para hospedar a réplica primária
Remove-SqlAvailabilityGroup	Exclui um grupo de disponibilidade.	Instância de servidor habilitada para HADR
Set-SqlAvailabilityGroup	Define as propriedades de um grupo de disponibilidade; coloca um grupo de disponibilidade online/offline	Instância de servidor que hospeda a réplica primária
Switch-SqlAvailabilityGroup	Inicia um dos seguintes formulários de failover: Um failover forçado de um grupo de disponibilidade (com possível perda de dados). Um failover manual de um grupo de disponibilidade.	Instância de servidor que hospeda a réplica secundária de destino

Criando e gerenciando um ouvinte de grupo de disponibilidade

Cmdlet	Descrição	Com suporte em
New-SqlAvailabilityGroupListener	Cria um novo ouvinte de grupo de disponibilidade e conecta-o a um grupo de disponibilidade existente.	Instância de 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 de servidor que hospeda a réplica primária
Add-SqlAvailabilityGroupListenerStaticIp	Adiciona um endereço IP estático à configuração de um ouvinte de grupo de disponibilidade existente. O endereço IP poderá ser um endereço IPv4 com sub-rede ou um endereço IPv6.	Instância de servidor que hospeda a réplica primária

Criando e gerenciando uma réplica de disponibilidade

Cmdlets	Descrição	Com suporte em
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 de memória para cada nova réplica de disponibilidade.	Instância de servidor que hospeda a réplica primária
Join-SqlAvailabilityGroup	Une uma réplica secundária ao grupo de disponibilidade.	Instância de servidor que hospeda a réplica secundária
Remove-SqlAvailabilityReplica	Exclui uma réplica de disponibilidade.	Instância de servidor que hospeda a réplica primária
Set-SqlAvailabilityReplica	Define as propriedades de uma réplica de disponibilidade.	Instância de servidor que hospeda a réplica primária

Adicionando e gerenciando um banco de dados de disponibilidade

Cmdlets	Descrição	Com suporte em
Add-SqlAvailabilityDatabase	Na réplica primária, adiciona um banco 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 hospeda uma réplica de disponibilidade (o comportamento difere para réplicas primárias e secundárias)
Remove-SqlAvailabilityDatabase	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 da réplica secundária local.	Qualquer instância de servidor que hospeda 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.	As instância do servidor na qual o banco de dados é suspenso.
Suspend-SqlAvailabilityDatabase	Suspende a movimentação de dados para um banco de dados de disponibilidade.	Qualquer instância de servidor que hospeda uma réplica de disponibilidade.

Monitorando a integridade de grupos de disponibilidade

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

Importante

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

Cmdlet	Descrição	Com suporte em
Test-SqlAvailabilityGroup	Avalia a integridade de um grupo de disponibilidade avaliando as políticas do PBM (gerenciamento baseado em políticas) do SQL Server.	Qualquer instância de servidor que hospede uma réplica de disponibilidade.*
Test-SqlAvailabilityReplica	Avalia a integridade de réplicas de disponibilidade avaliando as políticas do PBM (gerenciamento baseado em políticas) 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 unidas avaliando as políticas do PBM (gerenciamento baseado em políticas) 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, confiraUsar as políticas AlwaysOn para exibir a integridade de um grupo de disponibilidade (SQL Server).

Consulte Também

Visão geral dos Grupos de Disponibilidade AlwaysOn (SQL Server)
Get Help SQL Server PowerShell