Test-SqlDatabaseReplicaState

  • Referência
Módulo:
SQLServer

Avalia a integridade de um banco de dados de disponibilidade.

Sintaxe

Test-SqlDatabaseReplicaState
    [-ShowPolicyDetails]
    [-AllowUserPolicies]
    [-NoRefresh]
    [[-Path] <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Test-SqlDatabaseReplicaState
    [-ShowPolicyDetails]
    [-AllowUserPolicies]
    [-NoRefresh]
    [-InputObject] <DatabaseReplicaState[]>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

O cmdlet Test-SqlDatabaseReplicaState avalia a integridade de um banco de dados de disponibilidade em todas as réplicas de disponibilidade ingressadas 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 um banco de dados de disponibilidade

PS C:\> $Path = "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\DatabaseReplicaStates\MainReplica.MainDatabase"
PS C:\> Test-SqlDatabaseReplicaState -Path $Path

Esse comando avalia a integridade do banco de dados de disponibilidade nomeado MainDatabase na réplica MainReplica de disponibilidade no grupo MainAg de disponibilidade e gera um breve resumo.

Exemplo 2: avaliar a integridade de todos os bancos de dados de disponibilidade em um grupo de disponibilidade

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

Esse comando avalia a integridade de todos os bancos de dados de disponibilidade no MainAg grupo de disponibilidade e gera um breve resumo para cada banco de dados.

Exemplo 3: avaliar a integridade de todos os bancos de dados de disponibilidade em um grupo de disponibilidade mostrando os resultados da avaliação do PBM

PS C:\> Get-ChildItem "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\DatabaseReplicaStates" | Test-SqlDatabaseReplicaState -ShowPolicyDetails

Esse comando avalia a integridade de todos os bancos de dados de disponibilidade no MainAg grupo de disponibilidade e gera os resultados de avaliação para cada política de PBM executada.

Exemplo 4: avaliar a integridade de todos os bancos de dados de disponibilidade em um grupo de disponibilidade e incluir políticas definidas pelo usuário

PS C:\> Get-ChildItem "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\DatabaseReplicaStates" | Test-SqlDatabaseReplicaState -AllowUserPolicies

Esse comando avalia a integridade de todos os bancos de dados de disponibilidade no MainAg grupo de disponibilidade. Políticas definidas pelo usuário são incluídas nesta avaliação.

Exemplo 5: mostrar todos os bancos de dados de disponibilidade em um estado de integridade de erro

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

Esse comando mostra todos os bancos de dados de disponibilidade com um estado de integridade do MainAg grupo de Error disponibilidade.

Parâmetros

-AllowUserPolicies

Indica que esse cmdlet executa as políticas de usuário encontradas nas categorias de política 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 objetos de estado do banco de dados de disponibilidade. Esse cmdlet calcula a integridade desses bancos de dados de disponibilidade.

Tipo:DatabaseReplicaState[]
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 um ou mais estados de cluster de réplica de banco de dados do banco de dados de disponibilidade. Esse é um parâmetro opcional. Se não for especificado, o valor do 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 esse cmdlet mostra o resultado de cada avaliação de política executada. O cmdlet gera um objeto por avaliação de política e os resultados da avaliação estão disponíveis nos campos do objeto.

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.DatabaseReplicaState[]