Get-MobileDevice
Questo cmdlet è disponibile in Exchange locale e nel servizio basato su cloud. Alcuni parametri e impostazioni possono essere esclusivi di singoli ambienti.
Usare il cmdlet Get-MobileDevice per ottenere l'elenco dei dispositivi dell'organizzazione con partnership attive.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Get-MobileDevice
-Mailbox <MailboxIdParameter>
[-ActiveSync]
[-DomainController <Fqdn>]
[-Filter <String>]
[-Monitoring]
[-OrganizationalUnit <OrganizationalUnitIdParameter>]
[-OWAforDevices]
[-ResultSize <Unlimited>]
[-SortBy <String>]
[-RestApi]
[-UniversalOutlook]
[<CommonParameters>]
Get-MobileDevice
[[-Identity] <MobileDeviceIdParameter>]
[-ActiveSync]
[-DomainController <Fqdn>]
[-Filter <String>]
[-Monitoring]
[-OrganizationalUnit <OrganizationalUnitIdParameter>]
[-OWAforDevices]
[-ResultSize <Unlimited>]
[-SortBy <String>]
[-RestApi]
[-UniversalOutlook]
[<CommonParameters>]
Descrizione
Il cmdlet Get-MobileDevice restituisce l'identificazione, la configurazione e le informazioni sullo stato per ogni dispositivo mobile.
È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Sebbene in questo argomento vengano elencati tutti i parametri relativi al cmdlet, si potrebbe non avere accesso ad alcuni di essi qualora non siano 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
Get-MobileDevice -Mailbox "Tony Smith"
In questo esempio vengono restituiti tutti i dispositivi mobili usati da Tony Smith associati alla cassetta postale.
Esempio 2
Get-MobileDevice -ResultSize unlimited | Format-Table -Auto DeviceModel,Identity
In questo esempio viene restituito un elenco riepilogativo di tutti i dispositivi mobili dell'organizzazione.
Esempio 3
Get-MobileDevice -Identity Lila\ExchangeActiveSyncDevices\REST§Outlook§5eec4e941e0748a264512fd83770d5ac | Format-List
In questo esempio vengono restituite informazioni dettagliate sul dispositivo specificato nella cassetta postale di Lila.
Parametri
-ActiveSync
L'opzione ActiveSync filtra i risultati in base ai dispositivi Exchange ActiveSync. Con questa opzione non è necessario specificare alcun valore.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-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.
Type: | Fqdn |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Filter
Il parametro Filter usa la sintassi OPATH per filtrare i risultati in base alle proprietà e ai valori specificati. I criteri di ricerca usano la sintassi "Property -ComparisonOperator 'Value'"
.
- Racchiudere l'intero filtro OPATH tra virgolette doppie " ". Se il filtro contiene valori di sistema (ad esempio,
$true
,$false
o$null
), usare le virgolette singole ''. Sebbene questo parametro sia una stringa (non un blocco di sistema), è anche possibile usare le parentesi graffe { }, ma solo se il filtro non contiene variabili. - La proprietà è una proprietà filtrabile.
- ComparisonOperator è un operatore di confronto OPATH, ad esempio
-eq
per equals e-like
per il confronto di stringhe. Per ulteriori informazioni sugli operatori di confronto, vedere about_Comparison_Operators. - Il valore è il valore della proprietà da cercare. Racchiudere valori di testo e variabili tra virgolette singole (
'Value'
o'$Variable'
). Se un valore variabile contiene virgolette singole, è necessario identificare (escape) le virgolette singole per espandere correttamente la variabile. Ad esempio, invece di'$User'
, usare'$($User -Replace "'","''")'
. Non racchiudere valori interi o di sistema tra virgolette, ad esempio usare500
,$true
,$false
o$null
.
È possibile concatenare più criteri di ricerca usando gli operatori -and
logici e -or
. Ad esempio, "Criteria1 -and Criteria2"
o "(Criteria1 -and Criteria2) -or Criteria3"
.
Per informazioni dettagliate sui filtri OPATH in Exchange, vedere Informazioni aggiuntive sulla sintassi OPATH.
È possibile filtrare in base alle seguenti proprietà:
- ClientType
- DeviceAccessControlRule
- DeviceAccessState
- DeviceAccessStateReason
- DeviceActiveSyncVersion
- DeviceId
- DeviceImei
- DeviceMobileOperator
- DeviceModel
- DeviceOS
- DeviceOSLanguage
- DeviceTelephoneNumber
- Devicetype
- DeviceUserAgent
- FirstSyncTime
- FriendlyName
- ProvisioningFlags
- UserDisplayName
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Identity
Il parametro Identity consente di specificare il dispositivo mobile che si desidera visualizzare. È possibile usare i valori seguenti che identificano in modo univoco il dispositivo mobile:
- Identità (
<Mailbox Name>\ExchangeActiveSyncDevices\<MobileDeviceObjectName>
ad esempio,CarlosM\ExchangeActiveSyncDevices\REST§Outlook§5eec4e941e0748a264512fd83770d5ac
) - Nome distinto (DN)
- GUID (uguale a ExchangeObjectId)
Type: | MobileDeviceIdParameter |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Mailbox
Il parametro Mailbox consente di filtrare i risultati per cassetta postale. È possibile utilizzare qualsiasi valore che identifichi la cassetta postale in modo univoco. Ad esempio:
- Nome
- Alias
- Nome distinto (DN)
- Nome distinto (DN)
- Dominio\nomeutente
- Indirizzo di posta elettronica
- GUID
- LegacyExchangeDN
- SamAccountName
- ID utente o Nome entità utente (UPN)
Non è possibile utilizzare questo parametro con il parametro Identity.
Type: | MailboxIdParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Monitoring
Questo parametro è disponibile solo in Exchange locale.
L'opzione Monitoraggio è necessaria per restituire le cassette postali di monitoraggio nei risultati. Con questa opzione non è necessario specificare alcun valore.
Le cassette postali di monitoraggio sono associate alla disponibilità gestita e al servizio Exchange Health Manager e hanno un valore della proprietà RecipientTypeDetails di MonitoringMailbox.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-OrganizationalUnit
Il parametro OrganizationalUnit filtra i risultati in base alla posizione dell'oggetto in Active Directory. Vengono restituiti solo gli oggetti presenti nella posizione specificata. L'input valido per questo parametro è un'unità organizzativa o un dominio restituito dal cmdlet Get-OrganizationalUnit. È possibile utilizzare qualsiasi valore che identifichi l'unità organizzativa o il dominio in modo univoco. Ad esempio:
- Nome
- Nome
- Nome distinto (DN)
- GUID
Type: | OrganizationalUnitIdParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-OWAforDevices
L'opzione OWAforDevices filtra i risultati in base al fatto che Outlook sul web per i dispositivi sia abilitato per il dispositivo. Con questa opzione non è necessario specificare alcun valore.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-RestApi
L'opzione RestApi filtra i risultati in base ai dispositivi API REST. Con questa opzione non è necessario specificare alcun valore.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-ResultSize
Il parametro ResultSize consente di specificare il numero massimo di risultati da restituire. Se si desidera restituire tutte le richieste che soddisfano la query, impostare questo parametro sul valore unlimited. Il valore predefinito è 1000.
Type: | Unlimited |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-SortBy
Il parametro SortBy consente di specificare la proprietà in base a cui ordinare i risultati. È possibile ordinare in base a una sola proprietà alla volta. I risultati vengono visualizzati in ordine crescente.
Se la visualizzazione predefinita non include la proprietà per cui si esegue l'ordinamento, è possibile accodare il comando con | Format-Table -Auto Property1,Property2,...PropertyX
. per creare una nuova visualizzazione che contiene tutte le proprietà che si desidera visualizzare. I caratteri jolly (*) nei nomi di proprietà sono supportati.
È possibile eseguire l'ordinamento in base alle seguenti proprietà:
- DeviceAccessControlRule
- DeviceAccessState
- DeviceAccessStateReason
- DeviceId
- DeviceImei
- DeviceMobileOperator
- DeviceModel
- DeviceOS
- DeviceOSLanguage
- DeviceTelephoneNumber
- Devicetype
- DeviceUserAgent
- FirstSyncTime
- FriendlyName
- UserDisplayName
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-UniversalOutlook
L'opzione UniversalOutlook filtra i risultati in base ai dispositivi Posta e Calendario. Con questa opzione non è necessario specificare alcun valore.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
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.