Test-SqlAvailabilityGroup

  • Ссылка
Модуль:
SQLServer

Оценивает работоспособность группы доступности.

Синтаксис

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

Описание

Командлет Test-SqlAvailabilityGroup оценивает работоспособность группы доступности. Этот командлет оценивает SQL Server политик управления на основе политик. Чтобы запустить этот командлет, необходимо иметь CONNECTVIEW SERVER STATEправа пользователя и VIEW ANY DEFINITION права пользователя.

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

Примеры

Пример 1. Оценка работоспособности группы доступности

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

Эта команда оценивает работоспособность группы доступности с именем MainAG. Команда возвращает сводку.

Пример 2. Оценка работоспособности всех групп доступности

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

Эта команда возвращает все группы доступности, имеющие реплики доступности в указанном расположении в SQLSERVER: поставщик. Команда передает их текущему командлету с помощью оператора конвейера. Этот командлет оценивает работоспособность каждой группы доступности.

Пример 3. Отображение результатов для каждой политики группы доступности

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

Эта команда оценивает работоспособность группы доступности с именем MainAG. Эта команда задает параметр ShowPolicyDetails. Таким образом, в нем отображаются результаты оценки для каждой политики управления на основе политик, которая выполнялась.

Пример 4. Отображение результатов для пользовательских политик группы доступности

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

Эта команда оценивает работоспособность группы доступности с именем MainAG. Эта команда включает определяемые пользователем политики в этой оценке.

Пример 5. Получение групп с состоянием ошибки

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

Эта команда возвращает все группы доступности, имеющие реплики доступности в указанном расположении в SQLSERVER: поставщик. Команда передает их текущему командлету с помощью оператора конвейера. Этот командлет оценивает работоспособность каждой группы доступности. Команда передает эти результаты командлету Where-Object , который возвращает результаты на основе свойства HealthState .

Параметры

-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

Указывает массив группы доступности в виде объектов AvailabilityGroup. Этот командлет оценивает работоспособность групп доступности, указанных этим параметром.

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