Test-SqlDatabaseReplicaState
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 STATE
e 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[]