Test-SqlAvailabilityReplica
Оценивает работоспособность реплик доступности.
Синтаксис
Test-SqlAvailabilityReplica
[-ShowPolicyDetails]
[-AllowUserPolicies]
[-NoRefresh]
[[-Path] <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Test-SqlAvailabilityReplica
[-ShowPolicyDetails]
[-AllowUserPolicies]
[-NoRefresh]
[-InputObject] <AvailabilityReplica[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Командлет Test-SqlAvailabilityReplica оценивает работоспособность реплик доступности путем оценки SQL Server политик управления на основе политик (PBM).
Для выполнения этого командлета необходимо иметь CONNECT
VIEW SERVER STATE
разрешения и VIEW ANY DEFINITION
разрешения.
Module requirements: version 21+ on PowerShell 5.1; version 22+ on PowerShell 7.x.
Примеры
Пример 1. Оценка работоспособности реплики доступности
PS C:\> Test-SqlAvailabilityReplica -Path "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\AvailabilityReplicas\MainReplica"
Эта команда оценивает работоспособность реплики доступности, именованной MainReplica
в MainAg
группе доступности, и выводит краткую сводку.
Пример 2. Оценка работоспособности всех реплик доступности в группе доступности
PS C:\> Get-ChildItem "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\AvailabilityReplicas" | Test-SqlAvailabilityReplica
Эта команда оценивает работоспособность всех реплик доступности в именованной MainAg
группе доступности и выводит краткую сводку для каждой реплики.
Пример 3. Оценка работоспособности реплики доступности для каждой политики PBM
PS C:\> Test-SqlAvailabilityReplica -Path "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\AvailabilityReplicas\MainReplica" -ShowPolicyDetails
Эта команда оценивает работоспособность реплики доступности, именованной MainReplica
в MainAg
группе доступности, и выводит результаты оценки для каждой выполненной политики PBM.
Пример 4. Оценка работоспособности реплики доступности и включение пользовательских политик
PS C:\> Test-SqlAvailabilityReplica -Path "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\AvailabilityReplicas\MainReplica" -AllowUserPolicies
Эта команда оценивает работоспособность реплики доступности, именованной MainReplica
в MainAg
группе доступности.
В эту оценку включаются пользовательские политики.
Пример 5. Отображение всех реплик доступности, которые находятся в состоянии ошибки
PS C:\> Get-ChildItem "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\AvailabilityReplicas" | Test-SqlAvailabilityReplica | Where-Object { $_.HealthState -eq "Error" }
Эта команда отображает все реплики доступности с состоянием Error
работоспособности в MainAg
группе доступности.
Параметры
-AllowUserPolicies
Указывает, что этот командлет выполняет пользовательские политики, найденные в категориях политики Always On.
Тип: | SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Confirm
Запрос подтверждения перед выполнением командлета.
Тип: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-InputObject
Указывает массив реплик доступности для оценки.
Тип: | AvailabilityReplica[] |
Position: | 1 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-NoRefresh
Указывает, что этот командлет не будет вручную обновлять объекты, указанные параметрами Path или InputObject .
Тип: | SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Path
Указывает путь к одной или нескольким репликам доступности. Это необязательный параметр. Если значение не указано, используется текущее рабочее расположение.
Тип: | String[] |
Position: | 1 |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-ShowPolicyDetails
Указывает, что отображается результат каждой оценки политики, выполняемой этим командлетом. Командлет выводит один объект на оценку политики. Этот объект содержит поля, описывающие результаты оценки.
Тип: | SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-WhatIf
Показывает, что произойдет при запуске командлета. Командлет не выполняется.
Тип: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Входные данные
Microsoft.SqlServer.Management.Smo.AvailabilityReplica[]