Set-SafeLinksRule

Синтаксис

Set-SafeLinksRule
   [-Identity] <RuleIdParameter>
   [-Comments <String>]
   [-Confirm]
   [-ExceptIfRecipientDomainIs <Word[]>]
   [-ExceptIfSentTo <RecipientIdParameter[]>]
   [-ExceptIfSentToMemberOf <RecipientIdParameter[]>]
   [-Name <String>]
   [-Priority <Int32>]
   [-RecipientDomainIs <Word[]>]
   [-SafeLinksPolicy <SafeLinksPolicyIdParameter>]
   [-SentTo <RecipientIdParameter[]>]
   [-SentToMemberOf <RecipientIdParameter[]>]
   [-WhatIf]
   [<CommonParameters>]

Описание

"Безопасные ссылки" — это функция защитника Майкрософт для Office 365, которая проверяет ссылки в сообщениях электронной почты, чтобы проверить, ведут ли они на вредоносные веб-сайты. Когда пользователь выбирает ссылку в сообщении, URL-адрес временно перезаписывается и сверяется со списком известных вредоносных веб-сайтов. "Безопасные ссылки" включает функцию отчетов о трассировке URL-адреса, которая помогает определить пользователя, прошедшего по ссылке на вредоносный веб-сайт.

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

Примеры

Пример 1

Set-SafeLinksRule -Identity "Engineering Department URL Rule" -ExceptIfRecipientDomainIs fabrikam.com

В этом примере изменяется существующее правило безопасных ссылок с именем Engineering Department URL Rule, чтобы исключить сообщения, отправленные на домен fabrikam.com.

Параметры

-— Safelinkspolicy позволяет

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

Чтобы найти эти значения, выполните команду Get-ComplianceSearch | Format-Table -Auto Name,JobRunId,Status

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

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

Type:SafeLinksPolicyIdParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-— SentTo

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

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

Update Если значения содержат пробелы или в противном случае требуются кавычки, используйте следующий синтаксис: "Value1","Value2",..."ValueN" .

Type:RecipientIdParameter[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-— ЕксцептифреЦипиентдомаинис

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

Type:Word[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-— Ексцептифсентто

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

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

Update Если значения содержат пробелы или в противном случае требуются кавычки, используйте следующий синтаксис: "Value1","Value2",..."ValueN" .

Type:RecipientIdParameter[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-— Ексцептифсенттомембероф

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

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

Update Если значения содержат пробелы или в противном случае требуются кавычки, используйте следующий синтаксис: "Value1","Value2",..."ValueN" .

PD_UCC_Multiple_Values

Type:RecipientIdParameter[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-— Комментарии

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-— РеЦипиентдомаинис

Параметр RecipientDomainIs задает условие, которое ищет получателей с электронными адресами на указанных доменах. Можно указать несколько доменов, разделенных запятыми.

Type:Word[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-— Сенттомембероф

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

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

Update Если значения содержат пробелы или в противном случае требуются кавычки, используйте следующий синтаксис: "Value1","Value2",..."ValueN" .

PD_UCC_Multiple_Values

Type:RecipientIdParameter[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-Confirm

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

  • Деструктивные командлеты (например, Remove-* командлеты) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Для этих командлетов вы можете пропустить запрос на подтверждение с помощью этого синтаксиса: -Confirm:$false .
  • Большинство других командлетов (например, New-* и Set-*командлеты) не имеют встроенной паузы. Для этих командлетов указание переключателя Confirm без значения вводит паузу, которая заставляет вас подтвердить команду перед продолжением.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-Identity

Параметр Identity определяет правило безопасных ссылок, которое требуется изменить.

Путь: (<TopLevelPublicFolderName><PublicFolderName>

  • имя;
  • различающееся имя (DN);
  • GUID
Type:RuleIdParameter
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-Priority

Параметр Priority указывает значение приоритета для правила, определяющего порядок обработки правил. Меньшее значение типа Integer указывает более высокий приоритет, значение 0 — самый высокий приоритет, а правила не могут иметь одинаковое значение приоритета.

Параметр Priority указывает значение приоритета для правила, которое определяет порядок обработки правил. Чем меньше целое значение, тем выше приоритет. Значение 0 соответствует самому высокому приоритету. Правила не должны иметь одинаковые значения приоритета.

  • Допустимые значения и значение, используемое по умолчанию, для этого параметра зависят от количества имеющихся правил. Например, у вас имеется 8 правил.
  • Допустимые значения приоритета для этих 8 правил — от 0 до 7.
  • Допустимые значения приоритета для нового (девятого) правила — от 0 до 8.

По умолчанию для нового (девятого) правила будет использовано значение 8.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-Имя

Параметр Name определяет уникальное имя правила безопасных ссылок. Если значение содержит пробелы, его необходимо заключить в кавычки (").

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

Входные данные

Выходные данные