Set-RetentionCompliancePolicy

Модуль:
Exchange PowerShell

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

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

Примечание. Запуск этого командлета вызывает полную синхронизацию во всей организации, что является важной операцией. Если вам нужно обновить несколько политик, дождитесь успешного распространения политик, прежде чем снова запускать командлет для следующей политики. Сведения о состоянии распространения см. в разделе Get-RetentionCompliancePolicy.

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

Синтаксис

Identity 

Set-RetentionCompliancePolicy
    [-Identity] <PolicyIdParameter>
    [-AddExchangeLocation <MultiValuedProperty>]
    [-AddExchangeLocationException <MultiValuedProperty>]
    [-AddModernGroupLocation <MultiValuedProperty>]
    [-AddModernGroupLocationException <MultiValuedProperty>]
    [-AddOneDriveLocation <MultiValuedProperty>]
    [-AddOneDriveLocationException <MultiValuedProperty>]
    [-AddPublicFolderLocation <MultiValuedProperty>]
    [-AddSharePointLocation <MultiValuedProperty>]
    [-AddSharePointLocationException <MultiValuedProperty>]
    [-AddSkypeLocation <MultiValuedProperty>]
    [-AddSkypeLocationException <MultiValuedProperty>]
    [-Applications <MultiValuedProperty>]
    [-Comment <String>]
    [-Confirm]
    [-DeletedResources <String>]
    [-Enabled <Boolean>]
    [-EnforceSimulationPolicy <Boolean>]
    [-Force]
    [-PolicyTemplateInfo <PswsHashtable>]
    [-PolicyRBACScopes <MultiValuedProperty>]
    [-PriorityCleanup]
    [-RemoveExchangeLocation <MultiValuedProperty>]
    [-RemoveExchangeLocationException <MultiValuedProperty>]
    [-RemoveModernGroupLocation <MultiValuedProperty>]
    [-RemoveModernGroupLocationException <MultiValuedProperty>]
    [-RemoveOneDriveLocation <MultiValuedProperty>]
    [-RemoveOneDriveLocationException <MultiValuedProperty>]
    [-RemovePublicFolderLocation <MultiValuedProperty>]
    [-RemoveSharePointLocation <MultiValuedProperty>]
    [-RemoveSharePointLocationException <MultiValuedProperty>]
    [-RemoveSkypeLocation <MultiValuedProperty>]
    [-RemoveSkypeLocationException <MultiValuedProperty>]
    [-RestrictiveRetention <Boolean>]
    [-StartSimulation <Boolean>]
    [-WhatIf]
    [<CommonParameters>]

AdaptiveScopeLocation 

Set-RetentionCompliancePolicy
    [-Identity] <PolicyIdParameter>
    [-AddAdaptiveScopeLocation <MultiValuedProperty>]
    [-Applications <MultiValuedProperty>]
    [-Comment <String>]
    [-Confirm]
    [-DeletedResources <String>]
    [-Enabled <Boolean>]
    [-EnforceSimulationPolicy <Boolean>]
    [-Force]
    [-PriorityCleanup]
    [-RemoveAdaptiveScopeLocation <MultiValuedProperty>]
    [-StartSimulation <Boolean>]
    [-WhatIf]
    [<CommonParameters>]

RetryDistribution 

Set-RetentionCompliancePolicy
    [-Identity] <PolicyIdParameter>
    [-RetryDistribution]
    [-Confirm]
    [-DeletedResources <String>]
    [-EnforceSimulationPolicy <Boolean>]
    [-PriorityCleanup]
    [-StartSimulation <Boolean>]
    [-WhatIf]
    [<CommonParameters>]

TeamLocation 

