Clear-ActiveSyncDevice

  • Riferimento
Modulo:
ExchangePowerShell
Si applica a:
Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

Questo cmdlet è disponibile in Exchange locale e nel servizio basato su cloud. Alcuni parametri e impostazioni possono essere esclusivi di singoli ambienti.

Utilizzare il cmdlet Clear-ActiveSyncDevice per eliminare tutti i dati da un dispositivo mobile.

Nota: in Exchange 2013 o versioni successive usare invece il cmdlet Clear-MobileDevice. Se sono presenti script che usano Clear-ActiveSyncDevice, aggiornarli per usare Clear-MobileDevice.

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

Sintassi

Clear-ActiveSyncDevice
     [-Identity] <ActiveSyncDeviceIdParameter>
     [-Cancel]
     [-Confirm]
     [-DomainController <Fqdn>]
     [-NotificationEmailAddresses <MultiValuedProperty>]
     [-WhatIf]
     [<CommonParameters>]

Descrizione

Il cmdlet Clear-ActiveSyncDevice elimina tutti i dati utente da un dispositivo mobile alla successiva ricezione dei 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-ActiveSyncDevice -Identity WM_JeffHay

In questo esempio vengono cancellati tutti i dati dal dispositivo mobile con identità WM_JeffHay.

Esempio 2

Clear-ActiveSyncDevice -Identity WM_TonySmith -NotificationEmailAddresses "tony@contoso.com"

Questo esempio cancella tutti i dati dal dispositivo mobile per Tony Smith e invia un messaggio di posta elettronica di conferma a tony@contoso.com.

Esempio 3

Clear-ActiveSyncDevice -Identity WM_TonySmith -Cancel $true

In questo esempio viene annullata la richiesta del comando Clear-ActiveSyncDevice inviata in precedenza al dispositivo mobile di Tony Smith.

Parametri

-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 2010, 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 2010, 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 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Identity

Il parametro Identity consente di specificare l'identità del dispositivo da reimpostare.

Type:ActiveSyncDeviceIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, 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 2010, 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 2010, 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.