Test-SqlDatabaseReplicaState

Referencia

Módulo:: SQLPS

Evalúa el estado de una base de datos de disponibilidad.

Syntax

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

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

Description

El cmdlet Test-SqlDatabaseReplicaState evalúa el estado de una base de datos de disponibilidad en todas las réplicas de disponibilidad unidas mediante la evaluación de directivas de administración basada en directivas (PBM) de SQL Server. Debe tener permisos CONNECT, VIEW SERVER STATE, y VIEW ANY DEFINITION para ejecutar este cmdlet.

Ejemplos

Ejemplo 1: Evaluación del estado de una base de datos de disponibilidad

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

Este comando evalúa el estado de la base de datos de disponibilidad denominada MainDatabase en la réplica de disponibilidad MainReplica del grupo de disponibilidad MainAg y genera un breve resumen.

Ejemplo 2: Evaluación del estado de todas las bases de datos de disponibilidad en un grupo de disponibilidad

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

Este comando evalúa el estado de todas las bases de datos de disponibilidad del grupo de disponibilidad MainAg y genera un breve resumen de cada base de datos.

Ejemplo 3: Evaluación del estado de todas las bases de datos de disponibilidad en un grupo de disponibilidad que muestra los resultados de la evaluación de PBM

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

Este comando evalúa el estado de todas las bases de datos de disponibilidad en el grupo de disponibilidad MainAg y genera los resultados de evaluación de cada directiva de PBM que se ejecutó.

Ejemplo 4: Evaluar el estado de todas las bases de datos de disponibilidad de un grupo de disponibilidad e incluir directivas definidas por el usuario

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

Este comando evalúa el estado de todas las bases de datos de disponibilidad en el grupo de disponibilidad MainAg. Las directivas definidas por el usuario se incluyen en esta evaluación.

Ejemplo 5: Mostrar todas las bases de datos de disponibilidad en un estado de mantenimiento de error

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

Este comando muestra todas las bases de datos de disponibilidad con un estado de mantenimiento de "Error" en el grupo de disponibilidad MainAg.

Parámetros

-AllowUserPolicies

Indica que este cmdlet ejecuta directivas de usuario que se encuentran en las categorías de directivas AlwaysOn.

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

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

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

-InputObject

Especifica una matriz de objetos de estado de base de datos de disponibilidad. Este cmdlet calcula el estado de estas bases de datos de disponibilidad.

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

-NoRefresh

Indica que este cmdlet no actualizará manualmente los objetos especificados por los parámetros Path o InputObject .

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

-Path

Especifica la ruta de acceso a uno o varios estados de clúster de réplica de base de datos de la base de datos de disponibilidad. Se trata de un parámetro opcional. Si no se especifica, se usa el valor de la ubicación de trabajo actual.

Type:	String[]
Position:	2
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ShowPolicyDetails

Indica que este cmdlet muestra el resultado de cada evaluación de directiva realizada. El cmdlet genera un objeto por evaluación de directiva y los resultados de la evaluación están disponibles en los campos del objeto .

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

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

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