New-MailboxExportRequest

L'opzione AcceptLargeDataLoss consente di specificare che la richiesta deve proseguire anche se non è possibile copiare nella cassetta postale di destinazione un gran numero di elementi della cassetta postale di origine. Con questa opzione non è necessario specificare alcun valore.

In Exchange 2013 o versioni successive è necessario usare questa opzione se si imposta il parametro LargeItemLimit su un valore pari o superiore a 51. In caso contrario, il comando avrà esito negativo.

In Exchange 2010 è necessario usare questa opzione se il parametro BadItemLimit è impostato sul valore 51 o un valore superiore. In caso contrario, il comando avrà esito negativo.

Il parametro AssociatedMessagesCopyOption consente di specificare se i messaggi associati vengono copiati durante l'elaborazione della richiesta. I messaggi associati sono messaggi speciali che contengono dati nascosti con informazioni sulle regole, sulle visualizzazioni e sui moduli. Per impostazione predefinita, i messaggi associati vengono copiati. I valori validi per questo parametro sono i seguenti:

• DoNotCopy: i messaggi associati non vengono copiati.
• MapByMessageClass: questa opzione trova il messaggio associato corrispondente cercando l'attributo MessageClass del messaggio di origine. Se è presente un messaggio associato di questa classe in entrambe le cartelle di origine e destinazione, il messaggio associato nella destinazione viene sovrascritto. Se nella destinazione non è presente un messaggio associato, viene creata una copia nella destinazione.
• Copia: questa opzione copia i messaggi associati dall'origine alla destinazione. Se nei percorsi di origine e destinazione esiste lo stesso tipo di messaggio, questi messaggi associati vengono duplicati. Questa è l'opzione predefinita.

Il filtro contenuto non viene applicato ai messaggi associati.

Il parametro BadItemLimit consente di specificare il numero massimo di elementi non validi consentiti prima che la richiesta abbia un esito negativo. Un elemento non valido è un elemento danneggiato nella cassetta postale di origine che non è possibile copiare nella cassetta postale di destinazione. Rientrano negli elementi non validi anche gli elementi mancanti. Gli elementi mancanti sono elementi nella cassetta postale di origine che non è possibile rilevare nella cassetta postale di destinazione quando la richiesta è pronta per essere completata.

L'input valido per questo parametro è un numero intero o il valore Unlimited. Il valore predefinito è 0, che indica che la richiesta avrà esito negativo se vengono rilevati elementi non validi. Se si decide di lasciare alcuni elementi non validi, è possibile impostare questo parametro su un valore ragionevole (si consiglia 10 o un valore inferiore) in modo da consentire l'elaborazione della richiesta. In caso di rilevamento di un numero eccessivo di elementi non validi, provare a utilizzare il cmdlet New-MailboxRepairRequest per tentare di correggere gli elementi corrotti nella cassetta postale di origine e procedere di nuovo con la richiesta.

Se in Exchange 2010 si imposta il valore su 51 o su un valore maggiore, è necessario utilizzare anche l'opzione AcceptLargeDataLoss. In caso contrario, il comando avrà esito negativo.

Il parametro BatchName consente di specificare un nome descrittivo per l'esportazione di un gruppo di cassette postali. È possibile utilizzare il nome nel parametro BatchName come stringa di ricerca, quando si utilizza il cmdlet Get-MailboxExportRequest.

Il parametro CompletedRequestAgeLimit consente di specificare il tempo di conservazione della richiesta dopo il completamento, prima che avvenga la rimozione automatica. Il valore predefinito per CompletedRequestAgeLimit è di 30 giorni.

Questo parametro è riservato all'uso interno da parte di Microsoft.

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.

Il parametro ConflictResolutionOption consente di specificare le operazioni da eseguire se sono presenti più messaggi corrispondenti nella destinazione. I valori validi sono:

• ForceCopy
• KeepAll
• KeepLatestItem
• KeepLatestItem
• KeepTargetItem
• UpdateFromSource

Il parametro ContentFilter usa la sintassi del filtro OPATH per filtrare i risultati in base alle proprietà e ai valori specificati. Nel file PST sarà esportato esclusivamente il contenuto corrispondente al parametro ContentFilter. 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, $falseo $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. Per le proprietà filtrabili, vedere Proprietà filtrabili per il parametro ContentFilter.
• 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 usare 500, $true, $falseo $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.

Il parametro ContentFilterLanguage consente di specificare la lingua utilizzata nel parametro ContentFilter per eseguire le ricerche di stringhe.

L'input valido per questo parametro è un valore di codice delle impostazioni cultura supportato dalla classe CultureInfo Microsoft .NET Framework. Ad esempio, da-DK per il danese o ja-JP per il giapponese. Per altre informazioni, vedere Classe CultureInfo.

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.

L'opzione ExcludeDumpster specifica se escludere la cartella Elementi ripristinabili. Con questa opzione non è necessario specificare alcun valore.

