Crear un informe en suspensiones en casos de exhibición de documentos electrónicos en Office 365

Importante:  Este artículo se ha traducido con traducción automática; vea la declinación de responsabilidades. Para su referencia, puede encontrar la versión en inglés de este artículo aquí.

Nota: La secuencia de comandos en este artículo se ha actualizado para solucionar un problema donde ubicaciones de contenido en suspensión no se incluyan en el informe. Gracias a los clientes que dio lugar a esta a nuestra atención.

La secuencia de comandos en este artículo permite a los administradores de exhibición de documentos electrónicos y los administradores de exhibición generan un informe que contiene información acerca de todas las suspensiones asociadas a casos de exhibición de documentos electrónicos en la Centro de cumplimiento y seguridad de Office 365. El informe contiene información como el nombre de la caja una suspensión está asociado con las ubicaciones de contenido que se colocan en espera, y si la suspensión está basado en la consulta. Consulte la sección más información para obtener una descripción detallada de la información incluida en el informe.

Antes de empezar

  • Para generar un informe en todos los casos de exhibición de documentos electrónicos en su organización, debe ser un administrador de exhibición de su organización. Si es un administrador de exhibición de documentos electrónicos, el informe sólo incluirá información acerca de los casos que puede tener acceso. Para obtener más información sobre los permisos de exhibición de documentos electrónicos, consulte asignar permisos de exhibición de documentos electrónicos en el centro de cumplimiento y la seguridad de Office 365.

  • La secuencia de comandos en este artículo tiene errores mínimas. La finalidad principal es crear rápidamente informe sobre las suspensiones asociadas a los casos de exhibición de documentos electrónicos en su organización.

  • Los scripts de ejemplo que aparecen en este tema no son soportados por ningún programa o servicio de soporte técnico de Microsoft. Los scripts de ejemplo aparecen "TAL CUAL", sin garantía de ningún tipo. Además, Microsoft no se hace responsable de cualquier garantía implícita, incluyendo, de manera enunciativa pero no limitativa, cualquier garantía implícita de comercialización o de calidad para cualquier propósito. Cualquier riesgo resultante del uso o resultado de los scripts y la documentación de ejemplo será únicamente responsabilidad suya. En ningún caso Microsoft, sus autores o cualquier persona involucrada en su creación, producción o entrega de los scripts será responsable de cualquier daño (incluidos, de manera enunciativa pero no limitativa, daños por pérdidas de beneficios de una empresa, interrupción de la actividad de una empresa, pérdidas de información de una empresa, o cualquier otro daño pecuniario), incluso si Microsoft supiera de la posibilidad de tales daños.

Paso 1: Conectar con la seguridad y el centro de cumplimiento con PowerShell remoto

El primer paso es conectar Windows PowerShell para la Centro de cumplimiento y seguridad para su organización.

  1. Guardar el texto siguiente en un archivo de script de Windows PowerShell mediante un sufijo nombre de archivo. ps1; Por ejemplo, ConnectSCC.ps1.

    # Get login credentials 
    $UserCredential = Get-Credential 
    $Session = New-PSSession -ConfigurationName Microsoft.Exchange -ConnectionUri https://ps.compliance.protection.outlook.com/powershell-liveid -Credential $UserCredential -Authentication Basic -AllowRedirection 
    Import-PSSession $Session -AllowClobber -DisableNameChecking 
    $Host.UI.RawUI.WindowTitle = $UserCredential.UserName + " (Office 365 Security & Compliance Center)" 
    
  2. En el equipo local, abra Windows PowerShell y vaya a la carpeta donde guardó la secuencia de comandos.

  3. Ejecutar la secuencia de comandos; Por ejemplo:

    .\ConnectSCC.ps1
  4. Cuando se le solicite sus credenciales, escriba su dirección de correo electrónico y contraseña y, a continuación, haga clic en Aceptar.

Volver al principio

Paso 2: Ejecutar la secuencia de comandos para informar sobre las suspensiones asociada a casos de exhibición de documentos electrónicos

