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 |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-Confirm
Применимо: соответствие требованиям & безопасности
Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. Влияние этого параметра на командлет зависит от того, требуется ли командлету подтверждение перед выполнением.
- Деструктивные командлеты (например, командлеты Remove-) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис:
-Confirm:$false. - Большинство других командлетов (например, командлеты New- и Set-) не имеют встроенной паузы. Для этих командлетов указание переключателя Confirm без значения вводит паузу, которая заставляет вас подтвердить команду перед продолжением.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ExchangeLocation
Применимо: соответствие требованиям & безопасности
Параметр ExchangeLocation указывает адрес электронной почты почтового ящика, содержащего удержания для просмотра или удаления.
Этот параметр является обязательным при использовании значения GetHolds или RemoveHold для параметра Action.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Force
Применимо: соответствие требованиям & безопасности
Переключатель "Принудительно" скрывает сообщения с предупреждениями или подтверждениями. Указывать значение для этого параметра необязательно.
Этот параметр можно использовать для принудительного удаления удержания, даже если политика активна. Вместо этого следует удалить удержание из политики удержания дела.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-HoldId
Применимо: соответствие требованиям & безопасности
Параметр HoldId указывает удержание, которое требуется просмотреть или удалить.
Чтобы найти допустимые значения для этого параметра, используйте этот командлет со значением параметра Action GetHolds и найдите свойство HoldId в выходных данных.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-SharePointLocation
Применимо: соответствие требованиям & безопасности
Параметр SharePointLocation указывает URL-адрес сайта SharePoint, который содержит удержания для просмотра или удаления.
Этот параметр является обязательным при использовании значения GetHolds или RemoveHold для параметра Action.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | wi |
Наборы параметров
(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.