Set-RetentionCompliancePolicy
    [-Identity] <PolicyIdParameter>
    [-AddTeamsChannelLocation <MultiValuedProperty>]
    [-AddTeamsChannelLocationException <MultiValuedProperty>]
    [-AddTeamsChatLocation <MultiValuedProperty>]
    [-AddTeamsChatLocationException <MultiValuedProperty>]
    [-Comment <String>]
    [-Confirm]
    [-DeletedResources <String>]
    [-Enabled <Boolean>]
    [-EnforceSimulationPolicy <Boolean>]
    [-Force]
    [-PriorityCleanup]
    [-RemoveTeamsChannelLocation <MultiValuedProperty>]
    [-RemoveTeamsChannelLocationException <MultiValuedProperty>]
    [-RemoveTeamsChatLocation <MultiValuedProperty>]
    [-RemoveTeamsChatLocationException <MultiValuedProperty>]
    [-StartSimulation <Boolean>]
    [-WhatIf]
    [<CommonParameters>]

Описание

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

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

Примеры

Пример 1

Set-RetentionCompliancePolicy -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 .
  • Удаляются общедоступные папки.
  • Обновляется комментарий.

Пример 2

$stringJson = @"
[{
     'EmailAddress': 'USSales@contoso.onmicrosoft.com',
     'SiteId': '9b2a8116-b9ec-4e2c-bf31-7eaa83697c4b'
}]
"@

Set-RetentionCompliancePolicy -Identity "Sales Policy" -RemoveModernGroupLocation "USSales@contoso.onmicrosoft.com" -DeletedResources $stringJson

В этом примере указанная удаленная группа и сайт Microsoft 365 удаляются из указанной политики. Вы идентифицируете удаленные ресурсы с помощью адреса электронной почты группы Microsoft 365 и идентификатора соответствующего сайта.

ВАЖНО! Перед выполнением этой команды обязательно прочитайте информацию в разделе Предупреждение для параметра DeletedResources о дублирующихся SMTP-адресах.

Пример 3

$stringJson = @"
[{
     'EmailAddress': 'USSales@contoso.onmicrosoft.com',
     'SiteId': '8b2a8345-b9ec-3b6a-bf31-6eaa83697c4b'
}]
"@

Set-RetentionCompliancePolicy -Identity "Tenant Level Policy" -AddModernGroupLocationException "USSales@contoso.onmicrosoft.com" -DeletedResources $stringJson

В примере из указанной политики на уровне клиента исключены указанные удаленные группы и сайты Microsoft 365. Вы идентифицируете удаленные ресурсы с помощью адреса электронной почты группы Microsoft 365 и идентификатора соответствующего сайта.

ВАЖНО! Перед выполнением этой команды обязательно прочитайте информацию в разделе Предупреждение для параметра DeletedResources о дублирующихся SMTP-адресах.

Пример 4

$stringJson = @"
[{
     'EmailAddress': 'USSales2@contoso.onmicrosoft.com',
     'SiteId': '9b2a8116-b9ec-4e2c-bf31-7eaa83697c4b'
 },
{
     'EmailAddress': 'USSales2@contoso.onmicrosoft.com',
     'SiteId': '4afb7116-b9ec-4b2c-bf31-4abb83697c4b'
}]
"@

Set-RetentionCompliancePolicy -Identity "Sales Policy" -RemoveModernGroupLocation "USSales2@contoso.onmicrosoft.com" -DeletedResources $stringJson

Этот пример похож на пример 2, за исключением того, что указано несколько удаленных ресурсов.

ВАЖНО! Перед выполнением этой команды обязательно прочитайте информацию в разделе Предупреждение для параметра DeletedResources о дублирующихся SMTP-адресах.

Пример 5

$stringJson = @"
[{
     'EmailAddress': 'SalesUser@contoso.onmicrosoft.com'
}]
"@

Set-RetentionCompliancePolicy -Identity "Teams Chat Retention Policy" -AddTeamsChatLocationException "SalesUser@contoso.onmicrosoft.com" -DeletedResources $stringJson

В этом примере указанный программно удаленный почтовый ящик или почтовый пользователь исключается из упомянутой политики хранения Teams. Вы можете идентифицировать удаленные ресурсы по почтовому ящику или адресу электронной почты почтового пользователя.

ВАЖНО! Перед выполнением этой команды обязательно прочитайте информацию в разделе Предупреждение для параметра DeletedResources о дублирующихся SMTP-адресах.

Пример 6

$stringJson = @"
[{
     'EmailAddress': 'SalesUser1@contoso.onmicrosoft.com'
},
{
     'EmailAddress': 'SalesUser2@contoso.onmicrosoft.com'
}]
"@

