Set-AppRetentionCompliancePolicy
Этот командлет доступен только в PowerShell безопасности и соответствия требованиям. Дополнительные сведения см. в статье PowerShell безопасности и соответствия требованиям.
Используйте Set-AppRetentionCompliancePolicy для изменения политик соответствия требованиям к хранению приложений.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Set-AppRetentionCompliancePolicy
[-Identity] <PolicyIdParameter>
[-AddExchangeLocation <MultiValuedProperty>]
[-AddExchangeLocationException <MultiValuedProperty>]
[-AddModernGroupLocation <MultiValuedProperty>]
[-AddModernGroupLocationException <MultiValuedProperty>]
[-Applications <String[]>]
[-Comment <String>]
[-Confirm]
[-DeletedResources <String>]
[-Enabled <Boolean>]
[-Force]
[-PolicyRBACScopes <MultiValuedProperty>]
[-RemoveExchangeLocation <MultiValuedProperty>]
[-RemoveExchangeLocationException <MultiValuedProperty>]
[-RemoveModernGroupLocation <MultiValuedProperty>]
[-RemoveModernGroupLocationException <MultiValuedProperty>]
[-RestrictiveRetention <Boolean>]
[-WhatIf]
[<CommonParameters>] Set-AppRetentionCompliancePolicy
[-Identity] <PolicyIdParameter>
[-AddAdaptiveScopeLocation <MultiValuedProperty>]
[-Applications <String[]>]
[-Comment <String>]
[-Confirm]
[-DeletedResources <String>]
[-Enabled <Boolean>]
[-Force]
[-RemoveAdaptiveScopeLocation <MultiValuedProperty>]
[-WhatIf]
[<CommonParameters>] Set-AppRetentionCompliancePolicy
[-Identity] <PolicyIdParameter>
[-Confirm]
[-DeletedResources <String>]
[-WhatIf]
[<CommonParameters>] Set-AppRetentionCompliancePolicy
[-Identity] <PolicyIdParameter>
[-Confirm]
[-DeletedResources <String>]
[-Force]
[-WhatIf]
[<CommonParameters>] Set-AppRetentionCompliancePolicy
[-Identity] <PolicyIdParameter>
[-Confirm]
[-DeletedResources <String>]
[-WhatIf]
[<CommonParameters>] Set-AppRetentionCompliancePolicy
[-Identity] <PolicyIdParameter>
[-Confirm]
[-RetryDistribution]
[-WhatIf]
[<CommonParameters>] Set-AppRetentionCompliancePolicy
[-Identity] <PolicyIdParameter>
[-Comment <String>]
[-Confirm]
[-DeletedResources <String>]
[-Enabled <Boolean>]
[-Force]
[-WhatIf]
[<CommonParameters>] Описание
Чтобы использовать этот командлет в PowerShell безопасности и соответствия требованиям, вам должны быть назначены соответствующие разрешения. Дополнительные сведения см. в статье Разрешения на портале соответствия требованиям Microsoft Purview.
Примеры
Пример 1
Set-AppRetentionCompliancePolicy -Identity "Regulation 563 Marketing" -Applications "User:MicrosoftTeams","Group:MicrosoftTeams,VivaEngage" -AddExchangeLocation "Scott Smith" -Comment "Added new counsel, 9/9/21"В этом примере добавляется новый пользователь в существующую статическую политику хранения область с именем Regulation 563 Marketing, настроенную для сообщений частных каналов Teams.
Параметры
-AddAdaptiveScopeLocation
Параметр AddAdaptiveScopeLocation указывает адаптивный область расположение для добавления в политику. Адаптивные области создаются с помощью командлета New-AdaptiveScope. Можно использовать любое значение, однозначно определяющее адаптивную область. Например:
- имя;
- различающееся имя (DN);
- GUID
Update Если значения содержат пробелы или по каким-либо другим причинам требуют применения кавычек, используйте следующий синтаксис: "Value1","Value2",..."ValueN".
| Тип: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
| Применяется к: | Security & Compliance |
-AddExchangeLocation
Параметр AddExchangeLocation указывает почтовые ящики, добавляемые в список включенных почтовых ящиков, если для параметра ExchangeLocation не используется значение All. Допустимые значения:
- Параметр ExchangeLocation указывает почтовые ящики, включаемые в политику. Допускаются следующие значения:
- Почтовый ящик
Значение All для всех почтовых ящиков. Это значение можно использовать только само по себе.
- имя;
- Имя
- Различающееся имя (DN)
- GUID
Update Если значения содержат пробелы или по каким-либо другим причинам требуют применения кавычек, используйте следующий синтаксис: "Value1","Value2",..."ValueN".
| Тип: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
| Применяется к: | Security & Compliance |
-AddExchangeLocationException
Параметр AddExchangeLocationException указывает почтовые ящики, добавляемые в список исключенных почтовых ящиков при использовании значения Все для параметра ExchangeLocation. Допустимые значения:
- Этот параметр указывает почтовые ящики, удаляемые из списка исключенных почтовых ящиков, когда для параметра ExchangeLocation используется значение All. Допускаются следующие значения:
- Почтовый ящик
Значение All для всех почтовых ящиков. Это значение можно использовать только само по себе.
- имя;
- Имя
- Различающееся имя (DN)
- GUID
Update Если значения содержат пробелы или по каким-либо другим причинам требуют применения кавычек, используйте следующий синтаксис: "Value1","Value2",..."ValueN".
| Тип: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
| Применяется к: | Security & Compliance |
-AddModernGroupLocation
Параметр AddModernGroupLocation указывает Группы Microsoft 365 для добавления в список включенных Группы Microsoft 365, если для параметра ModernGroupLocation не используется значение All.
Можно использовать любое значение, уникально определяющее группу Microsoft 365. Например:
- имя;
- Имя
- Различающееся имя (DN)
- GUID
Update Если значения содержат пробелы или по каким-либо другим причинам требуют применения кавычек, используйте следующий синтаксис: "Value1","Value2",..."ValueN".
| Тип: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
| Применяется к: | Security & Compliance |
-AddModernGroupLocationException
Параметр AddModernGroupLocationException указывает Группы Microsoft 365 для добавления в список исключенных Группы Microsoft 365 при использовании значения All для параметра ModernGroupLocation.
Можно использовать любое значение, уникально определяющее группу Microsoft 365. Например:
- имя;
- Имя
- Различающееся имя (DN)
- GUID
Update Если значения содержат пробелы или по каким-либо другим причинам требуют применения кавычек, используйте следующий синтаксис: "Value1","Value2",..."ValueN".
| Тип: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
| Применяется к: | 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:VivaEngage".
| Тип: | String[] |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
| Применяется к: | Security & Compliance |
-Comment
Параметр Comment указывает необязательный комментарий. Если вы указываете значение, содержащее пробелы, заключите его в кавычки ("), например:" Это примечание администратора ".
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
| Применяется к: | Security & Compliance |
-Confirm
Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. Влияние этого параметра на командлет зависит от того, требуется ли командлету подтверждение перед выполнением.
- Деструктивные командлеты (например, командлеты Remove-) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис:
-Confirm:$false. - Большинство других командлетов (например, командлеты New- и Set-) не имеют встроенной паузы. Для этих командлетов указание переключателя Confirm без значения вводит паузу, которая заставляет вас подтвердить команду перед продолжением.
| Тип: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
| Применяется к: | Security & Compliance |
-DeletedResources
{{ Fill DeletedResources Description }}
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
| Применяется к: | Security & Compliance |
-Enabled
Параметр Enabled включает или отключает политику. Допустимые значения:
- $true. Политика включена. Это значение используется по умолчанию.
- $true. Политика включена. Это значение задается по умолчанию.
| Тип: | Boolean |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
| Применяется к: | Security & Compliance |
-Force
Переключатель "Принудительно" скрывает сообщения с предупреждениями или подтверждениями. Указывать значение для этого параметра необязательно.
Этот параметр можно применять для программного выполнения задач, не требующего вмешательства администратора.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
| Применяется к: | Security & Compliance |
-Identity
Параметр Identity указывает политику соответствия требованиям к хранению приложений, которую требуется изменить. Вы можете использовать любое уникальное значение, определяющее политику. Например:
- имя;
- различающееся имя (DN);
- GUID
| Тип: | PolicyIdParameter |
| Position: | 0 |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
| Применяется к: | Security & Compliance |
-PolicyRBACScopes
Параметр PolicyRBACScopes указывает административные единицы, назначаемого политике. Допустимым значением является Microsoft Entra ObjectID (значение GUID) административной единицы. Вы можете указать несколько значений, разделив их запятыми.
Административные единицы доступны только в Microsoft Entra ID P1 или P2. Вы создаете административные единицы и управляете ими в Microsoft Graph PowerShell.
| Тип: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
| Применяется к: | Security & Compliance |
-RemoveAdaptiveScopeLocation
Параметр RemoveAdaptiveScopeLocation указывает адаптивное расположение область, которое необходимо удалить из политики. Адаптивные области создаются с помощью командлета New-AdaptiveScope. Можно использовать любое значение, однозначно определяющее адаптивную область. Например:
- имя;
- различающееся имя (DN);
- GUID
Update Если значения содержат пробелы или по каким-либо другим причинам требуют применения кавычек, используйте следующий синтаксис: "Value1","Value2",..."ValueN".
| Тип: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
| Применяется к: | Security & Compliance |
-RemoveExchangeLocation
Параметр RemoveExchangeLocation указывает почтовые ящики, которые нужно удалить из списка включенных почтовых ящиков, если для параметра ExchangeLocation не используется значение All. Допустимые значения:
- Этот параметр указывает почтовые ящики, удаляемые из списка исключенных почтовых ящиков, когда для параметра ExchangeLocation используется значение All. Допускаются следующие значения:
- Почтовый ящик
Значение All для всех почтовых ящиков. Это значение можно использовать только само по себе.
- имя;
- Имя
- Различающееся имя (DN)
- GUID
Update Если значения содержат пробелы или по каким-либо другим причинам требуют применения кавычек, используйте следующий синтаксис: "Value1","Value2",..."ValueN".
| Тип: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
| Применяется к: | Security & Compliance |
-RemoveExchangeLocationException
Параметр RemoveExchangeLocationException указывает почтовые ящики, которые необходимо удалить из списка исключенных почтовых ящиков при использовании значения All для параметра ExchangeLocation. Допустимые значения:
- Этот параметр указывает почтовые ящики, удаляемые из списка исключенных почтовых ящиков, когда для параметра ExchangeLocation используется значение All. Допускаются следующие значения:
- Почтовый ящик
Значение All для всех почтовых ящиков. Это значение можно использовать только само по себе.
- имя;
- Имя
- Различающееся имя (DN)
- GUID
Update Если значения содержат пробелы или по каким-либо другим причинам требуют применения кавычек, используйте следующий синтаксис: "Value1","Value2",..."ValueN".
| Тип: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
| Применяется к: | Security & Compliance |
-RemoveModernGroupLocation
Параметр RemoveModernGroupLocation указывает Группы Microsoft 365, удаляемый из списка включенных групп, если для параметра ModernGroupLocation не используется значение All.
Можно использовать любое значение, уникально определяющее группу Microsoft 365. Например:
- имя;
- Имя
- Различающееся имя (DN)
- GUID
Update Если значения содержат пробелы или по каким-либо другим причинам требуют применения кавычек, используйте следующий синтаксис: "Value1","Value2",..."ValueN".
| Тип: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
| Применяется к: | Security & Compliance |
-RemoveModernGroupLocationException
Параметр RemoveModernGroupLocationException указывает Группы Microsoft 365, удаляемый из списка исключенных групп при использовании значения All для параметра ModernGroupLocation.
Можно использовать любое значение, уникально определяющее группу Microsoft 365. Например:
- имя;
- Имя
- Различающееся имя (DN)
- GUID
Update Если значения содержат пробелы или по каким-либо другим причинам требуют применения кавычек, используйте следующий синтаксис: "Value1","Value2",..."ValueN".
| Тип: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
| Применяется к: | Security & Compliance |
-RestrictiveRetention
Параметр RestrictiveRetention указывает, включена ли блокировка сохранения для политики. Допустимые значения:
- $true: для политики включена блокировка сохранения. Никто, включая администратора, не может отключить политику или сделать ее менее строгой.
- $false. Блокировка сохранения не включена для политики. Это значение используется по умолчанию.
После блокировки политики никто не сможет отключить или отключить ее, а также удалить приложения из нее. Изменить политику можно только путем добавления в нее приложений или продления ее длительности. Заблокированную политику можно увеличить или расширить, но ее нельзя уменьшить, отключить или отключить.
Поэтому перед блокировкой политики важно понимать требования организации к соответствию и не блокировать политику, пока не убедитесь, что она вам нужна.
| Тип: | Boolean |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
| Применяется к: | Security & Compliance |
-RetryDistribution
Параметр RetryDistribution указывает, следует ли распространять политику во все расположения. С этим параметром не нужно указывать значение.
Расположения, для которых первоначальная рассылка прошла успешно, исключаются при повторении. При использовании этого параметра сообщается об ошибках рассылки политики.
Примечание. Так как процесс повторного распределения является важной операцией, запускайте его только при необходимости и для одной политики за раз. Он не предназначен для запуска при каждом обновлении политики. При запуске скрипта для обновления нескольких политик дождитесь успешного распространения политики, прежде чем снова запустить команду для следующей политики.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
| Применяется к: | Security & Compliance |
-WhatIf
Параметр WhatIf не поддерживается в PowerShell безопасности и соответствия требованиям.
| Тип: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
| Применяется к: | Security & Compliance |