Después de que se ha conectado a la Centro de cumplimiento y seguridad con PowerShell remoto, el siguiente paso es crear y ejecutar la secuencia de comandos que recopila información sobre los casos de exhibición de documentos electrónicos en su organización.

  1. Guardar el texto siguiente en un archivo de script de Windows PowerShell mediante un sufijo nombre de archivo. ps1; Por ejemplo, CaseHoldsReport.ps1.

    #script begin
    " " 
    write-host "***********************************************"
    write-host "   Office 365 Security & Compliance Center   " -foregroundColor yellow -backgroundcolor darkgreen
    write-host "        eDiscovery cases - Holds report         " -foregroundColor yellow -backgroundcolor darkgreen 
    write-host "***********************************************"
    " " 
    
    #prompt users to specify a path to store the output files
    $time=get-date
    $Path = Read-Host 'Enter a file path to save the report to a .csv file'
    $outputpath=$Path+'\'+'CaseHoldsReport'+' '+$time.day+'-'+$time.month+'-'+$time.year+' '+$time.hour+'.'+$time.minute+'.csv'
    
    #add case details to the csv file
    
    function add-tocasereport{
    Param([string]$casename,
    [String]$casestatus,
    [datetime]$casecreatedtime,
    [string]$casemembers,
    [datetime]$caseClosedDateTime,
    [string]$caseclosedby,
    [string]$holdname,
    [String]$Holdenabled,
    [string]$holdcreatedby,
    [string]$holdlastmodifiedby,
    [string]$ExchangeLocation,
    [string]$sharePointlocation,
    [string]$ContentMatchQuery,
    [datetime]$holdcreatedtime,
    [datetime]$holdchangedtime
    )
    $addRow = New-Object PSObject 
    Add-Member -InputObject $addRow -MemberType NoteProperty -Name "Case name" -Value $casename
    Add-Member -InputObject $addRow -MemberType NoteProperty -Name "Case status" -Value $casestatus
    Add-Member -InputObject $addRow -MemberType NoteProperty -Name "Case members" -Value $casemembers
    Add-Member -InputObject $addRow -MemberType NoteProperty -Name "Case created time" -Value $casecreatedtime
    Add-Member -InputObject $addRow -MemberType NoteProperty -Name "Case closed time" -Value $caseClosedDateTime
    Add-Member -InputObject $addRow -MemberType NoteProperty -Name "Case closed by" -Value $caseclosedby
    Add-Member -InputObject $addRow -MemberType NoteProperty -Name "Hold name" -Value $holdname
    Add-Member -InputObject $addRow -MemberType NoteProperty -Name "Hold enabled" -Value $Holdenabled
    Add-Member -InputObject $addRow -MemberType NoteProperty -Name "Hold created by" -Value $holdcreatedby
    Add-Member -InputObject $addRow -MemberType NoteProperty -Name "Hold last changed by" -Value $holdlastmodifiedby
    Add-Member -InputObject $addRow -MemberType NoteProperty -Name "Exchange locations" -Value  $ExchangeLocation
    Add-Member -InputObject $addRow -MemberType NoteProperty -Name "SharePoint locations" -Value $sharePointlocation
    Add-Member -InputObject $addRow -MemberType NoteProperty -Name "Hold query" -Value $ContentMatchQuery
    Add-Member -InputObject $addRow -MemberType NoteProperty -Name "Hold created time (UTC)" -Value $holdcreatedtime
    Add-Member -InputObject $addRow -MemberType NoteProperty -Name "Hold changed time (UTC)" -Value $holdchangedtime
    
    $allholdreport = $addRow | Select-Object "Case name","Case status","Hold name","Hold enabled","Case members", "Case created time","Case closed time","Case closed by","Exchange locations","SharePoint locations","Hold query","Hold created by","Hold created time (UTC)","Hold last changed by","Hold changed time (UTC)"
    
    $allholdreport | export-csv -path $outputPath -notypeinfo -append -Encoding ascii 
    }
    
    #get information on the cases and pass values to the case report function
    
    " "
    write-host "Gathering a list of cases and holds..."
    " "
    $edc =Get-ComplianceCase -ErrorAction SilentlyContinue
    foreach($cc in $edc)
    {
    write-host "Working on case :" $cc.name
    if($cc.status -eq 'Closed')
    {
    $cmembers = ((Get-ComplianceCaseMember -Case $cc.name).windowsLiveID)-join ';'
    add-tocasereport -casename $cc.name -casestatus $cc.Status -caseclosedby $cc.closedby -caseClosedDateTime $cc.ClosedDateTime -casemembers $cmembers 
    }
    else{
    $cmembers = ((Get-ComplianceCaseMember -Case $cc.name).windowsLiveID)-join ';'
    $policies = Get-CaseHoldPolicy -Case $cc.Name | %{ Get-CaseHoldPolicy $_.Name -Case $_.CaseId -DistributionDetail}
    foreach ($policy in $policies)
    {
    $rule=Get-CaseHoldRule -Policy $policy.name
    add-tocasereport -casename $cc.name -casemembers $cmembers -casestatus $cc.Status -casecreatedtime $cc.CreatedDateTime -holdname $policy.name -holdenabled $policy.enabled -holdcreatedby $policy.CreatedBy -holdlastmodifiedby $policy.LastModifiedBy -ExchangeLocation (($policy.exchangelocation.name)-join ';') -SharePointLocation (($policy.sharePointlocation.name)-join ';') -ContentMatchQuery $rule.ContentMatchQuery -holdcreatedtime $policy.WhenCreatedUTC -holdchangedtime $policy.WhenChangedUTC
    }
    }
    }
    " "
    Write-host "Script complete! Report file: '$outputPath'"
    " "
    #script end
  2. En la sesión de Windows PowerShell que abrió en el paso 1, vaya a la carpeta donde guardó la secuencia de comandos.

  3. Ejecutar la secuencia de comandos; Por ejemplo:

    .\CaseHoldsReport.ps1

    La secuencia de comandos se mostrará un mensaje guardar el informe a una carpeta de destino.

  4. Escriba el nombre de ruta de acceso completa de la carpeta donde desea guardar el informe y, a continuación, presione ENTRAR.

    Sugerencia: Para guardar el informe en la misma carpeta que se encuentra la secuencia de comandos en, escriba un punto (".") cuando se le solicite una carpeta de destino. Para guardar el informe en una subcarpeta de la carpeta donde se encuentra la secuencia de comandos, escriba el nombre de la subcarpeta.

    Inicia la secuencia de comandos recopilar información acerca de todos los casos de exhibición de documentos electrónicos en su organización. No tener acceso al archivo de informe mientras se está ejecutando el script. Una vez completada la secuencia de comandos, se muestra un mensaje de confirmación de la sesión de Windows PowerShell. Cuando se muestre este mensaje, puede acceder a los informes en la carpeta especificada en el paso 4. El nombre de archivo para el informe es CaseHoldsReport < DateTimeStamp > .csv.

    Aquí es un ejemplo de la ejecución de la secuencia de comandos de CaseHoldsReport.ps1.

    El resultado después de ejecutar la secuencia de comandos de CaseHoldsReport.ps1

