New-MailboxAuditLogSearch

Modulo:: Exchange PowerShell

Nota

Questo cmdlet verrà deprecato nel servizio basato su cloud. Per accedere ai dati del log di controllo, usare il cmdlet Search-UnifiedAuditLog. Per ulteriori informazioni, vedere questo post del blog: https://aka.ms/AuditCmdletBlog.

Questo cmdlet è disponibile in Exchange locale e nel servizio basato su cloud. Alcuni parametri e impostazioni potrebbero essere esclusivi di un ambiente o dell'altro.

Usare il cmdlet New-MailboxAuditLogSearch per cercare nei log di controllo delle cassette postali e inviare i risultati della ricerca tramite posta elettronica ai destinatari specificati.

Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.

Sintassi

Default (Impostazione predefinita)

New-MailboxAuditLogSearch
    -EndDate <ExDateTime>
    -StartDate <ExDateTime>
    -StatusMailRecipients <MultiValuedProperty>
    [-Confirm]
    [-DomainController <Fqdn>]
    [-ExternalAccess <Boolean>]
    [-GroupMailbox]
    [-HasAttachments <Boolean>]
    [-LogonTypes <MultiValuedProperty>]
    [-Mailboxes <MultiValuedProperty>]
    [-Name <String>]
    [-Operations <MultiValuedProperty>]
    [-ShowDetails]
    [-WhatIf]
    [<CommonParameters>]

Descrizione

Il cmdlet New-MailboxAuditLogSearch esegue una ricerca asincrona dei log di controllo delle cassette postali per le cassette postali specificate e invia i risultati della ricerca tramite posta elettronica ai destinatari specificati. Il corpo del messaggio di posta elettronica contiene i metadati della ricerca, ad esempio i parametri di ricerca e l'ora in cui è stata inviata la richiesta di ricerca. I risultati vengono allegati in un file .xml.

Per cercare nei registri di controllo delle cassette postali una singola cassetta postale e visualizzare i risultati nella finestra di Exchange Management Shell, utilizzare invece il cmdlet Search-MailboxAuditLog. Per ulteriori informazioni sulla registrazione di controllo delle cassette postali, vedere Registrazione di controllo delle cassette postali in Exchange Server.

È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Anche se questo articolo elenca tutti i parametri per il cmdlet, si potrebbe non avere accesso ad alcuni parametri se non sono inclusi nelle autorizzazioni assegnate. Per individuare le autorizzazioni necessarie per eseguire cmdlet o parametri nell'organizzazione, vedere Trovare le autorizzazioni necessarie per eseguire i cmdlet di Exchange.

Esempio

Esempio 1

New-MailboxAuditLogSearch "Admin and Delegate Access" -Mailboxes "Ken Kwok","April Stewart" -LogonTypes Admin,Delegate -StartDate 1/1/2018 -EndDate 12/31/2018 -StatusMailRecipients auditors@contoso.com

In questo esempio viene creata una ricerca nel log di controllo della cassetta postale per cercare nelle cassette postali di Ken Kwok e April Stewart gli accessi di amministratore e delegato dall'1/1/2018 al 31/12/2018. I risultati della ricerca vengono inviati a auditors@contoso.com tramite posta elettronica.

Esempio 2

New-MailboxAuditLogSearch -ExternalAccess $true -StartDate 09/01/2018 -EndDate 10/24/2018 -StatusMailRecipients admin@contoso.com

Questo esempio restituisce le voci dei log di controllo delle cassette postali di tutti gli utenti nell'organizzazione per qualsiasi accesso alle cassette postali da parte degli amministratori dei data center Microsoft tra il 1° settembre 2018 e il 24 ottobre 2018. I risultati della ricerca vengono inviati a admin@contoso.com.

Parametri

-Confirm

L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. Il modo in cui questa opzione influisce sul cmdlet varia se il cmdlet richiede o meno una conferma prima di procedere.

I cmdlet distruttivi (ad esempio, i cmdlet Remove-*) dispongono di una pausa incorporata che impone all'utente di confermare il comando prima di procedere. Per questi cmdlet, è possibile ignorare la richiesta di conferma usando questa precisa sintassi: -Confirm:$false.
La maggior parte degli altri cmdlet (ad esempio, i cmdlet New-* e Set-*) non dispone di una pausa incorporata. Per questi cmdlet, se si specifica l'opzione Confirm senza un valore, viene introdotta una pausa che impone di confermare il comando prima di procedere.

Proprietà dei parametri

Tipo:	SwitchParameter
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False
Alias:	cfr

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-DomainController

Questo parametro è disponibile solo in Exchange locale.

Il parametro DomainController consente di specificare il controller di dominio utilizzato da questo cmdlet per la lettura o la scrittura dei dati in Active Directory. Identificare il controller di dominio mediante il relativo nome di dominio completo (FQDN). Ad esempio, dc01.contoso.com.

Proprietà dei parametri

Tipo:	Fqdn
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-EndDate

Il parametro EndDate consente di specificare la data di fine dell'intervallo di date.

