Invoke-HoldRemovalAction
Este cmdlet está disponible solo en Security & Compliance PowerShell. Para obtener más información, consulte Security & Compliance PowerShell.
Use el cmdlet Invoke-HoldRemovalAction para ver y quitar suspensiones en buzones y sitios de SharePoint. También puede ver las suspensiones que se quitaron anteriormente mediante este cmdlet.
Para obtener más información acerca de los conjuntos de parámetros de la sección Sintaxis a continuación, vea Sintaxis del cmdlet de Exchange.
Sintaxis
Default (valor predeterminado)
Invoke-HoldRemovalAction
-Action <HoldRemovalActionType>
[-Confirm]
[-ExchangeLocation <String>]
[-Force]
[-HoldId <String>]
[-SharePointLocation <String>]
[-WhatIf]
[<CommonParameters>]
Description
Para usar este cmdlet en Security & Compliance PowerShell, debe tener asignados permisos. Solo el Administrador de cumplimiento puede quitar la retención para ubicaciones de Exchange o Sharepoint. Para obtener más información vea Permisos en el portal de cumplimiento de Microsoft Purview.
Ejemplos
Ejemplo 1
Invoke-HoldRemovalAction -Action RemoveHold -ExchangeLocation "KittyPetersen@contoso.onmicrosoft.com" -HoldId "UniHecbf89df-74fc-444a-a2dc-c0756c7d3503"
En este ejemplo se quita la suspensión especificada en el buzón de Kitty Petersen si la directiva UniHecbf89df-74fc-444a-a2dc-c0756c7d3503 no es una directiva de retención de casos activa.
Ejemplo 2
Invoke-HoldRemovalAction -Action GetHolds -SharePointLocation "https://contoso.sharepoint.com/sites/finance"
En este ejemplo se muestra toda la información de suspensión en el sitio de SharePoint especificado.
Ejemplo 3
Invoke-HoldRemovalAction -Action GetHoldRemovals
En este ejemplo se muestran todas las eliminaciones de suspensiones que se han realizado con este cmdlet.
Parámetros
-Action
Aplicable: Seguridad & cumplimiento
El parámetro Action especifica el modo en el que opera el cmdlet. Los valores admitidos son:
- GetHoldRemovals: muestra todas las eliminaciones de suspensiones que se realizaron con este cmdlet.
- GetHolds: muestra las suspensiones en el buzón especificado (el parámetro ExchangeLocation) o en el sitio de SharePoint (el parámetro SharePointLocation).
- RemoveHold: quita la suspensión especificada (el parámetro HoldId) del buzón especificado (el parámetro ExchangeLocation) o del sitio de SharePoint (el parámetro SharePointLocation).
Propiedades de parámetro
| Tipo: | HoldRemovalActionType |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | True |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-Confirm
Aplicable: Seguridad & cumplimiento
El modificador Confirm especifica si se debe mostrar u ocultar el mensaje de confirmación. Cómo afecta este modificador al cmdlet depende de si el cmdlet requiere confirmación antes de continuar.
- Los cmdlets destructivos (por ejemplo, los cmdlets Remove-*) tienen una pausa integrada que obliga a confirmar el comando antes de continuar. Para estos cmdlets, puede omitir el mensaje de confirmación mediante esta sintaxis exacta:
-Confirm:$false. - La mayoría de los otros cmdlets (por ejemplo, New-* y Set-*) no tienen una pausa integrada. Para estos cmdlets, especificar el modificador Confirm sin un valor introduce una pausa que le obliga a reconocer el comando antes de continuar.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | cf |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ExchangeLocation
Aplicable: Seguridad & cumplimiento
El parámetro ExchangeLocation especifica la dirección de correo electrónico del buzón que contiene las suspensiones para ver o quitar.
Este parámetro es necesario cuando se usa el valor GetHolds o RemoveHold para el parámetro Action.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Force
Aplicable: Seguridad & cumplimiento
El modificador Force oculta los mensajes de advertencia o confirmación. No es necesario especificar un valor con este modificador.
Puede usar este modificador para forzar la eliminación de la suspensión incluso cuando la directiva está activa. En su lugar, debe quitar la suspensión de la directiva de suspensión de mayúsculas y minúsculas.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-HoldId
Aplicable: Seguridad & cumplimiento
El parámetro HoldId especifica la suspensión que desea ver o quitar.
Para buscar valores válidos para este parámetro, use este cmdlet con el valor del parámetro de acción GetHolds y busque la propiedad HoldId en la salida.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-SharePointLocation
Aplicable: Seguridad & cumplimiento
El parámetro SharePointLocation especifica la dirección URL del sitio de SharePoint que contiene las suspensiones para ver o quitar.
Este parámetro es necesario cuando se usa el valor GetHolds o RemoveHold para el parámetro Action.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | wi |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-WhatIf
Aplicable: Seguridad & cumplimiento
El modificador WhatIf no funciona en Security & Compliance PowerShell.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | wi |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.