Set-RetentionCompliancePolicy -Identity "Teams Chat Retention Policy" -AddTeamsChatLocationException "SalesUser1@contoso.onmicrosoft.com", "SalesUser2@contoso.onmicrosoft.com" -DeletedResources $stringJson

Этот пример похож на пример 5, за исключением того, что указано несколько удаленных ресурсов.

ВАЖНО! Перед выполнением этой команды обязательно прочитайте информацию в разделе Предупреждение для параметра DeletedResources о дублирующихся SMTP-адресах.

Исключения политик должны оставаться в пределах поддерживаемых ограничений для политик хранения: Ограничения для политик хранения Microsoft 365 и политик меток хранения

Параметры

-AddAdaptiveScopeLocation

Применимо: безопасность & соответствие требованиям

Параметр AddAdaptiveScopeLocation указывает адаптивное расположение области для добавления в политику. Адаптивные области можно создать с помощью командлета New-AdaptiveScope. Можно использовать любое значение, однозначно определяющее адаптивную область. Например:

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

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

Свойства параметров

Тип:MultiValuedProperty
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

AdaptiveScopeLocation
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-AddExchangeLocation

Применимо: безопасность & соответствие требованиям

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

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

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

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

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

Свойства параметров

Тип:MultiValuedProperty
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Identity
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-AddExchangeLocationException

Применимо: безопасность & соответствие требованиям

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

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

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

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

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

Свойства параметров

Тип:MultiValuedProperty
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Identity
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-AddModernGroupLocation

Применимо: безопасность & соответствие требованиям

Параметр AddModernGroupLocation указывает, какие группы Группы Microsoft 365 следует добавить в список включенных групп Microsoft 365, если для параметра ModernGroupLocation не используется значение All (Все).

Вы можете использовать любое значение, которое уникально идентифицирует группу Microsoft 365. Например:

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

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

Свойства параметров

Тип:MultiValuedProperty
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Identity
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-AddModernGroupLocationException

Применимо: безопасность & соответствие требованиям

Параметр AddModernGroupLocationException указывает, какие группы Группы Microsoft 365 следует добавить в список исключенных Групп Microsoft 365, если для параметра ModernGroupLocation используется значение All (Все).

Вы можете использовать любое значение, которое уникально идентифицирует группу Microsoft 365. Например:

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

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

Свойства параметров

Тип:MultiValuedProperty
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Identity
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-AddOneDriveLocation

Применимо: безопасность & соответствие требованиям

Параметр AddOneDriveLocation указывает сайты OneDrive, которые следует добавить в список включенных сайтов, если для параметра OneDriveLocation не используется значение "Все". Чтобы добавить сайт, укажите его URL-адрес.

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

Свойства параметров

Тип:MultiValuedProperty
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Identity
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-AddOneDriveLocationException

Применимо: безопасность & соответствие требованиям

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

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

Свойства параметров

Тип:MultiValuedProperty
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Identity
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-AddPublicFolderLocation

Применимо: безопасность & соответствие требованиям

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

Свойства параметров

Тип:MultiValuedProperty
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Identity
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-AddSharePointLocation

Применимо: безопасность & соответствие требованиям

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

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

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

Свойства параметров

Тип:MultiValuedProperty
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Identity
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-AddSharePointLocationException

Применимо: безопасность & соответствие требованиям

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

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

Свойства параметров

Тип:MultiValuedProperty
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Identity
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-AddSkypeLocation

Применимо: безопасность & соответствие требованиям

Параметр AddSkypeLocation указывает, каких пользователей Skype для бизнеса Online следует добавить из списка включенных пользователей Skype для бизнеса Online.

Можно использовать любое уникальное значение, идентифицирующее пользователя. Пример:

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

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

Свойства параметров

Тип:MultiValuedProperty
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Identity
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-AddSkypeLocationException

Применимо: безопасность & соответствие требованиям

Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.

Свойства параметров

Тип:MultiValuedProperty
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Identity
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-AddTeamsChannelLocation

Применимо: безопасность & соответствие требованиям

Параметр AddTeamsChannelLocation указывает команды, которые нужно добавить в политику.