Usare il formato data breve definito nelle impostazioni Opzioni internazionali nel computer in cui viene eseguito il comando. Se ad esempio il computer è configurato per l'utilizzo del formato data breve MM/gg/aaaa, immettere 01/09/2018 per specificare 1 settembre 2018. È possibile immettere solo la data oppure specificare la data e l'ora del giorno. In quest'ultimo caso, racchiudere il valore tra virgolette ("), ad esempio, "01/09/2018 17:00".

Proprietà dei parametri

Tipo:	ExDateTime
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	True
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-ExternalAccess

Il parametro ExternalAccess consente di specificare se restituire solo le voci del log di controllo per l'accesso alle cassette postali da parte di utenti esterni all'organizzazione. In Exchange Online questo parametro restituisce le voci del log di controllo per l'accesso alle cassette postali da parte degli amministratori del data center Microsoft. I valori validi sono:

$true: vengono restituite le voci di log di controllo per l'accesso alla cassetta postale da parte di utenti esterni o amministratori di data center Microsoft.

$false: le voci del log di controllo per l'accesso alla cassetta postale da parte di utenti esterni o amministratori del data center Microsoft vengono ignorate. Questo è il valore predefinito.

Proprietà dei parametri

Tipo:	Boolean
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-GroupMailbox

Questo parametro è disponibile solamente nel servizio basato su cloud.

L'opzione GroupMailbox è necessaria per includere i Gruppi di Microsoft 365 nella ricerca. Con questa opzione non è necessario specificare alcun valore.

Proprietà dei parametri

Tipo:	SwitchParameter
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-HasAttachments

Il parametro HasAttachments consente di filtrare la ricerca in base ai messaggi con allegati. I valori validi sono:

$true: solo i messaggi con allegati vengono inclusi nella ricerca.
$false: i messaggi con e senza allegati vengono inclusi nella ricerca.

Proprietà dei parametri

Tipo:	Boolean
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-LogonTypes

Il parametro LogonTypes consente di specificare il tipo di accessi. I valori validi sono:

Amministrazione: vengono restituite le voci di log di controllo per l'accesso alla cassetta postale da parte degli accessi dell'amministratore.
Delegato: vengono restituite le voci di log di controllo per l'accesso alla cassetta postale da parte dei delegati, incluso l'accesso da parte degli utenti con autorizzazione per l'accesso completo alla cassetta postale.
Esterno: per le cassette postali di Exchange Online, vengono restituite le voci del log di controllo per l'accesso alle cassette postali da parte degli amministratori del data center Microsoft.
Proprietario: vengono restituite le voci di log di controllo per l'accesso alla cassetta postale da parte del proprietario principale della cassetta postale. Questo valore richiede l'opzione ShowDetails.

È possibile immettere più valori separati da virgole.

Proprietà dei parametri

Tipo:	MultiValuedProperty
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-Mailboxes

Il parametro Mailboxes consente di specificare la cassetta postale da cui recuperare le voci del log di controllo della cassetta postale.

È possibile immettere più valori separati da virgole. Se i valori contengono spazi o richiedono le virgolette, utilizzare la sintassi seguente: "Value1","Value2",..."ValueN".

Se non si specifica un valore, vengono restituiti i log di controllo delle cassette postali di tutte le cassette postali dell'organizzazione.

Proprietà dei parametri

Tipo:	MultiValuedProperty
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-Name

Il parametro Name consente di specificare un nome per la ricerca. La lunghezza massima è 64 caratteri. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-Operations

Il parametro Operations consente di filtrare i risultati della ricerca per le operazioni che vengono registrate dalla cassetta postale. I valori validi sono:

Copia
Creare
FolderBind
HardDelete
MailboxLogin
MessageBind
Move
MoveToDeletedItems
SendAs
SendOnBehalf
SoftDelete
Update

È possibile immettere più valori separati da virgole.

Proprietà dei parametri

Tipo:	MultiValuedProperty
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-ShowDetails

L'opzione ShowDetails specifica che vengono recuperati i dettagli di ogni voce del log. Con questa opzione non è necessario specificare alcun valore.

Proprietà dei parametri

Tipo:	SwitchParameter
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-StartDate

Il parametro StartDate consente di specificare la data di inizio dell'intervallo di date.

Proprietà dei parametri

Tipo:	ExDateTime
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	True
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-StatusMailRecipients

Il parametro StatusMailRecipients consente di specificare l'indirizzo di posta elettronica a cui vengono inviati i risultati della ricerca. È possibile specificare più valori separati da virgole.

Proprietà dei parametri

Tipo:	MultiValuedProperty
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	True
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-WhatIf

L'opzione WhatIf mostra le operazioni eseguite dal comando senza apportare modifiche. Con questa opzione non è necessario specificare alcun valore.

Proprietà dei parametri

Tipo:	SwitchParameter
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False
Alias:	wi

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters.

Input

Input types

Per verificare i tipi di input accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di input di un cmdlet è vuoto, il cmdlet non accetta dati di input.

Output

Output types

Per verificare i tipi restituiti, detti anche tipi di output, accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di output è vuoto, il cmdlet non restituisce dati.

Commenti e suggerimenti

Questa pagina è stata utile?