Partilhar via

Test-SqlAvailabilityReplica

  • Referência
Módulo:
SQLServer

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ítica). Você deve ter CONNECT, VIEW SERVER STATEe VIEW ANY DEFINITION permissões para executar este cmdlet.

Module requirements: version 21+ on PowerShell 5.1; version 22+ on PowerShell 7.x.

Exemplos

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

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

Este comando avalia a integridade da réplica de disponibilidade nomeada MainReplica no MainAg grupo de disponibilidade 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 nomeado MainAg e gera um breve resumo para cada réplica.

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

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

Este comando avalia a integridade da réplica de disponibilidade nomeada MainReplica no MainAg grupo de disponibilidade e gera os resultados da avaliação de cada política de PBM executada.

Exemplo 4: Avaliar a integridade de uma 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

Este comando avalia a integridade da réplica de disponibilidade nomeada MainReplica no MainAg grupo de disponibilidade. 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 do MainAg grupo de Error disponibilidade.

Parâmetros

-AllowUserPolicies

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

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:1
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:1
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. Este 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[]