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