Можно использовать любое значение, которое однозначно идентифицирует команду. Например:

  • Имя
  • Адрес электронной почты
  • GUID

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

Свойства параметров

Тип:MultiValuedProperty
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

TeamLocation
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-AddTeamsChannelLocationException

Применимо: безопасность & соответствие требованиям

Параметр AddTeamsChannelLocationException указывает, какие команды нужно добавить в список исключений при использовании значения All для параметра TeamsChannelLocation. Можно использовать любое значение, которое однозначно идентифицирует команду. Например:

  • Имя
  • Адрес электронной почты
  • GUID

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

Свойства параметров

Тип:MultiValuedProperty
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

TeamLocation
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-AddTeamsChatLocation

Применимо: безопасность & соответствие требованиям

Параметр AddTeamsChatLocation указывает пользователей Teams, которых необходимо добавить в политику.

Можно использовать любое уникальное значение, идентифицирующее пользователя. Пример:

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

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

Свойства параметров

Тип:MultiValuedProperty
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

TeamLocation
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-AddTeamsChatLocationException

Применимо: безопасность & соответствие требованиям

Параметр AddTeamsChatLocationException указывает, каких пользователей Teams следует добавить в список исключений при использовании значения All для параметра TeamsChatLocation. Можно использовать любое уникальное значение, идентифицирующее пользователя. Пример:

  • Имя
  • Адрес электронной почты
  • GUID

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

Свойства параметров

Тип:MultiValuedProperty
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

TeamLocation
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Applications

Применимо: безопасность & соответствие требованиям

Параметр Applications указывает цель, когда Группы Microsoft 365 включены в политику (установлен параметр ModernGroups). Допустимые значения:

  • Group:Exchange для почтового ящика, подключенного к группе Microsoft 365.
  • Group:SharePoint для сайта SharePoint, подключенного к группе Microsoft 365.
  • "Group:Exchange,SharePoint" для почтового ящика и сайта SharePoint, подключенных к группе Microsoft 365.
  • blank ($null): значение по умолчанию и функционально эквивалентно значению "Group:Exchange,SharePoint". Для возврата к значению по умолчанию как для почтового ящика, так и для сайта SharePoint для выбранных групп Microsoft 365, укажите "Group:Exchange,SharePoint".

Свойства параметров

Тип:MultiValuedProperty
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Identity
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Comment

Применимо: безопасность & соответствие требованиям

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

Свойства параметров

Тип:String
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Identity
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
TeamLocation
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Confirm

Применимо: безопасность & соответствие требованиям

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

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

Свойства параметров

Тип:SwitchParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:cf

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-DeletedResources

Применимо: безопасность & соответствие требованиям

Параметр DeletedResources указывает удаленного пользователя группы, почтового ящика или почты Microsoft 365, который должен быть удален или добавлен в качестве исключения в соответствующий список расположений. Используйте этот параметр с параметрами AddModernGroupLocationException и RemoveModernGroupLocation для удаленных групп Microsoft 365 или с параметром AddTeamsChatLocationException для удаленных почтовых ящиков или почтовых пользователей.

Допустимое значение — строка JSON. Примеры синтаксиса и использования этого параметра см. в разделе Примеры.

ВНИМАНИЕ! При использовании SMTP-адреса с этим параметром имейте в виду, что этот же адрес может также использоваться для других почтовых ящиков или почтовых пользователей. Чтобы выполнить проверку наличия дополнительных почтовых ящиков или почтовых пользователей с таким же SMTP-адресом, выполните следующую команду и замените user@contoso.com его на SMTP-адрес для проверки:Get-Recipient -IncludeSoftDeletedRecipients user@contoso.com | Select-Object DisplayName, EmailAddresses, Description, Alias, RecipientTypeDetails, WhenSoftDeleted

Чтобы предотвратить исключение активных почтовых ящиков и почтовых пользователей с таким же SMTP-адресом, переведите их на удержание для судебных разбирательств , прежде чем выполнять команду с параметром DeletedResources.

Дополнительные сведения об удаленной группе Microsoft 365 см. в статье Дополнительные сведения об удалении современных групп в условиях удержания от хранения.

