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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Запрос подтверждения перед выполнением командлета.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Указывает массив объектов состояния базы данных доступности. Этот командлет вычисляет работоспособность этих баз данных доступности.
Type: | DatabaseReplicaState[] |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-NoRefresh
Указывает, что этот командлет не будет вручную обновлять объекты, заданные параметрами Path или InputObject .
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Path
Указывает путь к одному или нескольким состояниям кластера реплики базы данных доступности. Этот параметр является необязательным. Если значение не указано, используется значение текущего рабочего расположения.
Type: | String[] |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ShowPolicyDetails
Указывает, что этот командлет показывает результат каждой выполненной оценки политики. Командлет выводит один объект на оценку политики, а результаты оценки доступны в полях объекта.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Показывает, что произойдет при запуске командлета. Командлет не выполняется.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Входные данные
Microsoft.SqlServer.Management.Smo.DatabaseReplicaState[]