New-PublicFolderMoveRequest
Questo cmdlet è disponibile solo in Exchange locale.
Utilizzare il cmdlet New-PublicFolderMoveRequest per iniziare il processo di spostamento del contenuto delle cartelle pubbliche tra le cassette postali delle cartelle pubbliche. Lo spostamento delle cartelle pubbliche consente di spostare solo il contenuto fisico della cartella pubblica, senza cambiare la gerarchia logica. Una volta completata la richiesta è necessario eseguire il cmdlet Remove-PublicFolderMoveRequest per rimuovere la richiesta o attendere che trascorra il tempo specificato con il parametro CompletedRequestAgeLimit. La richiesta deve essere rimossa prima di poter eseguire un'altra richiesta di spostamento.
Tenere presente che la cassetta postale delle cartelle pubbliche di destinazione verrà bloccata mentre la richiesta di spostamento è attiva. Per altre informazioni, vedere la sezione Descrizione.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
New-PublicFolderMoveRequest
-Folders <PublicFolderIdParameter[]>
-TargetMailbox <MailboxIdParameter>
[-AcceptLargeDataLoss]
[-AllowLargeItems]
[-BadItemLimit <Unlimited>]
[-CompletedRequestAgeLimit <Unlimited>]
[-Confirm]
[-DomainController <Fqdn>]
[-InternalFlags <InternalMrsFlag[]>]
[-Name <String>]
[-Priority <RequestPriority>]
[-RequestExpiryInterval <Unlimited>]
[-Suspend]
[-SuspendComment <String>]
[-SuspendWhenReadyToComplete]
[-WhatIf]
[-WorkloadType <RequestWorkloadType>]
[<CommonParameters>] Descrizione
Il cmdlet New-PublicFolderMoveRequest sposta le cartelle pubbliche da una cassetta postale delle cartelle pubbliche di origine a una cassetta postale delle cartelle pubbliche di destinazione. La cassetta postale delle cartelle pubbliche di destinazione verrà bloccata mentre la richiesta di spostamento è attiva. Pertanto, le cartelle pubbliche che già risiedono nella cassetta postale delle cartelle pubbliche di destinazione saranno inaccessibili fino al completamento della richiesta di spostamento. Pertanto, prima di iniziare la richiesta di spostamento, è necessario assicurarsi che nessun utente accinga ad accedere ai dati delle cartelle pubbliche nella cassetta postale della cartella pubblica di destinazione.
Per spostare la cassetta postale delle cartelle pubbliche un altro database delle cassetta postali, utilizzare il cmdlet New-MoveRequest. Per accertarsi che la cartella si trovi già nella cassetta postale delle cartelle pubbliche, eseguire il cmdlet Update-PublicFolderMailbox sulla cassetta postale delle cartelle pubbliche di destinazione. È possibile eseguire una sola richiesta di spostamento alla volta. È possibile, inoltre, spostare le cartelle pubbliche utilizzando lo script Move-PublicFolderBranch.ps1.
È 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
New-PublicFolderMoveRequest -Folders \DeveloperReports\CustomerEngagements -TargetMailbox DeveloperReports01In questo esempio viene avviata la richiesta di spostamento per la cartella pubblica \CustomerEnagagements dalla cassetta postale delle cartelle pubbliche DeveloperReports a DeveloperReports01
Esempio 2
New-PublicFolderMoveRequest -Folders \Dev\CustomerEngagements,\Dev\RequestsforChange,\Dev\Usability -TargetMailbox DeveloperReports01In questo esempio viene iniziata la richiesta di spostamento per le cartelle pubbliche appartenenti al ramo \Dev nella cassetta postale delle cartelle pubbliche di destinazione DeveloperReports01.
È possibile, inoltre, spostare un ramo delle cartelle pubbliche utilizzando lo script Move-PublicFolderBranch.ps1.
Esempio 3
$folders = Get-PublicFolder \ -Recurse -Mailbox PUB1 -ResidentFolders | ?{$_.Name -ne "IPM_SUBTREE"} | %{$_.Identity}
New-PublicFolderMoveRequest -TargetMailbox PUB2 -Folders $foldersIn questo esempio tutte le cartelle pubbliche vengono spostate dalla cassetta postale della cartella pubblica Pub1 alla cassetta postale della cartella pubblica Pub2.
Parametri
-AcceptLargeDataLoss
L'opzione AcceptLargeDataLoss specifica che la richiesta deve continuare anche se non è possibile copiare un numero elevato di elementi nella cassetta postale di origine nella cassetta postale di destinazione. Con questa opzione non è necessario specificare alcun valore.
È 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.
| 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 |
-AllowLargeItems
L'opzione AllowLargeItems specifica che è possibile spostare elementi di grandi dimensioni solo quando vengono rilevati. Con questa opzione non è necessario specificare alcun valore.
Elementi di grandi dimensioni sono messaggi di posta elettronica con un massimo di 1,023 allegati.
| 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 |
-BadItemLimit
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 possono essere trovati 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, il che significa che la richiesta avrà esito negativo se vengono rilevati elementi non validi. Se si è d'accordo nel lasciare indietro alcuni elementi non validi, è possibile impostare questo parametro su un valore ragionevole (si consiglia 10 o inferiore) in modo che la richiesta possa continuare. Se vengono rilevati troppi elementi non validi, provare a usare il cmdlet New-MailboxRepairRequest per tentare di correggere gli elementi danneggiati nella cassetta postale di origine e quindi ritentare la richiesta.
| 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 |
-CompletedRequestAgeLimit
Il parametro CompletedRequestAgeLimit specifica per quanto tempo la richiesta verrà mantenuta dopo essere stata completata prima di essere rimossa automaticamente. Il valore predefinito per questo parametro è 30 giorni.
| 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 |
-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 |
-DomainController
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 |
-Folders
Il parametro Folders consente di specificare le cartelle pubbliche da spostare. Se la cartella pubblica include cartelle pubbliche figlio, queste cartelle pubbliche figlio non verranno spostate a meno che non vengano specificate in modo esplicito nel comando . È possibile spostare più cartelle pubbliche separandole con una virgola, ad esempio \Dev\CustomerEngagements,\Dev\RequestsforChange,\Dev\Usability.
| Type: | PublicFolderIdParameter[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-InternalFlags
Il parametro InternalFlags indica i passaggi facoltativi della richiesta. Questo parametro è utilizzato principalmente a fini di debug.
| Type: | InternalMrsFlag[] |
| 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 |
-Name
Il parametro Name consente di specificare il nome della richiesta di spostamento delle cartelle pubbliche. Se non si specifica un nome, il nome predefinito è PublicFolderMove.
| 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 |
-Priority
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:
- Lowest
- Lower
- Low
- Normal: questo è il valore predefinito.
- High
- Higher
- Highest
- Emergency
| Type: | RequestPriority |
| 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 |
-RequestExpiryInterval
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.
| Type: | Unlimited |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019 |
-Suspend
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.
| 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 |
-SuspendComment
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.
| 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 |
-SuspendWhenReadyToComplete
L'opzione SuspendWhenReadyToComplete consente di specificare se sospendere la richiesta prima che raggiunga lo stato CompletionInProgress. Con questa opzione non è necessario specificare alcun valore.
Dopo la sospensione, lo stato dello spostamento diventa AutoSuspended. È quindi possibile completare manualmente lo spostamento mediante il comando Resume-PublicFolderMoveRequest.
| 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 |
-TargetMailbox
Il parametro TargetMailbox consente di specificare la cassetta postale delle cartelle pubbliche di destinazione in cui spostare le cartelle pubbliche. È 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)
| Type: | MailboxIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-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 |
-WorkloadType
Il parametro WorkloadType viene riservato all'utilizzo interno di Microsoft.
| Type: | RequestWorkloadType |
| 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 |
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.