Se non si usa questa opzione, la cartella Elementi ripristinabili viene copiata con le sottocartelle seguenti:

• Eliminazioni
• Versioni
• Purges

Il parametro ExcludeFolders consente di specificare l'elenco delle cartelle da escludere durante l'esportazione.

I nomi delle cartelle non fanno distinzione tra maiuscole e minuscole e non sono previste limitazioni sui caratteri. Usare la seguente sintassi:

<FolderName>/*: utilizzare questa sintassi per indicare una cartella personale nella cartella specificata nel parametro SourceRootFolder, ad esempio "MyProjects" o "MyProjects/FY2010".

#<FolderName>#/*: utilizzare questa sintassi per indicare una cartella nota indipendentemente dal nome della cartella in un'altra lingua. Ad esempio, #Inbox# indica la cartella Inbox, anche se questa viene localizzata in italiano (Posta in arrivo). Le cartelle note includono i seguenti tipi:

• Posta in arrivo
• SentItems
• DeletedItems
• Calendario
• Contatti
• Bozze
• Diario
• Attività
• Note
• JunkEmail
• CommunicatorHistory
• Messaggi vocali
• Fax
• Conflitti
• SyncIssues
• LocalFailures
• ServerFailures

Se l'utente crea una cartella personale con lo stesso nome di una cartella nota e il simbolo # che la circonda, è possibile usare una barra rovesciata (\) come carattere di escape per specificare tale cartella. Ad esempio, se un utente crea una cartella denominata #Notes# e si desidera specificare tale cartella anziché la cartella Note nota, usare la sintassi seguente: \#Notes\#.

Non è possibile usare i caratteri jolly nei nomi delle cartelle.

Per escludere la cartella Elementi ripristinabili, è necessario usare il parametro ExcludeDumpster.

Il parametro FilePath consente di specificare il percorso della condivisione di rete del file PST nel quale vengono esportati i dati, ad esempio \\SERVER01\PST Files\exported.pst.

È necessario concedere al gruppo Sottosistema attendibile Exchange la seguente autorizzazione per la condivisione di rete in cui saranno esportate o importate i file PST.

• Per importare i file PST dalla condivisione: Autorizzazione di lettura
• Per salvare i file PST esportati nella condivisione: Autorizzazioni di lettura/scrittura:

Se questa autorizzazione non viene concessa, si riceverà un messaggio di errore che segnala che Exchange non è in grado di stabilire una connessione al file PST sulla condivisione di rete.

Il parametro IncludeFolders consente di specificare l'elenco delle cartelle da includere durante l'esportazione.

I nomi delle cartelle non fanno distinzione tra maiuscole e minuscole e non sono previste limitazioni sui caratteri. Usare la seguente sintassi:

<FolderName>/*: utilizzare questa sintassi per indicare una cartella personale nella cartella specificata nel parametro SourceRootFolder, ad esempio "MyProjects" o "MyProjects/FY2010".

#<FolderName>#/*: utilizzare questa sintassi per indicare una cartella nota indipendentemente dal nome della cartella in un'altra lingua. Ad esempio, #Inbox# indica la cartella Inbox, anche se questa viene localizzata in italiano (Posta in arrivo). Le cartelle note includono i seguenti tipi:

• Posta in arrivo
• SentItems
• DeletedItems
• Calendario
• Contatti
• Bozze
• Diario
• Attività
• Note
• JunkEmail
• CommunicatorHistory
• Messaggi vocali
• Fax
• Conflitti
• SyncIssues
• LocalFailures
• ServerFailures

Se l'utente crea una cartella personale con lo stesso nome di una cartella nota e il simbolo # che la circonda, è possibile usare una barra rovesciata (\) come carattere di escape per specificare tale cartella. Ad esempio, se un utente crea una cartella denominata #Notes# e si desidera specificare tale cartella anziché la cartella Note nota, usare la sintassi seguente: \#Notes\#.

Non è possibile usare i caratteri jolly nei nomi delle cartelle.

La cartella Elementi ripristinabili è sempre inclusa se non si usa il parametro ExcludeDumpster, indipendentemente dall'elenco di cartelle specificate.

Il parametro InternalFlags indica i passaggi facoltativi della richiesta. Questo parametro è utilizzato principalmente a fini di debug.

L'opzione IsArchive consente di specificare che l'esportazione avviene dall'archivio dell'utente. Con questa opzione non è necessario specificare alcun valore.

Il parametro LargeItemLimit consente di specificare il numero massimo di elementi di grandi dimensioni consentiti prima che la richiesta abbia un esito negativo. Un elemento di grandi dimensioni è un messaggio nella cassetta postale di origine che supera la dimensione massima dei messaggi consentita nella cassetta postale di destinazione. Se la cassetta postale di destinazione non dispone di un valore di dimensione massima dei messaggi configurato in modo specifico, viene utilizzato il valore al livello dell'organizzazione.

Per ulteriori informazioni sui valori della dimensione massima dei messaggi, vedere i seguenti argomenti:

• Exchange 2016: limiti delle dimensioni dei messaggi in Exchange Server
• Exchange Online: Limiti di Exchange Online

L'input valido per questo parametro è un numero intero o il valore Unlimited. Il valore predefinito è 0, che indica che la richiesta avrà esito negativo se vengono rilevati elementi di grandi dimensioni. Se si decide di lasciare alcuni elementi di grandi dimensioni, è possibile impostare questo parametro su un valore ragionevole (si consiglia 10 o un valore inferiore) in modo da consentire l'elaborazione della richiesta.

Se si imposta il valore su 51 o su un valore maggiore, è necessario utilizzare anche l'opzione AcceptLargeDataLoss. In caso contrario, il comando avrà esito negativo.

Il parametro Mailbox consente di specificare la cassetta postale di origine da cui viene esportato il contenuto.

In Exchange 2016 CU7 o versioni successive questo parametro è il tipo MailboxLocationIdParameter, quindi il valore più semplice che è possibile usare per identificare la cassetta postale è il valore Alias.

In Exchange 2016 CU6 o versioni precedenti questo parametro è di tipo MailboxOrMailUserIdParameter, quindi è possibile usare qualsiasi valore che identifichi in modo univoco la cassetta postale. 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)

Questo parametro è disponibile solo in Exchange Server 2010.

Il parametro MRSServer consente di specificare il nome di dominio completo (FQDN) del server Accesso client su cui è in esecuzione l'istanza del servizio di replica delle cassette postali di Microsoft Exchange. Questo parametro viene utilizzato solo per il debug. Utilizzare questo parametro solo se indicato dal personale del supporto.

Il parametro Name consente di specificare il nome della richiesta specifica per ragioni di verifica e di visualizzazione. Poiché è possibile avere più richieste di esportazione per cassetta postale, Exchange precede il nome con l'alias della cassetta postale. Ad esempio, se si crea una richiesta di esportazione per la cassetta postale di un utente che contiene l'alias Kweku e si specifica il valore del parametro come PC1toArchive, l'identità della richiesta di esportazione sarà Kweku\PC1toArchive.

Se non si specifica un nome usando questo parametro, Exchange genera fino a 10 nomi di richiesta per cassetta postale, ovvero MailboxExportX (dove X = 0-9). L'identità della richiesta viene visualizzata e ricercabile come <alias>\MailboxExportX.

Questo parametro è riservato all'uso interno da parte di Microsoft.

Il parametro Priority consente di specificare l'ordine di elaborazione della richiesta nella coda delle richieste. Le richieste vengono elaborate con un ordine basato sull'integrità, lo stato, la priorità e l'ora di ultimo aggiornamento del server. I valori di priorità validi sono:

• Lower
• Low
• Normale (valore predefinito).
• High
• Higher
• Highest
• Emergency

Questo parametro è riservato all'uso interno da parte di Microsoft.

Questo parametro è riservato all'uso interno da parte di Microsoft.

Il parametro RequestExpiryInterval consente di specificare un periodo di validità per una richiesta completata o non riuscita. Quando si utilizza questo parametro, la richiesta completata o non riuscita viene rimossa automaticamente dopo la scadenza dell'intervallo specificato. Se non si utilizza questo parametro:

• La richiesta completata viene rimossa automaticamente in base al valore del parametro CompletedRequestAgeLimit.
• Se la richiesta ha esito negativo, è necessario rimuoverla manualmente usando il cmdlet Remove-*Request corrispondente.

Per specificare un valore, immetterlo come intervallo di tempo: dd.hh:mm:ss dove dd = giorni, hh = ore, mm = minuti e ss = secondi.

Quando si utilizza il valore Unlimited, la richiesta completata non viene rimossa automaticamente.

Il parametro SkipMerging consente di specificare i passaggi dell'esportazione da ignorare. Questo parametro è utilizzato principalmente a fini di debug.

Il parametro SourceRootFolder consente di specificare la cartella radice della cassetta postale da cui esportare i dati. Se questo parametro non viene specificato, il comando consente di esportare tutte le cartelle.

L'opzione Suspend consente di specificare se sospendere o meno la richiesta. Con questa opzione non è necessario specificare alcun valore.

Se si utilizza questa opzione, la richiesta viene accodata e non raggiunge lo stato InProgress fino a quando non viene ripresa tramite l'apposito cmdlet.

Il parametro SuspendComment consente di specificare la descrizione del motivo per cui la richiesta è stata sospesa. È possibile utilizzare questo parametro solo se si specifica il parametro Suspend.

Il parametro TargetRootFolder consente di specificare la cartella di primo livello in cui esportare i dati. Se il parametro non viene specificato, il comando consente di esportare le cartelle nella parte superiore delle struttura di cartelle del file PST di destinazione. Il contenuto viene unito nelle cartelle esistenti; se nella struttura di cartelle di destinazione non esistono cartelle corrispondenti, vengono create nuove cartelle.

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.

Questo parametro è riservato all'uso interno da parte di Microsoft.