New-CaseHoldPolicy

Referencia

Módulo:: ExchangePowerShell

Se aplica a:: Security & Compliance

Este cmdlet solo está disponible en PowerShell de cumplimiento de seguridad & . Para obtener más información, consulte Security & Compliance PowerShell.

Use el cmdlet New-CaseHoldPolicy para crear nuevas directivas de suspensión de casos en el portal de cumplimiento Microsoft Purview.

Después de usar el cmdlet New-CaseHoldPolicy para crear una directiva de suspensión de casos, deberá usar el cmdlet New-CaseHoldRule para crear una regla de suspensión de casos y asignarla a la directiva. Si no crea una regla para la directiva, no se creará la suspensión y las ubicaciones del contenido no se suspenderán.

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.

Syntax

New-CaseHoldPolicy
   [-Name] <String>
   -Case <String>
   [-Comment <String>]
   [-Confirm]
   [-Enabled <Boolean>]
   [-ExchangeLocation <MultiValuedProperty>]
   [-Force]
   [-PublicFolderLocation <MultiValuedProperty>]
   [-SharePointLocation <MultiValuedProperty>]
   [-WhatIf]
   [<CommonParameters>]

Description

Para usar este cmdlet en PowerShell de cumplimiento de seguridad & , debe tener asignados permisos. Para obtener más información vea Permisos en el portal de cumplimiento de Microsoft Purview.

Ejemplos

Ejemplo 1

New-CaseHoldPolicy -Name "Regulation 123 Compliance" -Case "123 Compliance Case" -ExchangeLocation "Kitty Petersen", "Scott Nakamura" -SharePointLocation "https://contoso.sharepoint.com/sites/teams/finance"

En este ejemplo se crea una directiva de suspensión de casos denominada "Cumplimiento del Reglamento 123" para los buzones de Kitty Petersen y Scott Nakamura, y el sitio financiero de SharePoint Online para el caso de eDiscovery denominado "Caso de cumplimiento 123".

Recuerde que, después de crear la directiva, deberá crear una regla para ella mediante el cmdlet New-CaseHoldRule.

Parámetros

-Case

El parámetro Case especifica el caso de eDiscovery que desea asociar a la directiva de suspensión de casos. Puede usar los valores siguientes para identificar el caso de eDiscovery:

Nombre
Identidad (valor GUID).

Puede obtener estos valores mediante la ejecución del comando Get-ComplianceCase | Format-Table -Auto Name,Status,Identity.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-Comment

El parámetro Comment especifica un comentario opcional. Si especifica un valor que contenga espacios, escríbalo entre comillas ("), por ejemplo: "Esto es una nota del administrador".

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-Confirm

El modificador Confirm especifica si se debe mostrar u ocultar el mensaje de confirmación. Cómo afecta este modificador el cmdlet depende de si el cmdlet requiere confirmación antes de continuar.

Los cmdlets destructivos (por ejemplo, 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 demás cmdlets (por ejemplo, los cmdlets New-* y Set-*) no tienen una pausa integrada. En estos cmdlets, si se especifica el modificador Confirm sin ningún valor, se introduce una pausa que obliga a confirmar el comando antes de continuar.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-Enabled

El parámetro Enabled especifica si la directiva está habilitada o deshabilitada. Los valores admitidos son:

$true: la directiva está habilitada. Este es el valor predeterminado.
$true: la directiva está habilitada. Es el valor predeterminado.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-ExchangeLocation

El parámetro ExchangeLocation especifica los buzones que se van a incluir en la directiva. Los valores admitidos son:

El parámetro ExchangeLocation especifica los buzones de correo que se incluirán en la directiva. Los valores válidos son:
Un buzón de correo

Para especificar un buzón de correo o un grupo de distribución, puede usar los siguientes valores:

Nombre
Dirección SMTP. Para especificar un buzón inactivo, preceda a la dirección con un punto (.).
ObjectId de Azure AD. Use los cmdlets Get-MgUser o Get-MgGroup en PowerShell de Microsoft Graph para encontrar este valor.

Update Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "Value1","Value2",..."ValueN".

Si no se especifican buzones, no se colocan buzones en suspensión.

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-Force

El modificador Force oculta los mensajes de advertencia o confirmación. No es necesario especificar un valor con este modificador.

Este modificador se puede usar para ejecutar tareas mediante programación en las que no es apropiado solicitar una entrada administrativa.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-Name

El parámetro Name especifica el nombre único de la directiva de suspensión de casos. Si el valor contiene espacios, escríbalo entre comillas.

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-PublicFolderLocation

El parámetro PublicFolderLocation especifica que se desea incluir todas las carpetas públicas en la directiva de suspensión de casos. Use el valor All para este parámetro.

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-SharePointLocation

El parámetro SharePointLocation especifica los sitios de SharePoint Online y OneDrive para la Empresa que se van a incluir. Identifica un sitio por su valor de dirección URL.