Clear-MobileDevice
Questo cmdlet è disponibile in Exchange locale e nel servizio basato su cloud. Alcuni parametri e impostazioni possono essere esclusivi di singoli ambienti.
Il cmdlet Clear-MobileDevice consente di eliminare tutti i dati da un telefono cellulare. Questa azione viene spesso chiamata cancellazione remota dati nel dispositivo.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Clear-MobileDevice
[-Identity] <MobileDeviceIdParameter>
[-AccountOnly]
[-Cancel]
[-Confirm]
[-DomainController <Fqdn>]
[-NotificationEmailAddresses <MultiValuedProperty>]
[-WhatIf]
[<CommonParameters>]
Descrizione
Il cmdlet Clear-MobileDevice elimina tutti i dati utente da un dispositivo mobile la volta successiva che il dispositivo riceve i dati dal server exchange Microsoft. Questo cmdlet consente di impostare il parametro DeviceWipeStatus su $true. Il dispositivo mobile riconosce il cmdlet e registra il timestamp nel parametro DeviceWipeAckTime.
Dopo l'esecuzione del cmdlet, viene visualizzato il seguente avviso: "Tutti i dati presenti nel dispositivo saranno eliminati definitivamente. Vuoi continuare?" È necessario rispondere all'avviso per l'esecuzione del cmdlet sul telefono cellulare.
È 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
Clear-MobileDevice -Identity TonySmith\ExchangeActiveSyncDevices\REST§Outlook§5eec4e941e0748a264512fd83770d5ac
Questo esempio cancella tutti i dati dal dispositivo mobile specificato.
Esempio 2
Clear-MobileDevice -Identity TonySmith\ExchangeActiveSyncDevices\REST§Outlook§5eec4e941e0748a264512fd83770d5ac -NotificationEmailAddresses "chris@contoso.com"
Questo esempio cancella tutti i dati dal dispositivo mobile specificato e invia un messaggio di posta elettronica di conferma a chris@contoso.com.
Esempio 3
Clear-MobileDevice -Identity TonySmith\ExchangeActiveSyncDevices\REST§Outlook§5eec4e941e0748a264512fd83770d5ac -Cancel
In questo esempio viene annullata una richiesta di comando Clear-MobileDevice inviata in precedenza per il dispositivo mobile specificato.
Parametri
-AccountOnly
L'opzione AccountOnly specifica se eseguire una cancellazione del dispositivo remoto solo account in cui vengono rimossi solo i dati delle cassette postali di Exchange dal dispositivo. Con questa opzione non è necessario specificare alcun valore.
Non è necessario usare questa opzione per il valore DeviceType Outlook, perché una cancellazione remota del dispositivo solo account è l'unico tipo di cancellazione usato nei dispositivi Outlook.
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 |
-Cancel
L'opzione Annulla specifica se inviare una richiesta di annullamento per una cancellazione remota del dispositivo in sospeso. 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 |
-Confirm
L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. L'impatto di questa opzione sul cmdlet dipende dalla richiesta di conferma del cmdlet prima di procedere.
- I cmdlet distruttivi , ad esempio i cmdlet Remove-*, hanno una pausa predefinita che impone 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 hanno una pausa predefinita. Per questi cmdlet, specificando l'opzione Confirm senza un valore viene introdotta una pausa che impone all'utente di confermare il comando prima di procedere.
Type: | SwitchParameter |
Aliases: | cf |
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 |
-Identity
Il parametro Identity consente di specificare il dispositivo mobile da reimpostare. È 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: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-NotificationEmailAddresses
Il parametro NotificationEmailAddresses consente di specificare l'indirizzo di posta elettronica a cui inviare la conferma della cancellazione remota dei dati nel dispositivo. È possibile specificare più valori separati da virgole.
Type: | MultiValuedProperty |
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 |
-WhatIf
L'opzione WhatIf consente di simulare le azioni del comando. È possibile utilizzare tale opzione per visualizzare le modifiche che verrebbero applicate senza effettivamente applicarle. Con questa opzione non è necessario specificare alcun valore.
Type: | SwitchParameter |
Aliases: | wi |
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 |
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.