Invoke-HoldRemovalAction
Этот командлет доступен только в PowerShell безопасности и соответствия требованиям. Дополнительные сведения см. в статье PowerShell безопасности и соответствия требованиям.
Используйте командлет Invoke-HoldRemovalAction для просмотра и снятия удержаний для почтовых ящиков и сайтов SharePoint. Также можно просмотреть защитные меры, которые ранее были удалены с помощью этого командлета.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Default (По умолчанию)
Invoke-HoldRemovalAction
-Action <HoldRemovalActionType>
[-Confirm]
[-ExchangeLocation <String>]
[-Force]
[-HoldId <String>]
[-SharePointLocation <String>]
[-WhatIf]
[<CommonParameters>]
Описание
Чтобы использовать этот командлет в PowerShell безопасности и соответствия требованиям, вам должны быть назначены соответствующие разрешения. Только администратор соответствия может отменить удержание для расположений Exchange или SharePoint. Дополнительные сведения см. в статье Разрешения на портале соответствия требованиям Microsoft Purview.
Примеры
Пример 1
Invoke-HoldRemovalAction -Action RemoveHold -ExchangeLocation "KittyPetersen@contoso.onmicrosoft.com" -HoldId "UniHecbf89df-74fc-444a-a2dc-c0756c7d3503"
В этом примере снимается указанное удержание для почтового ящика Китти Петерсен, если политика UniHecbf89df-74fc-444a-a2dc-c0756c7d3503 не является активной политикой удержания обращения.
Пример 2
Invoke-HoldRemovalAction -Action GetHolds -SharePointLocation "https://contoso.sharepoint.com/sites/finance"
В этом примере отображаются все сведения об удержаниях на указанном сайте SharePoint.
Пример 3
Invoke-HoldRemovalAction -Action GetHoldRemovals
В этом примере отображаются все удаления удержаний, выполненные с помощью этого командлета.
Параметры
-Action
Применимо: безопасность & соответствие требованиям
Параметр Action определяет режим, в котором работает командлет. Допустимые значения:
- GetHoldRemovals: показывает все удаления удержаний, выполненные с помощью этого командлета.
- GetHolds: показывает удержания для указанного почтового ящика (параметр ExchangeLocation) или сайта SharePoint (параметр SharePointLocation).
- RemoveHold: удаляет указанное удержание (параметр HoldId) из указанного почтового ящика (параметр ExchangeLocation) или сайта SharePoint (параметр SharePointLocation).
Свойства параметров
| Тип: | HoldRemovalActionType |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-Confirm
Применимо: безопасность & соответствие требованиям
Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. То, как этот переключатель влияет на командлет, зависит от того, требует ли командлет подтверждения перед продолжением.
- Деструктивные командлеты (например, командлеты Remove-) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис:
-Confirm:$false. - Большинство других командлетов (например, командлеты New- и Set-) не имеют встроенной паузы. Для этих командлетов указание параметра Confirm без значения приводит к паузе, которая вынуждает вас подтвердить команду перед продолжением.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ExchangeLocation
Применимо: безопасность & соответствие требованиям
Параметр ExchangeLocation указывает адрес электронной почты почтового ящика, содержащего защитные меры, доступные для просмотра или удаления.
Этот параметр необходим при использовании значения GetHolds или RemoveHold для параметра Action.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Force
Применимо: безопасность & соответствие требованиям
Переключатель "Принудительно" скрывает сообщения с предупреждениями или подтверждениями. Указывать значение для этого параметра необязательно.
Этот переключатель можно использовать для принудительного снятия удержания, даже если политика активна. Вместо этого следует удалить удержание из политики удержания обращения.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-HoldId
Применимо: безопасность & соответствие требованиям
Параметр HoldId указывает защитные меры, которые необходимо просмотреть или отменить.
Чтобы найти допустимые значения для этого параметра, используйте этот командлет со значением параметра действия GetHolds и найдите свойство HoldId в выходных данных.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-SharePointLocation
Применимо: безопасность & соответствие требованиям
Параметр SharePointLocation задает URL-адрес сайта SharePoint, который содержит защитные меры, доступные для просмотра или удаления.
Этот параметр необходим при использовании значения GetHolds или RemoveHold для параметра Action.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | wi |
Наборы параметров
(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.