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

Aplica-se a: simSQL Server (todas as versões compatíveis)

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 AlwaysOn (SQL Server).

Configurando uma instância de servidor para o 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, InputObject ou 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 para o Grupos de disponibilidade AlwaysOn, veja Pré-requisitos, restrições e recomendações para os 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.

Backing Up and Restoring Databases and Transaction Logs

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, veja 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

Creating and Managing an Availability Replica

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 do grupo 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, veja Usar 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