Set-TeamsProtectionPolicyRule

Синтаксис

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

Set-TeamsProtectionPolicyRule
    [-Identity] <RuleIdParameter>
    [-Comments <String>]
    [-Confirm]
    [-ExceptIfRecipientDomainIs <Word[]>]
    [-ExceptIfSentTo <RecipientIdParameter[]>]
    [-ExceptIfSentToMemberOf <RecipientIdParameter[]>]
    [-WhatIf]
    [<CommonParameters>]

Описание

Примеры

Пример 1

Set-TeamsProtectionPolicyRule -Identity "Teams Protection Policy Rule" -ExceptIfRecipientDomainIs research.contoso.com

Параметры

-Comments

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

Параметр Comments определяет информативные комментарии к правилу, например о назначении правила или о том, какие изменения в него уже вносились. Длина комментария не должна превышать 1024 символов.

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

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

-Confirm

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

Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. То, как этот переключатель влияет на командлет, зависит от того, требует ли командлет подтверждения перед продолжением.

• Деструктивные командлеты (например, командлеты Remove-) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис: -Confirm:$false.
• Большинство других командлетов (например, командлеты New- и Set-) не имеют встроенной паузы. Для этих командлетов указание параметра Confirm без значения приводит к паузе, которая вынуждает вас подтвердить команду перед продолжением.

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

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

-ExceptIfRecipientDomainIs

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

Параметр ExceptIfRecipientDomainIs указывает исключение из ZAP для защиты Teams, которое ищет получателей сообщений Teams с адресами электронной почты в указанных доменах.

Чтобы заменить все существующие домены указанными значениями, используйте следующий синтаксис: Domain1,Domain2,...DomainN.

Чтобы добавить домены, не затрагивая другие существующие значения, используйте следующий синтаксис.

$DomainsAdd = Get-TeamsProtectionPolicyRule -Identity "Teams Protection Policy Rule" | select -Expand ExceptIfRecipientDomainIs

$DomainsAdd += "Domain1","Domain2",..."DomainN"

Set-TeamsProtectionPolicyRule -Identity "Teams Protection Policy Rule" -ExceptIfRecipientDomainIs $DomainsAdd

Чтобы удалить домены без влияния на другие существующие значения, используйте следующий синтаксис:

• Выполните следующие команды, чтобы просмотреть существующий список значений по порядку.

  $x = Get-TeamsProtectionPolicyRule -Identity "Teams Protection Policy Rule"

  $d = [System.Collections.ArrayList]($x.ExceptIfRecipientDomainIs)

  $d

  Первое значение в списке имеет индекс 0, второе — 1 и т. д.

• Чтобы указать значение для удаления, используйте порядковый номер. Например, чтобы удалить седьмое значение в списке, выполните следующие команды:

  $d.RemoveAt(6)

  Set-TeamsProtectionPolicyRule -Identity "Teams Protection Policy Rule" -ExceptIfRecipientDomainIs $d

Чтобы очистить список, используйте значение $null для этого параметра.

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

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

-ExceptIfSentTo

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

Параметр ExceptIfSentTo указывает исключение ZAP для защиты Teams, которое ищет получателей сообщений Teams. Вы можете использовать любое значение, однозначно определяющее получателя. Например:

• Имя
• Псевдоним
• различающееся имя (DN);
• различающееся имя (DN);
• Каноническое краткое имя
• GUID

Чтобы заменить всех существующих получателей указанными значениями, используйте следующий синтаксис: "User1","User2",..."UserN".

Чтобы добавить получателей, не затрагивая другие существующие значения, используйте следующий синтаксис.

$UsersAdd = Get-TeamsProtectionPolicyRule -Identity "Teams Protection Policy Rule" | select -Expand ExceptIfSentTo

$UsersAdd += "User1","User2",..."UserN"

Set-TeamsProtectionPolicyRule -Identity "Teams Protection Policy Rule" -ExceptIfSentTo $UsersAdd

Чтобы удалить получателей без влияния на другие существующие значения, используйте следующий синтаксис.

• Выполните следующие команды, чтобы просмотреть существующий список значений по порядку.

  $x = Get-TeamsProtectionPolicyRule -Identity "Teams Protection Policy Rule"

  $u = [System.Collections.ArrayList]($x.ExceptIfSentTo)

  $u

  Первое значение в списке имеет индекс 0, второе — 1 и т. д.

• Чтобы указать значение для удаления, используйте порядковый номер. Например, чтобы удалить седьмое значение в списке, выполните следующие команды:

  $u.RemoveAt(6)

  Set-TeamsProtectionPolicyRule -Identity "Teams Protection Policy Rule" -ExceptIfSentTo $u

Чтобы очистить список, используйте значение $null для этого параметра.

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

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

-ExceptIfSentToMemberOf

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

Параметр ExceptIfSentToMemberOf указывает исключение ZAP для защиты Teams, которое ищет сообщения Teams, отправленные участникам групп рассылки или групп безопасности с включенной почтой. Можно использовать любое уникальное значение, идентифицирующее группу. Например:

• Имя
• Псевдоним
• различающееся имя (DN);
• различающееся имя (DN);
• Каноническое краткое имя
• GUID

Чтобы добавлять группы, не затрагивая другие существующие значения, используйте следующий синтаксис:

$GroupsAdd = Get-TeamsProtectionPolicyRule -Identity "Teams Protection Policy Rule" | select -Expand ExceptIfSentToMemberOf

$GroupsAdd += "Group1","Group2",..."GroupN"

Set-TeamsProtectionPolicyRule -Identity "Teams Protection Policy Rule" -ExceptIfSentToMemberOf $GroupsAdd

Чтобы удалить группы без влияния на другие существующие значения, используйте следующий синтаксис.

• Выполните следующие команды, чтобы просмотреть существующий список значений по порядку.

  $x = Get-TeamsProtectionPolicyRule -Identity "Teams Protection Policy Rule"

  $g = [System.Collections.ArrayList]($x.ExceptIfSentToMemberOf)

  $g

  Первое значение в списке имеет индекс 0, второе — 1 и т. д.

• Чтобы указать значение для удаления, используйте порядковый номер. Например, чтобы удалить седьмое значение в списке, выполните следующие команды:

  $g.RemoveAt(6)

  Set-TeamsProtectionPolicyRule -Identity "Teams Protection Policy Rule" -ExceptIfSentTo $g

Если удалить группу после создания правила, для ZAP для Teams не создается исключений для сообщений, отправляемых участникам группы.

Чтобы очистить список, используйте значение $null для этого параметра.

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

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

-Identity

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

Параметр Identity определяет правило политики защиты Teams, которое вы хотите изменить. В организации есть только одно правило политики защиты Teams с именем "Правило политики защиты Teams".

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

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

-WhatIf

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

Переключатель WhatIf показывает, что команда делает без каких-либо изменений. С этим параметром не нужно указывать значение.

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

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

CommonParameters