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 указывает исключение для защиты ЗАП для 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