New-AppRetentionCompliancePolicy
Этот командлет доступен только в PowerShell для соответствия требованиям безопасности & . Дополнительные сведения см. в разделе Соответствие требованиям безопасности & PowerShell.
Используйте New-AppRetentionCompliancePolicy для создания политик соответствия требованиям к хранению приложений. Политики меток хранения & приложений предназначены для новых способов применения политик и управления ими.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
New-AppRetentionCompliancePolicy
[-Name] <String>
-AdaptiveScopeLocation <MultiValuedProperty>
-Applications <String[]>
[-Confirm]
[-Comment <String>]
[-Enabled <Boolean>]
[-Force]
[-RestrictiveRetention <Boolean>]
[-WhatIf]
[<CommonParameters>] New-AppRetentionCompliancePolicy
[-Name] <String>
-Applications <String[]>
[-Comment <String>]
[-Confirm]
[-Enabled <Boolean>]
[-ExchangeLocation <MultiValuedProperty>]
[-ExchangeLocationException <MultiValuedProperty>]
[-Force]
[-ModernGroupLocation <MultiValuedProperty>]
[-ModernGroupLocationException <MultiValuedProperty>]
[-PolicyRBACScopes <MultiValuedProperty>]
[-RestrictiveRetention <Boolean>]
[-WhatIf]
[<CommonParameters>] Описание
Командлеты *-AppRetentionCompliance* используются для политик с адаптивными областями политики и всех статических политик, охватывающих частные каналы Teams, чаты Yammer и сообщения сообщества Yammer. В конечном итоге вы будете использовать эти командлеты для большинства расположений хранения и типов политик. Командлеты *-RetentionCompliance* будут по-прежнему поддерживать главным образом расположения Exchange и SharePoint. Для политик, созданных с помощью командлетов *-AppRetentionCompliance*, можно задать только список включенных или исключенных областей для всех включенных рабочих нагрузок. Это означает, что вам, скорее всего, потребуется создать одну политику для каждой рабочей нагрузки.
Чтобы использовать этот командлет в PowerShell для соответствия требованиям безопасности & , необходимо назначить разрешения. Дополнительные сведения см. в статье Разрешения на портале соответствия требованиям Microsoft Purview.
Примеры
Пример 1
New-AppRetentionCompliancePolicy -Name "Regulation 567 Compliance" -Applications "User:MicrosoftTeams,Yammer","Group:MicrosoftTeams,Yammer" -ExchangeLocation "Jennifer Petersen","Kitty Nakamura"В этом примере создается политика хранения статической области с именем Compliance 567 для сообщений пользователей Yammer Дженнифер Петерсен и Китти Накамура.
После создания политики хранения используйте командлет New-AppRetentionComplianceRule, чтобы создать правило хранения и назначить ему политику хранения.
Параметры
-AdaptiveScopeLocation
Параметр AdaptiveScopeLocation указывает расположение адаптивной области для включения в политику. Адаптивные области создаются с помощью командлета New-AdaptiveScope. Можно использовать любое значение, однозначно определяющее адаптивную область. Например:
- имя;
- различающееся имя (DN);
- GUID
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-Applications
Параметр Applications указывает приложения для включения в политику и относится только к следующим параметрам расположения:
- ExchangeLocation
- ModernGroupLocation
- AdaptiveScopeLocation
Этот параметр использует следующий синтаксис: "LocationtType:App1,LocationType:App2,...LocationType:AppN где LocationType имеет значение User или Group. Например, "User:Exchange,User:OneDriveForBusiness,Group:Exchange,Group:SharePoint" или "User:MicrosoftTeams","User:Yammer".
| 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 указывает почтовые ящики, включаемые в политику. Допускаются следующие значения:
- Почтовый ящик
- Значение All для всех почтовых ящиков. Это значение можно использовать только отдельно.
Значение 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 |
-ExchangeLocationException
Параметр ExchangeLocationException указывает, что почтовые ящики исключаются из политики при использовании значения All для параметра ExchangeLocation. Допустимые значения:
- Этот параметр указывает почтовые ящики, удаляемые из списка исключенных почтовых ящиков, когда для параметра ExchangeLocation используется значение All. Допускаются следующие значения:
- Почтовый ящик
Значение 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 |
-Force
Переключатель "Принудительно" скрывает сообщения с предупреждениями или подтверждениями. Указывать значение для этого параметра необязательно.
Этот параметр можно применять для программного выполнения задач, не требующего вмешательства администратора.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-ModernGroupLocation
Параметр ModernGroupLocation указывает Группы Microsoft 365 для включения в политику. Допустимые значения:
- Группа Microsoft 365
- Значение All для всех Группы Microsoft 365. Это значение можно использовать только отдельно.
Чтобы определить группу Microsoft 365, можно использовать любое уникальное значение, которое ее определяет. Например:
- имя;
- Имя
- Различающееся имя (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 |
-ModernGroupLocationException
Параметр ModernGroupLocationException указывает Группы Microsoft 365, который следует исключить из политики при использовании значения All для параметра ModernGroupLocation.
Можно использовать любое значение, уникально определяющее группу Microsoft 365. Например:
- имя;
- Имя
- Различающееся имя (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 |
-Name
Параметр Name задает уникальное имя для политики соответствия требованиям к хранению приложений. Максимальная длина: 64 символа. Если значение содержит пробелы, его необходимо заключить в кавычки (").
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-PolicyRBACScopes
{{ Заполнение PolicyRBACScopes Description }}
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-RestrictiveRetention
Параметр RestrictiveRetention указывает, включена ли блокировка сохранения для политики. Допустимые значения:
- $true: для политики включена блокировка сохранения. Никто, включая администратора, не может отключить политику или сделать ее менее строгой.
- $false. Блокировка сохранения не включена для политики. Это значение используется по умолчанию.
После блокировки политики никто не сможет отключить или отключить ее, а также удалить приложения из политики. Изменить политику можно только путем добавления в нее приложений или продления ее длительности. Заблокированную политику можно увеличить или расширить, но ее нельзя уменьшить, отключить или отключить.
Поэтому перед блокировкой политики важно понимать требования организации к соответствию и не блокировать политику, пока не убедитесь, что она необходима.
| Type: | Boolean |
| 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 |