Test-SqlAvailabilityReplica
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 permisos CONNECT, VIEW SERVER STATE, y VIEW ANY DEFINITION para ejecutar este cmdlet.
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 grupo de disponibilidad MainAg 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 del 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 grupo de disponibilidad MainAg y genera los resultados de evaluación de 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 grupo de disponibilidad MainAg. 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 "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 réplicas de disponibilidad que se van a evaluar.
Type: | AvailabilityReplica[] |
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 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: | 2 |
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