New-CaseHoldPolicy
Этот командлет доступен только в PowerShell для соответствия требованиям безопасности & . Дополнительные сведения см. в разделе Соответствие требованиям безопасности & PowerShell.
Используйте командлет New-CaseHoldPolicy для создания новых политик удержания регистра в Портал соответствия требованиям Microsoft Purview.
Когда вы создадите политику удержания дел с помощью командлета New-CaseHoldPolicy, воспользуйтесь командлетом New-CaseHoldRule, чтобы создать правило удержания дел и назначить ей это правило. Если вы не создадите правило для политики, запрос на удержание не будет создан, а к содержимому в определенных расположениях не будет применяться удержание.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
New-CaseHoldPolicy
[-Name] <String>
-Case <String>
[-Comment <String>]
[-Confirm]
[-Enabled <Boolean>]
[-ExchangeLocation <MultiValuedProperty>]
[-Force]
[-PublicFolderLocation <MultiValuedProperty>]
[-SharePointLocation <MultiValuedProperty>]
[-WhatIf]
[<CommonParameters>] Описание
Чтобы использовать этот командлет в PowerShell для соответствия требованиям безопасности & , необходимо назначить разрешения. Дополнительные сведения см. в статье Разрешения на портале соответствия требованиям Microsoft Purview.
Примеры
Пример 1
New-CaseHoldPolicy -Name "Regulation 123 Compliance" -Case "123 Compliance Case" -ExchangeLocation "Kitty Petersen", "Scott Nakamura" -SharePointLocation "https://contoso.sharepoint.com/sites/teams/finance"В этом примере создается политика удержания дела с именем "Соответствие нормативным требованиям 123" для почтовых ящиков Китти Петерсен и Скотта Накамура, а также финансовый сайт SharePoint Online для дела обнаружения электронных данных с именем "123 Compliance Case".
Помните, что после создания политики нужно создать правило для этой политики с помощью командлета New-CaseHoldRule.
Параметры
-Case
Параметр Case указывает дело обнаружения электронных данных, которое необходимо связать с политикой удержания дел. Для определения дела обнаружения электронных данных можно использовать такие значения:
- Имя
- идентификатор (значение GUID).
Чтобы найти эти значения, выполните команду Get-ComplianceCase | Format-Table -Auto Name,Status,Identity.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| 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 |
-ExchangeLocation
Параметр ExchangeLocation указывает почтовые ящики для включения в политику. Допустимые значения:
- Параметр ExchangeLocation указывает почтовые ящики, включаемые в политику. Допускаются следующие значения:
- Почтовый ящик
Чтобы указать почтовый ящик или группу рассылки, можно использовать следующие значения:
- Имя
- SMTP-адрес. Чтобы указать неактивный почтовый ящик, перед адресом укажите точку (.).
- Azure AD ObjectId. Используйте командлеты Get-MgUser или Get-MgGroup в Microsoft Graph PowerShell, чтобы найти это значение.
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 |
-Force
Переключатель "Принудительно" скрывает сообщения с предупреждениями или подтверждениями. Указывать значение для этого параметра необязательно.
Этот параметр можно применять для программного выполнения задач, не требующего вмешательства администратора.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-Name
Параметр Name определяет уникальное имя политики удержания дел. Если значение содержит пробелы, его необходимо заключить в кавычки.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-PublicFolderLocation
Параметр PublicFolderLocation указывает, что в политику удержания дел нужно включить все общедоступные папки. Для этого параметра используется значение All.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-SharePointLocation
Параметр SharePointLocation указывает сайты SharePoint Online и OneDrive для бизнеса для включения. Вы идентифицируете сайт по его значению URL-адреса.
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 |
-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 |