New-SweepRule

  • Riferimento
Modulo:
ExchangePowerShell
Si applica a:
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 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 1

In 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 10

In 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 10

In 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