Test-SqlAvailabilityGroup

Evalúa el estado de un grupo de disponibilidad.

Syntax

Test-SqlAvailabilityGroup
    [-ShowPolicyDetails]
    [-AllowUserPolicies]
    [-NoRefresh]
    [[-Path] <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Test-SqlAvailabilityGroup
    [-ShowPolicyDetails]
    [-AllowUserPolicies]
    [-NoRefresh]
    [-InputObject] <AvailabilityGroup[]>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

El cmdlet Test-SqlAvailabilityGroup evalúa el estado de un grupo de disponibilidad. Este cmdlet evalúa SQL Server directivas de administración basadas en directivas. Para ejecutar este cmdlet, debe tener CONNECTderechos de usuario , VIEW SERVER STATEy VIEW ANY DEFINITION .

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

Ejemplos

Ejemplo 1: Evaluación del estado de un grupo de disponibilidad

PS C:\> Test-SqlAvailabilityGroup -Path "SQLSERVER:\Sql\Server\InstanceName\AvailabilityGroups\MainAG"

Este comando evalúa el estado del grupo de disponibilidad denominado MainAG. El comando devuelve un resumen.

Ejemplo 2: Evaluación del estado de todos los grupos de disponibilidad

PS C:\> Get-ChildItem "SQLSERVER:\Sql\Server\InstanceName\AvailabilityGroups" | Test-SqlAvailabilityGroup

Este comando obtiene todos los grupos de disponibilidad que tienen réplicas de disponibilidad en la ubicación especificada en el proveedor SQLSERVER: . El comando los pasa al cmdlet actual mediante el operador de canalización. Ese cmdlet evalúa el estado de cada grupo de disponibilidad.

Ejemplo 3: Mostrar resultados para cada directiva de un grupo de disponibilidad

PS C:\> Test-SqlAvailabilityGroup -Path "SQLSERVER:\Sql\Server\InstanceName\AvailabilityGroups\MainAG" -ShowPolicyDetails

Este comando evalúa el estado del grupo de disponibilidad denominado MainAG. Este comando especifica el parámetro ShowPolicyDetails. Por lo tanto, muestra los resultados de evaluación de cada directiva de administración basada en directivas que se ejecutó.

Ejemplo 4: Mostrar los resultados de las directivas definidas por el usuario de un grupo de disponibilidad

PS C:\> Test-SqlAvailabilityGroup -Path "SQLSERVER:\Sql\Server\InstanceName\AvailabilityGroups\MainAG" -AllowUserPolicies

Este comando evalúa el estado del grupo de disponibilidad denominado MainAG. El comando incluye directivas definidas por el usuario en esta evaluación.

Ejemplo 5: Obtener grupos que tienen un estado de error

PS C:\> Get-ChildItem "SQLSERVER:\Sql\Server\InstanceName\AvailabilityGroups" | Test-SqlAvailabilityGroup | Where-Object { $_.HealthState -eq "Error" }

Este comando obtiene todos los grupos de disponibilidad que tienen réplicas de disponibilidad en la ubicación especificada en el proveedor SQLSERVER: . El comando los pasa al cmdlet actual mediante el operador de canalización. Ese cmdlet evalúa el estado de cada grupo de disponibilidad. El comando pasa esos resultados al cmdlet Where-Object , que devuelve resultados basados en la propiedad HealthState .

Parámetros

-AllowUserPolicies

Indica que este cmdlet prueba las directivas de usuario que se encuentran en las categorías de directivas de Always On grupos de disponibilidad.

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 grupos de disponibilidad, como objetos AvailabilityGroup. Este cmdlet evalúa el estado de los grupos de disponibilidad que especifica este parámetro.

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

-NoRefresh

Indica que no actualizará los objetos especificados por el parámetro 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 del grupo de disponibilidad que evalúa este cmdlet. Si no especifica este parámetro, este cmdlet 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 este cmdlet muestra el resultado de cada evaluación de directiva que realiza. El cmdlet devuelve un objeto por evaluación de directiva. Cada objeto de directiva incluye los resultados de la evaluación. Esta información incluye si la directiva se ha pasado o no, el nombre de la directiva y la categoría de directiva.

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