Get-ATPProtectionPolicyRule

Модуль:
Exchange PowerShell

Этот командлет доступен только в облачной службе.

Используйте командлет Get-ATPProtectionPolicyRule для просмотра правил для Microsoft Defender защиты Office 365 в предустановленных политиках безопасности. Правила указывают условия и исключения получателя для защиты, а также позволяют включить и отключить связанные предустановленные политики безопасности.

Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.

Синтаксис

Default (По умолчанию) 

Get-ATPProtectionPolicyRule
    [[-Identity] <RuleIdParameter>]
    [-State <RuleState>]
    [<CommonParameters>]

Описание

Дополнительные сведения о предустановленных политиках безопасности в PowerShell см. в разделе Предустановленные политики безопасности в Exchange Online PowerShell.

Для его запуска необходимо получить соответствующие разрешения. Хотя в этой статье перечислены все параметры командлета, у вас может не быть доступа к некоторым параметрам, если они не включены в назначенные вам разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.

Примеры

Пример 1

Get-ATPProtectionPolicyRule | Format-Table Name,State

В этом примере возвращается сводный список правил для Defender для защиты Office 365 в предустановленных политиках безопасности.

Пример 2

Get-ATPProtectionPolicyRule -Identity "Strict Preset Security Policy"

В этом примере возвращаются подробные сведения о правиле с именем Strict Preset Security Policy.

Параметры

-Identity

Применимо: Exchange Online

Параметр Identity определяет правило, которое необходимо просмотреть. Можно использовать любое значение, уникальным образом идентифицирующее правило. Пример:

  • имя;
  • различающееся имя (DN);
  • GUID

По умолчанию доступные правила (если они существуют) называются Standard Предустановленная политика безопасности и Строгая предустановленная политика безопасности.

Внимание! Значение $null или несуществующее значение для параметра Identity возвращает все объекты, как если бы вы выполнили команду Get- без параметра Identity. Убедитесь, что все списки значений для параметра Identity являются точными и не содержат несуществующих $null значений.

Свойства параметров

Тип:RuleIdParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:0
Обязательно:False
Значение из конвейера:True
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-State

Применимо: Exchange Online

Параметр State фильтрует результаты по состоянию правила. Допустимые значения:

  • Включено
  • Отключено

Свойства параметров

Тип:RuleState
Default value:None
Допустимые значения:Enabled, Disabled
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.