Test-SqlDatabaseReplicaState

Referência

Módulo:: SQLServer

Avalia a integridade de um banco de dados de disponibilidade.

Syntax

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.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	DatabaseReplicaState[]
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-NoRefresh

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	String[]
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Entradas

Microsoft.SqlServer.Management.Smo.DatabaseReplicaState[]