Condividi tramite

Get-ActiveSyncDeviceStatistics

Modulo:
Exchange PowerShell

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

Il cmdlet Get-ActiveSyncDeviceStatistics consente di recuperare l'elenco dei dispositivi mobili configurati per la sincronizzazione con la cassetta postale di un utente specificato e di restituire un elenco di statistiche sui dispositivi mobili.

Nota: questo cmdlet funziona meglio in Exchange 2010. Nelle versioni successive di Exchange o Exchange Online usare invece il cmdlet Get-MobileDeviceStatistics. Se sono presenti script che usano Get-ActiveSyncDeviceStatistics, aggiornarli per usare Get-MobileDeviceStatistics.

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

Sintassi

Identity 

Get-ActiveSyncDeviceStatistics
    [-Identity] <ActiveSyncDeviceIdParameter>
    [-DomainController <Fqdn>]
    [-GetMailboxLog]
    [-NotificationEmailAddresses <MultiValuedProperty>]
    [-ShowRecoveryPassword]
    [<CommonParameters>]

Mailbox 

Get-ActiveSyncDeviceStatistics
    -Mailbox <MailboxIdParameter>
    [-DomainController <Fqdn>]
    [-GetMailboxLog]
    [-NotificationEmailAddresses <MultiValuedProperty>]
    [-ShowRecoveryPassword]
    [<CommonParameters>]

Descrizione

Il cmdlet Get-ActiveSyncDeviceStatistics consente di visualizzare un elenco di statistiche su ciascun dispositivo mobile. Inoltre, consente recuperare i registri e di inviarli a un destinatario per la risoluzione dei problemi.

È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Anche se questo articolo elenca tutti i parametri per il cmdlet, è possibile che non si abbia accesso ad alcuni parametri se non sono inclusi nelle autorizzazioni assegnate all'utente. 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

Get-ActiveSyncDeviceStatistics -Mailbox TonySmith

Con questo esempio vengono recuperate le statistiche per il telefono cellulare configurato per la sincronizzazione con la cassetta postale di proprietà dell'utente Tony Smith.

Esempio 2

$UserList = Get-CASMailbox -Filter "HasActiveSyncDevicePartnership -eq `$true -and -not DisplayName -like 'CAS_{*'"

Get-Mailbox $UserList | foreach {Get-ActiveSyncDeviceStatistics -Mailbox $_}

Questo esempio usa il cmdlet Get-CASMailbox per determinare chi nell'organizzazione dispone di un dispositivo mobile Exchange ActiveSync. Per ogni dispositivo mobile, vengono recuperate le statistiche del dispositivo Exchange ActiveSync.

Nota: per altre informazioni sulla sintassi del filtro OPATH, vedere Informazioni aggiuntive sulla sintassi OPATH.

Esempio 3

Get-ActiveSyncDeviceStatistics -Mailbox TonySmith -GetMailboxLog -NotificationEmailAddresses "admin@contoso.com"

Con questo esempio vengono recuperate le statistiche per il telefono cellulare configurato per la sincronizzazione con la cassetta postale di proprietà dell'utente Tony Smith. Restituisce anche il file di log Exchange ActiveSync e lo invia all'amministratore di sistema all'indirizzo admin@contoso.com.

Parametri

-DomainController

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

-GetMailboxLog

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

L'opzione GetMailboxLog specifica se inviare le statistiche dei dispositivi mobili agli indirizzi di posta elettronica specificati dal parametro NotificationEmailAddresses. 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

-Identity

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

Il parametro Identity consente di specificare l'ID del dispositivo dell'utente. Se viene specificato il parametro Mailbox, il parametro Identity è disattivato.

Attenzione: il valore $null o un valore inesistente per il parametro Identity restituisce tutti gli oggetti come se fosse stato eseguito il comando Get- senza il parametro Identity. Verificare che gli elenchi di valori per il parametro Identity siano accurati e non contengano valori $null inesistenti.

Proprietà dei parametri

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

Set di parametri

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

-Mailbox

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

Il parametro Mailbox consente di specificare la cassetta postale dell'utente per cui si desidera recuperare le statistiche del telefono cellulare. È possibile utilizzare qualsiasi valore che identifichi la cassetta postale in modo univoco. Ad esempio:

  • Nome
  • Alias
  • Nome distinto (DN)
  • Nome distinto (DN)
  • Dominio\Nome utente
  • Indirizzo di posta elettronica
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ID utente o Nome entità utente (UPN)

Proprietà dei parametri

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

Set di parametri

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

-NotificationEmailAddresses

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

Il parametro NotificationEmailAddresses specifica un elenco delimitato da virgole di indirizzi di posta elettronica per ricevere le statistiche dei dispositivi mobili quando si usa l'opzione GetMailboxLog.

Questo parametro è significativo solo se si usa anche l'opzione GetMailboxLog nello stesso comando.

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

-ShowRecoveryPassword

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

Il parametro ShowRecoveryPassword consente di specificare se restituire la password di ripristino per il telefono cellulare come una delle statistiche visualizzate. Se questo parametro è impostato su $true, il comando restituisce la password di ripristino per il telefono cellulare come una delle statistiche visualizzate.

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

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.