Search-AdminAuditLog
Nota:
Este cmdlet ha quedado en desuso en el servicio basado en la nube. Para acceder a los datos del registro de auditoría, use el Search-UnifiedAuditLog cmdlet. Para obtener más información, consulte esta entrada de blog: https://aka.ms/AdminAuditCmdletBlog.
Este cmdlet solo está disponible en el entorno local de Exchange.
Use el cmdlet Search-AdminAuditLog para buscar el contenido del registro de auditoría de administrador. El administrador registra los registros de auditoría cuando un usuario o administrador realiza un cambio en la organización (en el Centro de administración de Exchange o mediante cmdlets).
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)
Search-AdminAuditLog
[-Cmdlets <MultiValuedProperty>]
[-DomainController <Fqdn>]
[-EndDate <ExDateTime>]
[-ExternalAccess <Boolean>]
[-IsSuccess <Boolean>]
[-ObjectIds <MultiValuedProperty>]
[-Parameters <MultiValuedProperty>]
[-ResultSize <Int32>]
[-StartDate <ExDateTime>]
[-StartIndex <Int32>]
[-UserIds <MultiValuedProperty>]
[<CommonParameters>]
Description
Si ejecuta el cmdlet Search-AdminAuditLog sin parámetros, se devolverán de forma predeterminada hasta 1.000 entradas de registro.
En PowerShell de Exchange Online, si no usa los parámetros FechaDeInicio o FechaDeFinalización, solo se devuelven los resultados de los últimos 14 días.
En Exchange Online PowerShell, hay disponibles los datos de los últimos 90 días. Puede especificar fechas anteriores a 90 días, pero solo se devuelven datos de los últimos 90 días.
Para obtener más información sobre la estructura y las propiedades del registro de auditoría, consulte Estructura del registro de auditoría del administrador.
Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este artículo se enumeran todos los parámetros del cmdlet, es posible que no tenga acceso a algunos parámetros si no se incluyen en los permisos que tiene asignados. Para obtener los permisos necesarios para ejecutar cualquier cmdlet o parámetro en su organización, consulte Find the permissions required to run any Exchange cmdlet.
Ejemplos
Ejemplo 1
Search-AdminAuditLog -Cmdlets New-RoleGroup,New-ManagementRoleAssignment
En este ejemplo, se buscan todas las entradas del registro de auditoría de administrador que contengan el cmdlet New-RoleGroup o New-ManagementRoleAssignment.
Ejemplo 2
Search-AdminAuditLog -Cmdlets Set-Mailbox -Parameters UseDatabaseQuotaDefaults,ProhibitSendReceiveQuota,ProhibitSendQuota -StartDate 01/24/2018 -EndDate 02/12/2018 -IsSuccess $true
En este ejemplo, se buscan todas entradas del registro de auditoría de administrador que coincidan con los criterios siguientes:
- Cmdlets: Set-Mailbox
- Parámetros: UseDatabaseQuotaDefaults, ProhibitSendReceiveQuota, ProhibitSendQuota
- Fecha de inicio: 24/01/2018
- Fecha de fin: 02/12/2018
El comando se completó correctamente
Ejemplo 3
$LogEntries = Search-AdminAuditLog -Cmdlets Write-AdminAuditLog
$LogEntries | ForEach { $_.CmdletParameters }
En este ejemplo, se muestran todos los comentarios escritos en el registro de auditoría de administrador por el cmdlet Write-AdminAuditLog.
En primer lugar, almacena las entradas del registro de auditoría en una variable temporal. A continuación, recorra en iteración todas las entradas del registro de auditoría devueltas y muestre la propiedad Parámetros.
Ejemplo 4
Search-AdminAuditLog -ExternalAccess $true -StartDate 09/17/2018 -EndDate 10/02/2018
Este ejemplo devuelve entradas en el registro de auditoría de administrador de una organización de Exchange Online para cmdlets ejecutados por los administradores del centro de datos de Microsoft entre el 17 de septiembre de 2018 y el 2 de octubre de 2018.
Parámetros
-Cmdlets
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
El parámetro Cmdlets filtra los resultados por los cmdlets que se usaron. Puede especificar varios cmdlets separados por comas.
En los resultados de este cmdlet, esta propiedad se denomina CmdletName.
Propiedades de parámetro
| Tipo: | MultiValuedProperty |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-DomainController
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
El parámetro DomainController especifica el controlador de dominio que el cmdlet usa para leer datos de Active Directory o escribirlos. El controlador de dominio se identifica por su nombre de dominio completo (FQDN). Por ejemplo, dc01.contoso.com.
Propiedades de parámetro
| Tipo: | Fqdn |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-EndDate
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
El parámetro EndDate especifica la fecha de finalización del intervalo de fechas.
Use el formato de fecha corta que se define en la opción Configuración regional en el equipo en el que se ejecuta el comando. Por ejemplo, si el equipo está configurado para usar el formato de fecha corta MM/dd/aaaa, escriba 09/01/2018 para especificar el 1 de septiembre de 2018. Puede escribir solo la fecha, o la fecha y la hora del día. Si escribe la fecha y la hora del día, encierre el valor entre comillas ("), por ejemplo, "01/09/2018 5:00 PM".
En el servicio basado en la nube, si especifica un valor de fecha y hora sin zona horaria, el valor estará en hora universal coordinada (UTC). Para especificar un valor de fecha y hora para este parámetro, use una de las siguientes opciones:
- Especifique el valor de fecha y hora en UTC: Por ejemplo, "2021-05-06 14:30:00z".
- Especifique el valor de fecha y hora como una fórmula que convierte la fecha y hora de la zona horaria local a UTC: Por ejemplo,
(Get-Date "5/6/2021 9:30 AM").ToUniversalTime(). Para obtener más información, vea Get-Date.
En los resultados de este cmdlet, la fecha y hora en que se realizó el cambio (se ejecutó el cmdlet) se devuelve en la propiedad denominada RunDate.
Propiedades de parámetro
| Tipo: | ExDateTime |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ExternalAccess
Aplicable: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
El parámetro ExternalAccess filtra los resultados por los cambios realizados (cmdlets ejecutados) por usuarios de fuera de la organización. Los valores admitidos son:
- $true: devolver solo las entradas del registro de auditoría en las que el cambio lo haya realizado un usuario externo. Valor en uso para devolver las entradas del registro de auditoría de los cambios realizados por los administradores del centro de datos de Microsoft.
- $false: Devolver solo las entradas del registro de auditoría en las que el cambio lo haya realizado un usuario interno.
Propiedades de parámetro
| Tipo: | Boolean |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-IsSuccess
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
El parámetro IsSuccess filtra los resultados en función de si los cambios se realizaron correctamente. Los valores admitidos son:
- $true: devolver solo las entradas del registro de auditoría en las que el cambio se realizó correctamente (en otras palabras, el cmdlet se ejecutó correctamente).
- $false: devolver solo las entradas del registro de auditoría en las que el cambio no se realizó correctamente (en otras palabras, el cmdlet no se ejecutó correctamente y produjo un error).
En los resultados de este cmdlet, esta propiedad se denomina Correcta.
Propiedades de parámetro
| Tipo: | Boolean |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ObjectIds
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
El parámetro ObjectIds filtra los resultados por el objeto que se ha modificado (el buzón, carpeta pública, conector de envío, regla de transporte, dominio aceptado, etc. en el que operó el cmdlet). Un valor válido depende de cómo se represente el objeto en el registro de auditoría. Por ejemplo:
- Nombre
- Nombre distintivo canónico (por ejemplo, contoso.com/Users/Akia Al-Zuhairi)
- Identidad de carpeta pública (por ejemplo, \Engineering\Customer Discussion)
Es probable que necesite usar otros parámetros de filtrado en este cmdlet para restringir los resultados e identificar los tipos de objetos que le interesan. En los resultados de este cmdlet, esta propiedad se denomina ObjectModified.
Update Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "Value1","Value2",..."ValueN".
Propiedades de parámetro
| Tipo: | MultiValuedProperty |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Parameters
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
El parámetro Parameters filtra los resultados por los parámetros que se usaron. Solo puede usar este parámetro con el parámetro Cmdlets (no puede usarlo por sí mismo). Puede especificar varios parámetros separados por comas.
En los resultados de este cmdlet, esta propiedad se denomina CmdletParameters
Propiedades de parámetro
| Tipo: | MultiValuedProperty |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ResultSize
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
El parámetro ResultSize especifica el número máximo de resultados que se van a devolver. El valor predeterminado es 1000.
El número máximo de resultados a devolver es 250 000.
Propiedades de parámetro
| Tipo: | Int32 |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-StartDate
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
El parámetro StartDate especifica la fecha de inicio del intervalo de fechas.
Use el formato de fecha corta que se define en la opción Configuración regional en el equipo en el que se ejecuta el comando. Por ejemplo, si el equipo está configurado para usar el formato de fecha corta MM/dd/aaaa, escriba 09/01/2018 para especificar el 1 de septiembre de 2018. Puede escribir solo la fecha, o la fecha y la hora del día. Si escribe la fecha y la hora del día, encierre el valor entre comillas ("), por ejemplo, "01/09/2018 5:00 PM".
En el servicio basado en la nube, si especifica un valor de fecha y hora sin zona horaria, el valor estará en hora universal coordinada (UTC). Para especificar un valor de fecha y hora para este parámetro, use una de las siguientes opciones:
- Especifique el valor de fecha y hora en UTC: Por ejemplo, "2021-05-06 14:30:00z".
- Especifique el valor de fecha y hora como una fórmula que convierte la fecha y hora de la zona horaria local a UTC: Por ejemplo,
(Get-Date "5/6/2021 9:30 AM").ToUniversalTime(). Para obtener más información, vea Get-Date.
En los resultados de este cmdlet, la fecha y hora en que se realizó el cambio (se ejecutó el cmdlet) se devuelve en la propiedad denominada RunDate.
Propiedades de parámetro
| Tipo: | ExDateTime |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-StartIndex
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
El parámetro StartIndex especifica la posición en el conjunto de resultados donde se inician los resultados mostrados.
Propiedades de parámetro
| Tipo: | Int32 |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-UserIds
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
El parámetro UserIds filtra los resultados por el usuario que realizó el cambio (que ejecutó el cmdlet).
Un valor típico de este parámetro es el nombre principal de usuario (UPN; por ejemplo, helpdesk@contoso.com). Sin embargo, las actualizaciones realizadas por cuentas del sistema sin direcciones de correo electrónico podrían usar la sintaxis Dominio\Nombre de usuario (por ejemplo, NT AUTHORITY\SYSTEM (MSExchangeHMHost)).
Update Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "User1","User2",..."UserN".
En los resultados de este cmdlet, esta propiedad se denomina Llamador
Propiedades de parámetro
| Tipo: | MultiValuedProperty |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | 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.
Entradas
Input types
Para ver los tipos de entrada que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de entrada de un cmdlet está en blanco, el cmdlet no acepta datos de entrada.
Salidas
Output types
Para ver los tipos de valor devuelto (también conocidos como tipos de resultado) que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de resultado está en blanco, el cmdlet no devuelve datos.