Test-SqlAvailabilityReplica

Referencia

Módulo:: SQLServer

Evalúa el estado de las réplicas de disponibilidad.

Syntax

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

Test-SqlAvailabilityReplica
    [-ShowPolicyDetails]
    [-AllowUserPolicies]
    [-NoRefresh]
    [-InputObject] <AvailabilityReplica[]>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

El cmdlet Test-SqlAvailabilityReplica evalúa el estado de las réplicas de disponibilidad mediante la evaluación de directivas de administración basada en directivas (PBM) de SQL Server. Debe tener CONNECTpermisos , VIEW SERVER STATEy VIEW ANY DEFINITION para ejecutar este cmdlet.

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

Ejemplos

Ejemplo 1: Evaluación del estado de una réplica de disponibilidad

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

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

Ejemplo 2: Evaluación del estado de todas las réplicas de disponibilidad en un grupo de disponibilidad

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

Este comando evalúa el estado de todas las réplicas de disponibilidad en el grupo de disponibilidad denominado MainAg y genera un breve resumen de cada réplica.

Ejemplo 3: Evaluación del estado de una réplica de disponibilidad para cada directiva de PBM

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

Este comando evalúa el estado de la réplica de disponibilidad denominada MainReplica en el MainAg grupo de disponibilidad y genera los resultados de evaluación para cada directiva de PBM que se ejecutó.

Ejemplo 4: Evaluación del estado de una réplica de disponibilidad e inclusión de directivas definidas por el usuario

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

Este comando evalúa el estado de la réplica de disponibilidad denominada MainReplica en el MainAg grupo de disponibilidad. Las directivas definidas por el usuario se incluyen en esta evaluación.

Ejemplo 5: Mostrar todas las réplicas de disponibilidad que están en un estado de error

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

Este comando muestra todas las réplicas de disponibilidad con un estado de mantenimiento de en el MainAg grupo de Error disponibilidad.

Parámetros

-AllowUserPolicies

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

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 réplicas de disponibilidad que se va a evaluar.

Type:	AvailabilityReplica[]
Position:	1
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 una o varias réplicas de disponibilidad. Este parámetro es opcional. Si no se especifica, se usa la ubicación de trabajo actual.

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

-ShowPolicyDetails

Indica que se muestra el resultado de cada evaluación de directiva realizada por este cmdlet. El cmdlet genera un objeto por evaluación de directiva. Este objeto contiene campos que describen los resultados de la evaluación.

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