Дополнительные сведения о неактивных почтовых ящиках см. в разделе "Сведения о неактивных почтовых ящиках".

Свойства параметров

Тип:String
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Identity
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Enabled

Применимо: безопасность & соответствие требованиям

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

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

Свойства параметров

Тип:Boolean
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Identity
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
TeamLocation
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-EnforceSimulationPolicy

Применимо: безопасность & соответствие требованиям

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

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

Дополнительные сведения о режиме моделирования см. в разделе Сведения о режиме имитации.

Свойства параметров

Тип:Boolean
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Force

Применимо: безопасность & соответствие требованиям

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

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

Свойства параметров

Тип:SwitchParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Identity
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
TeamLocation
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Identity

Применимо: безопасность & соответствие требованиям

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

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

Свойства параметров

Тип:PolicyIdParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:1
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-PolicyRBACScopes

Применимо: безопасность & соответствие требованиям

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

Параметр PolicyRBACScopes указывает административные единицы, назначаемые политике. Допустимым значением является идентификатор объекта Microsoft Entra (значение GUID) административной единицы. Вы можете указать несколько значений, разделив их запятыми.

Административные единицы доступны только в Microsoft Entra ID P1 или P2. Административные единицы создаются и управляются в Microsoft Graph PowerShell.

Свойства параметров

Тип:MultiValuedProperty
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Identity
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-PolicyTemplateInfo

Применимо: безопасность & соответствие требованиям

Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.

Свойства параметров

Тип:PswsHashtable
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Identity
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-PriorityCleanup

Применимо: безопасность & соответствие требованиям

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

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

Свойства параметров

Тип:SwitchParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-RemoveAdaptiveScopeLocation

Применимо: безопасность & соответствие требованиям

Параметр RemoveAdaptiveScopeLocation указывает адаптивное расположение области, которое нужно удалить из политики. Адаптивные области можно создать с помощью командлета New-AdaptiveScope. Можно использовать любое значение, однозначно определяющее адаптивную область. Например:

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

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

Свойства параметров

Тип:MultiValuedProperty
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

AdaptiveScopeLocation
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-RemoveExchangeLocation

Применимо: безопасность & соответствие требованиям

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

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

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

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

Свойства параметров

Тип:MultiValuedProperty
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Identity
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-RemoveExchangeLocationException

Применимо: безопасность & соответствие требованиям

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

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

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

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

Свойства параметров

Тип:MultiValuedProperty
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Identity
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-RemoveModernGroupLocation

Применимо: безопасность & соответствие требованиям

Параметр RemoveModernGroupLocation указывает, какие группы Группы Microsoft 365 следует удалить из списка включенных групп, если вы не используете значение All для параметра ModernGroupLocation.

Вы можете использовать любое значение, которое уникально идентифицирует группу Microsoft 365. Например:

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

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

Свойства параметров

Тип:MultiValuedProperty
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Identity
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-RemoveModernGroupLocationException

Применимо: безопасность & соответствие требованиям

Параметр RemoveModernGroupLocationException указывает, какие группы Группы Microsoft 365 следует удалить из списка исключенных групп, если вы используете значение All для параметра ModernGroupLocation.

Вы можете использовать любое значение, которое уникально идентифицирует группу Microsoft 365. Например:

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

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

Свойства параметров

Тип:MultiValuedProperty
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Identity
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-RemoveOneDriveLocation

Применимо: безопасность & соответствие требованиям

Параметр RemoveOneDriveLocation указывает сайты OneDrive, которые нужно удалить из списка включенных сайтов, если для параметра OneDriveLocation не используется значение "Все". Чтобы добавить сайт, укажите его URL-адрес.

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

Свойства параметров

Тип:MultiValuedProperty
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Identity
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-RemoveOneDriveLocationException

Применимо: безопасность & соответствие требованиям

Этот параметр определяет сайты OneDrive, которые необходимо удалить из списка исключенных сайтов при использовании значения "Все" для параметра OneDriveLocation. Чтобы добавить сайт, укажите его URL-адрес.

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

Свойства параметров

