Поделиться через


Set-RetentionCompliancePolicy

Этот командлет доступен только в 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
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-AddExchangeLocation

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

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

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

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

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

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

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

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

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

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

-AddExchangeLocationException

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

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

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

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

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

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

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

Тип:MultiValuedProperty
Default value: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
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-AddModernGroupLocationException

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

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

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

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

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

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

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

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

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

-AddOneDriveLocation

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

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

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

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

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

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

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

-AddOneDriveLocationException

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

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

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

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

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

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

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

-AddPublicFolderLocation

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

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

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

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

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

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

-AddSharePointLocation

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

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

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

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

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

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

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

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

-AddSharePointLocationException

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

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

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

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

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

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

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

-AddSkypeLocation

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

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

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

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

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

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

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

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

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

-AddSkypeLocationException

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

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

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

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

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

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

-AddTeamsChannelLocation

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

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

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

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

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

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

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

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

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

-AddTeamsChannelLocationException

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

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

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

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

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

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

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

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

-AddTeamsChatLocation

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

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

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

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

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

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

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

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

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

-AddTeamsChatLocationException

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

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

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

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

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

Тип:MultiValuedProperty
Default value: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
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-Comment

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

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

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

Тип:String
Default value: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
Default value: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
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-Enabled

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

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

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

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

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

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

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

-EnforceSimulationPolicy

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

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

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

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

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

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

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

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

-Force

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

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

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

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

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

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

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

-Identity

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

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

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

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

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

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

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

-PolicyRBACScopes

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

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

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

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

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

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

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

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

-PolicyTemplateInfo

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

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

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

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

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

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

-PriorityCleanup

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

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

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

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

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

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

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

-RemoveAdaptiveScopeLocation

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

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

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

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

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

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

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

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

-RemoveExchangeLocation

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

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

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

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

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

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

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

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

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

-RemoveExchangeLocationException

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

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

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

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

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

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

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

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

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

-RemoveModernGroupLocation

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

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

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

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

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

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

Тип:MultiValuedProperty
Default value: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
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-RemoveOneDriveLocation

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

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

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

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

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

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

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

-RemoveOneDriveLocationException

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

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

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

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

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

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

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

-RemovePublicFolderLocation

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

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

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

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

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

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

-RemoveSharePointLocation

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

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

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

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

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

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

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

-RemoveSharePointLocationException

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

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

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

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

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

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

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

-RemoveSkypeLocation

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

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

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

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

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

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

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

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

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

-RemoveSkypeLocationException

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

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

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

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

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

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

-RemoveTeamsChannelLocation

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

Параметр RemoveTeamsChannelLocation указывает Teams, удаляемый из политики.

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

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

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

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

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

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

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

-RemoveTeamsChannelLocationException

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

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

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

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

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

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

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

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

-RemoveTeamsChatLocation

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

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

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

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

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

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

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

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

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

-RemoveTeamsChatLocationException

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

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

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

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

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

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

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

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

-RestrictiveRetention

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

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

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

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

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

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

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

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

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

-RetryDistribution

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

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

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

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

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

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

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

-StartSimulation

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

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

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

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

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

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

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

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

-WhatIf

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

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

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

Тип:SwitchParameter
Default value: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.