Volver al principio

Más información

El caso contiene el informe que se crea al ejecutar la secuencia de comandos en este artículo contiene la información siguiente sobre cada suspensión. Como se explica anteriormente, debe ser un administrador para obtener información para todas las suspensiones en su organización de exhibición de documentos electrónicos. Para obtener más información sobre las suspensiones mayúsculas y minúsculas, vea administrar casos de exhibición de documentos electrónicos en el centro de cumplimiento y la seguridad de Office 365.

  • El nombre de la suspensión y el nombre de la caja de exhibición de documentos electrónicos que está asociada la suspensión.

  • Si es o no el caso de exhibición de documentos electrónicos activos o cerrados.

  • Si la suspensión está activada o deshabilitada.

  • Los miembros de la caja de exhibición de documentos electrónicos que está asociada la suspensión. Para ver o administrar un caso, según los permisos de exhibición de documentos electrónicos que tiene asignadas miembros mayúsculas y minúsculas.

  • La hora y fecha de que creación del caso.

  • Si se cierra un caso, la persona que ha cerrado y la hora y la fecha se ha cerrado.

  • Los buzones de Exchange y SharePoint ubicaciones de sitios que están en espera.

  • Si la suspensión está basado en la consulta, la sintaxis de la consulta.

  • La hora y fecha de que creación de la suspensión y la persona que lo creó.

  • La hora y fecha de que última modificación de la suspensión y la persona que haya cambiado.

Volver al principio

Nota: Declinación de responsabilidades de traducción automática: Este artículo se ha traducido con un sistema informático sin intervención humana. Microsoft ofrece estas traducciones automáticas para que los hablantes de otros idiomas distintos del inglés puedan disfrutar del contenido sobre los productos, los servicios y las tecnologías de Microsoft. Puesto que este artículo se ha traducido con traducción automática, es posible que contenga errores de vocabulario, sintaxis o gramática.

Ampliar sus conocimientos
Explorar los cursos
Obtener nuevas características primero
Únase a los participantes de Office Insider

¿Le ha sido útil esta información?

¡Gracias por sus comentarios!

Gracias por sus comentarios. Quizá le interese ponerse en contacto con uno de nuestros agentes de soporte de Office.

×