Test-SqlDatabaseReplicaState
Оценивает работоспособность базы данных доступности.
Синтаксис
Test-SqlDatabaseReplicaState
[-ShowPolicyDetails]
[-AllowUserPolicies]
[-NoRefresh]
[[-Path] <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Test-SqlDatabaseReplicaState
[-ShowPolicyDetails]
[-AllowUserPolicies]
[-NoRefresh]
[-InputObject] <DatabaseReplicaState[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Командлет Test-SqlDatabaseReplicaState оценивает работоспособность базы данных доступности на всех присоединенных репликах доступности, оценивая политики управления на основе политик на основе 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:\> $Path = "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\DatabaseReplicaStates\MainReplica.MainDatabase"
PS C:\> Test-SqlDatabaseReplicaState -Path $Path
Эта команда оценивает работоспособность базы данных доступности с именем MainDatabase
в реплике доступности в группе MainAg
доступности и выводит краткую сводкуMainReplica
.
Пример 2. Оценка работоспособности всех баз данных доступности в группе доступности
PS C:\> Get-ChildItem "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\DatabaseReplicaStates" | Test-SqlDatabaseReplicaState
Эта команда оценивает работоспособность всех баз данных доступности в MainAg
группе доступности и выводит краткую сводку для каждой базы данных.
Пример 3. Оценка работоспособности всех баз данных доступности в группе доступности с результатами оценки PBM
PS C:\> Get-ChildItem "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\DatabaseReplicaStates" | Test-SqlDatabaseReplicaState -ShowPolicyDetails
Эта команда оценивает работоспособность всех баз данных доступности в MainAg
группе доступности и выводит результаты оценки для каждой выполненной политики PBM.
Пример 4. Оценка работоспособности всех баз данных доступности в группе доступности и включение пользовательских политик
PS C:\> Get-ChildItem "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\DatabaseReplicaStates" | Test-SqlDatabaseReplicaState -AllowUserPolicies
Эта команда оценивает работоспособность всех баз данных доступности в MainAg
группе доступности.
В эту оценку включаются пользовательские политики.
Пример 5. Отображение всех баз данных доступности в состоянии работоспособности ошибок
PS C:\> Get-ChildItem "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\DatabaseReplicaStates" | Test-SqlDatabaseReplicaState | 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
Указывает массив объектов состояния базы данных доступности. Этот командлет вычисляет работоспособность этих баз данных доступности.
Тип: | DatabaseReplicaState[] |
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.DatabaseReplicaState[]