Compartilhar via

Test-SqlAvailabilityReplica

  • Referência
Módulo:
SQLPS

Avalia a integridade das réplicas de disponibilidade.

Sintaxe

Test-SqlAvailabilityReplica
    [-ShowPolicyDetails]
    [-AllowUserPolicies]
    [-NoRefresh]
    [[-Path] <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Test-SqlAvailabilityReplica
    [-ShowPolicyDetails]
    [-AllowUserPolicies]
    [-NoRefresh]
    [-InputObject] <AvailabilityReplica[]>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

O cmdlet Test-SqlAvailabilityReplica avalia a integridade das réplicas de disponibilidade avaliando SQL Server políticas de PBM (gerenciamento baseado em políticas). Você deve ter as permissões CONNECT, VIEW SERVER STATE e VIEW ANY DEFINITION para executar esse cmdlet.

Exemplos

Exemplo 1: Avaliar a integridade de um réplica de disponibilidade

PS C:\> Test-SqlAvailabilityReplica -Path "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\AvailabilityReplicas\MainReplica"

Esse comando avalia a integridade do réplica de disponibilidade chamado MainReplica no grupo de disponibilidade MainAg e gera um breve resumo.

Exemplo 2: Avaliar a integridade de todas as réplicas de disponibilidade em um grupo de disponibilidade

PS C:\> Get-ChildItem "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\AvailabilityReplicas" | Test-SqlAvailabilityReplica

Esse comando avalia a integridade de todas as réplicas de disponibilidade no grupo de disponibilidade chamado MainAg e gera um breve resumo para cada réplica.

Exemplo 3: avaliar a integridade de um réplica de disponibilidade para cada política de PBM

PS C:\> Test-SqlAvailabilityReplica -Path "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\AvailabilityReplicas\MainReplica" -ShowPolicyDetails

Esse comando avalia a integridade do réplica de disponibilidade chamado MainReplica no grupo de disponibilidade MainAg e gera os resultados de avaliação para cada política de PBM executada.

Exemplo 4: avaliar a integridade de um réplica de disponibilidade e incluir políticas definidas pelo usuário

PS C:\> Test-SqlAvailabilityReplica -Path "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\AvailabilityReplicas\MainReplica" -AllowUserPolicies

Esse comando avalia a integridade do réplica de disponibilidade chamado MainReplica no grupo de disponibilidade MainAg. Políticas definidas pelo usuário são incluídas nesta avaliação.

Exemplo 5: Mostrar todas as réplicas de disponibilidade que estão em um estado de erro

PS C:\> Get-ChildItem "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\AvailabilityReplicas" | Test-SqlAvailabilityReplica | Where-Object { $_.HealthState -eq "Error" }

Este comando mostra todas as réplicas de disponibilidade com um estado de integridade de "Erro" no grupo de disponibilidade MainAg.

Parâmetros

-AllowUserPolicies

Indica que esse cmdlet executa as políticas de usuário encontradas nas categorias de política AlwaysOn.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InputObject

Especifica uma matriz de réplicas de disponibilidade a serem avaliadas.

Tipo:AvailabilityReplica[]
Cargo:2
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-NoRefresh

Indica que esse cmdlet não atualizará manualmente os objetos especificados pelos parâmetros Path ou InputObject .

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Path

Especifica o caminho para uma ou mais réplicas de disponibilidade. Esse parâmetro é opcional. Se não for especificado, o local de trabalho atual será usado.

Tipo:String[]
Cargo:2
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ShowPolicyDetails

Indica que o resultado de cada avaliação de política executada por esse cmdlet é mostrado. O cmdlet gera um objeto por avaliação de política. Esse objeto contém campos que descrevem os resultados da avaliação.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

Microsoft.SqlServer.Management.Smo.AvailabilityReplica