Set-HoldCompliancePolicy

Ссылка

Модуль:: ExchangePowerShell

Применяется к:: Security & Compliance

Этот командлет доступен только в PowerShell для соответствия требованиям безопасности & . Дополнительные сведения см. в разделе Соответствие требованиям безопасности & PowerShell.

Используйте командлет Set-HoldCompliancePolicy для изменения существующих политик сохранения в Портал соответствия требованиям Microsoft Purview.

Примечание. Командлет Set-HoldCompliancePolicy заменен командлетом Set-RetentionCompliancePolicy. Если у вас есть скрипты, использующие Set-HoldCompliancePolicy, обновите их, чтобы использовать Set-RetentionCompliancePolicy.

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

Синтаксис

Set-HoldCompliancePolicy
   [-Identity] <PolicyIdParameter>
   [-RetryDistribution]
   [-Confirm]
   [-WhatIf]
   [<CommonParameters>]

Set-HoldCompliancePolicy
   [-Identity] <PolicyIdParameter>
   [-AddExchangeLocation <MultiValuedProperty>]
   [-AddPublicFolderLocation <MultiValuedProperty>]
   [-AddSharePointLocation <MultiValuedProperty>]
   [-Comment <String>]
   [-Confirm]
   [-Enabled <Boolean>]
   [-Force]
   [-RemoveExchangeLocation <MultiValuedProperty>]
   [-RemovePublicFolderLocation <MultiValuedProperty>]
   [-RemoveSharePointLocation <MultiValuedProperty>]
   [-WhatIf]
   [<CommonParameters>]

Описание

Чтобы использовать этот командлет в PowerShell для соответствия требованиям безопасности & , необходимо назначить разрешения. Дополнительные сведения см. в статье Разрешения на портале соответствия требованиям Microsoft Purview.

Примечание. Не используйте команду Foreach-Object по каналу при добавлении или удалении расположений области: "Value1","Value2",..."ValueN" | Foreach-Object {Set-HoldCompliancePolicy -Identity "Regulation 123 Compliance" -RemoveExchangeLocation $_}.

Примеры

Пример 1

Set-HoldCompliancePolicy -Identity "Regulation 123 Compliance" -AddExchangeLocation "Kitty Petersen" -AddSharePointLocation "https://contoso.sharepoint.com/sites/teams/finance" -RemovePublicFolderLocation All -Comment "Added new counsel, 9/9/14"

В этом примере в существующую политику хранения, Regulation 123 Compliance, вносятся следующие изменения:

Добавляется почтовый ящик для пользователя Kitty Petersen.
Добавляет сайт https://contoso.sharepoint.com/sites/teams/financeSharePoint Online .
Удаляются общедоступные папки.
Обновляется комментарий.

Параметры

-AddExchangeLocation

Параметр AddExchangeLocation указывает почтовые ящики, добавляемые в список включенных почтовых ящиков. Допустимые значения:

Параметр ExchangeLocation указывает почтовые ящики, включаемые в политику. Допускаются следующие значения:
Почтовый ящик

Значение All для всех почтовых ящиков. Это значение можно использовать только само по себе.

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

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

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-AddPublicFolderLocation

Параметр AddPublicFolderLocation указывает, требуется ли добавить все общедоступные папки в политику хранения. Для этого параметра используется значение All.

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-AddSharePointLocation

Параметр AddSharePointLocation указывает сайты SharePoint Online, добавляемые в список включенных сайтов, если для параметра SharePointLocation не используется значение All. Чтобы добавить сайт, укажите его URL-адрес.

Сайты SharePoint Online нельзя добавить в политику, пока они не будут проиндексированы.

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-Comment

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-Confirm

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

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-Enabled

Параметр Enabled указывает, включена ли политика. Допустимые значения:

$true. Политика включена. Это значение используется по умолчанию.
$true. Политика включена. Это значение задается по умолчанию.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-Force

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

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-Identity

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

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

Type:	PolicyIdParameter
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Security & Compliance

-RemoveExchangeLocation

Параметр RemoveExchangeLocation указывает существующие почтовые ящики, которые нужно удалить из политики. Допустимые значения:

Этот параметр указывает почтовые ящики, удаляемые из списка исключенных почтовых ящиков, когда для параметра ExchangeLocation используется значение All. Допускаются следующие значения:
Почтовый ящик

Значение All для всех почтовых ящиков. Это значение можно использовать только само по себе.

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

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-RemovePublicFolderLocation

Параметр RemovePublicFolderLocation указывает, требуется ли удалить все общедоступные папки из политики хранения. Для этого параметра используется значение All.

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-RemoveSharePointLocation

Параметр RemoveSharePointLocation указывает сайты SharePoint Online, которые нужно удалить из списка включенных сайтов, если для параметра SharePointLocation не используется значение All. Чтобы добавить сайт, укажите его URL-адрес.

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-RetryDistribution

Параметр RetryDistribution указывает, следует ли распространять политику во все расположения Exchange Online и SharePoint Online. Указывать значение для этого параметра необязательно.

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

Примечание. Так как процесс повторного распределения является важной операцией, запускайте ее только при необходимости и для одной политики за раз. Он не предназначен для запуска при каждом обновлении политики. При запуске скрипта для обновления нескольких политик дождитесь успешного распространения политики, прежде чем снова запустить команду для следующей политики.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-WhatIf

Параметр WhatIf не работает в PowerShell для соответствия требованиям безопасности & .

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

Поделиться через