New-SweepRule
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 New-SweepRule per creare regole di organizzazione nelle cassette postali. Le regole di sweep vengono eseguite a intervalli regolari per mantenere pulita la posta in arrivo.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
New-SweepRule
[-Name] <String>
-Provider <String>
[-Confirm]
[-DestinationFolder <MailboxFolderIdParameter>]
[-DomainController <Fqdn>]
[-Enabled <Boolean>]
[-ExceptIfFlagged <Boolean>]
[-ExceptIfPinned <Boolean>]
[-KeepForDays <Int32>]
[-KeepLatest <Int32>]
[-Mailbox <MailboxIdParameter>]
[-Sender <RecipientIdParameter>]
[-SourceFolder <MailboxFolderIdParameter>]
[-SystemCategory <SystemCategoryType>]
[-WhatIf]
[<CommonParameters>] Descrizione
È 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-SweepRule -Name "From Michelle" -Mailbox "Felipe Apodaca" -Provider Exchange16 -Sender michelle@fabrikam.com -KeepLatest 1In questo esempio viene creata una nuova regola Sweep denominata "From Michelle" nella cassetta postale di Felipe Apodaca che mantiene il messaggio più recente dalla michelle@fabrikam.com cartella Posta in arrivo e sposta i messaggi meno recenti nella cartella Posta eliminata.
Esempio 2
New-SweepRule -Name "From Lila" -Mailbox "Felipe Apodaca" -Provider Exchange16 -Sender lila@fabrikam.com -KeepForDays 10In questo esempio viene creata una nuova regola Sweep denominata "From Lila" nella cassetta postale di Felipe Apodaca che sposta i messaggi dalla lila@fabrikam.com cartella Posta in arrivo precedenti a 10 giorni alla cartella Posta eliminata.
Esempio 3
New-SweepRule -Name "From Jeff" -Mailbox "Felipe Apodaca" -Provider Exchange16 -Sender jeffm@fabrikam.com -SourceFolder "Felipe:\Sent Items" -KeepForDays 10In questo esempio viene creata una nuova regola Sweep denominata "From Jeff" nella cassetta postale di Felipe Apodaca che sposta i messaggi dalla jeffm@fabrikam.com cartella Posta inviata precedenti a 10 giorni alla cartella Posta eliminata.
Parametri
-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 2016, Exchange Server 2019, Exchange Online |
-DestinationFolder
Il parametro DestinationFolder consente di specificare un'azione per la regola Sweep che sposta i messaggi nella cartella specificata. La sintassi è MailboxID:\ParentFolder[\SubFolder].
Per il valore di MailboxID, è 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)
I valori di esempio per questo parametro sono john@contoso.com:\Unimportant o John:\Inbox\Misc. Il valore predefinito è MailboxID:\Deleted Items.
| Type: | MailboxFolderIdParameter |
| 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 |
-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 2016, Exchange Server 2019 |
-Enabled
Il parametro Enabled consente di specificare se la regola di organizzazione è abilitata o disabilitata. I valori validi sono:
- $true: la regola è abilitata. Questo è il valore predefinito.
- $false: la regola è disabilitata.
Dopo aver creato la regola, è possibile abilitare o disabilitarla utilizzando i cmdlet Enable-SweepRule e Disable-SweepRule.
| Type: | Boolean |
| 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 |
-ExceptIfFlagged
Il parametro ExceptIfFlagged consente di specificare un'eccezione per la regola di organizzazione che cerca i messaggi cui è applicato un contrassegno. I valori validi sono:
- $true: l'azione della regola non viene applicata ai messaggi a cui è applicato un flag di messaggio.
- $false: l'eccezione non viene usata.
I valori del contrassegno dei messaggi sono:
- Qualsiasi
- Chiamare
- DoNotForward
- Followup
- ForYourInformation
- Inoltra
- NoResponseNecessary
- Lettura
- Rispondi
- ReplyToAll
- Revisione
| Type: | Boolean |
| 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 |
-ExceptIfPinned
Il parametro PinMessage specifica un'eccezione per la regola di organizzazione che cerca i messaggi bloccati. I valori validi sono:
- $true: l'azione della regola non viene applicata ai messaggi aggiunti all'inizio della posta in arrivo.
- $false: l'eccezione non viene usata.
| Type: | Boolean |
| 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 |
-KeepForDays
Il parametro KeepForDays specifica un'azione per la regola Sweep che specifica il numero di giorni per mantenere i messaggi che corrispondono alle condizioni della regola. Trascorso il numero di giorni, i messaggi vengono spostati nel percorso specificato dal parametro DestinationFolder (per impostazione predefinita, la cartella Elementi eliminati).
Non è possibile usare questo parametro con il parametro KeepLatest e la regola Sweep deve contenere un valore di parametro KeepForDays o KeepLatest.
| Type: | Int32 |
| 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 |
-KeepLatest
Il parametro KeepLatest consente di specificare un'azione per la regola Sweep che specifica il numero di messaggi da mantenere corrispondenti alle condizioni della regola. Dopo che il numero di messaggi viene superato, i messaggi meno recenti vengono spostati nel percorso specificato dal parametro DestinationFolder (per impostazione predefinita, la cartella Elementi eliminati).
Non è possibile usare questo parametro con il parametro KeepForDays e la regola Sweep deve contenere un valore di parametro KeepForDays o KeepLatest.
| Type: | Int32 |
| 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 |
-Mailbox
Il parametro Mailbox consente di specificare la cassetta postale in cui creare la regola di organizzazione. È 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: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Name
Il parametro Name consente di specificare il nome della regola di organizzazione. Se il valore contiene spazi è necessario racchiuderlo tra virgolette.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Provider
Il parametro Provider specifica il provider per la regola Sweep. Se il valore contiene spazi è necessario racchiuderlo tra virgolette.
Per le regole sweep create in Outlook sul web, il valore predefinito è Exchange16.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Sender
Il parametro Sender specifica una condizione per la regola di organizzazione che cerca il mittente specificato nei messaggi. Per i mittenti interni, è possibile utilizzare qualsiasi valore che identifichi il mittente in maniera univoca. Ad esempio:
- Nome
- Alias
- Nome distinto (DN)
- Nome distinto (DN)
- Nome distinto canonico
- GUID
Per i mittenti esterni, usare il relativo indirizzo di posta elettronica.
| Type: | RecipientIdParameter |
| 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 |
-SourceFolder
Il parametro SourceFolder specifica una condizione per la regola Sweep che cerca i messaggi nella cartella specificata. La sintassi è MailboxID:\ParentFolder[\SubFolder].
Per il valore di MailboxID, è 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)
I valori di esempio per questo parametro sono john@contoso.com:\Marketing o John:\Inbox\Reports. Il valore predefinito è MailboxID:\Inbox.
| Type: | MailboxFolderIdParameter |
| 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 |
-SystemCategory
Il parametro SystemCategory specifica una condizione per la regola di sweep che cerca i messaggi con la categoria di sistema specificata. Le categorie di sistema sono disponibili in tutte le cassette postali nell'organizzazione. I valori validi sono:
- NotDefined
- Bollette
- Documento
- DocumentPlus
- Evento
- Famiglia
- File
- Volo
- FromContact
- Importante
- Liveview
- Alloggio
- Mailinglist
- Newsletter
- Foto
- Acquista
- RentalCar
- RestaurantReservation
- RetiredPromotion
- ShippingNotification
- Shopping
- SocialUpdate
- Viaggio
- Video
| Type: | SystemCategoryType |
| 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 |
-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 2016, Exchange Server 2019, Exchange Online |
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per