Тип:MultiValuedProperty
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Identity
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-RemovePublicFolderLocation

Применимо: безопасность & соответствие требованиям

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

Свойства параметров

Тип:MultiValuedProperty
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Identity
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-RemoveSharePointLocation

Применимо: безопасность & соответствие требованиям

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

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

Свойства параметров

Тип:MultiValuedProperty
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Identity
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-RemoveSharePointLocationException

Применимо: безопасность & соответствие требованиям

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

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

Свойства параметров

Тип:MultiValuedProperty
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Identity
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-RemoveSkypeLocation

Применимо: безопасность & соответствие требованиям

Параметр RemoveSkypeLocation указывает, каких пользователей Skype для бизнеса Online нужно удалить из списка включенных пользователей Skype для бизнеса Online.

Можно использовать любое уникальное значение, идентифицирующее пользователя. Пример:

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

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

Свойства параметров

Тип:MultiValuedProperty
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Identity
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-RemoveSkypeLocationException

Применимо: безопасность & соответствие требованиям

Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.

Свойства параметров

Тип:MultiValuedProperty
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Identity
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-RemoveTeamsChannelLocation

Применимо: безопасность & соответствие требованиям

Параметр RemoveTeamsChannelLocation указывает команды, которые нужно удалить из политики.

Можно использовать любое значение, которое однозначно идентифицирует команду. Например:

  • Имя
  • Адрес электронной почты
  • GUID

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

Свойства параметров

Тип:MultiValuedProperty
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

TeamLocation
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-RemoveTeamsChannelLocationException

Применимо: безопасность & соответствие требованиям

Параметр RemoveTeamsChannelLocationException указывает, какие команды нужно удалить из списка исключений при использовании значения All для параметра TeamsChannelLocation. Можно использовать любое значение, которое однозначно идентифицирует команду. Например:

  • Имя
  • Адрес электронной почты
  • GUID

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

Свойства параметров

Тип:MultiValuedProperty
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

TeamLocation
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-RemoveTeamsChatLocation

Применимо: безопасность & соответствие требованиям

Параметр RemoveTeamsChatLocation указывает пользователей Teams, которых необходимо удалить из политики.

Можно использовать любое уникальное значение, идентифицирующее пользователя. Пример:

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

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

Свойства параметров

Тип:MultiValuedProperty
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

TeamLocation
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-RemoveTeamsChatLocationException

Применимо: безопасность & соответствие требованиям

Параметр RemoveTeamsChatLocationException указывает, каких пользователей Teams необходимо удалить из списка исключений при использовании значения All для параметра TeamsChatLocation. Можно использовать любое уникальное значение, идентифицирующее пользователя. Пример:

  • Имя
  • Адрес электронной почты
  • GUID

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

Свойства параметров

Тип:MultiValuedProperty
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

TeamLocation
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-RestrictiveRetention

Применимо: безопасность & соответствие требованиям

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

  • $true. Блокировка сохранения включена для политики. Никто (включая администратора) не может отключить эту политику или сделать ее менее строгой.
  • $false. Блокировка сохранения не включена для политики. Это значение используется по умолчанию.

После блокировки политики никто не может ее отключить, отключить ее или удалить содержимое из политики. Кроме того, в течение срока хранения невозможно изменить или удалить содержимое, на которое распространяется действие политики. Единственный способ изменить политику хранения — добавить в нее содержимое или продлить срок ее действия. Заблокированную политику можно увеличить или продлить, но ее нельзя уменьшить, отключить или отключить.

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

Свойства параметров

Тип:Boolean
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Identity
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-RetryDistribution

Применимо: безопасность & соответствие требованиям

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

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

Свойства параметров

Тип:SwitchParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

RetryDistribution
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-StartSimulation

Применимо: безопасность & соответствие требованиям

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

  • $true: Запуск симуляции.
  • $false. Не начинайте симуляцию. Это значение используется по умолчанию.

Дополнительные сведения о режиме моделирования см. в разделе Сведения о режиме имитации.

Свойства параметров

Тип:Boolean
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-WhatIf

Применимо: безопасность & соответствие требованиям

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

Свойства параметров

Тип:SwitchParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:wi

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.