Set-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 Set-SweepRule per modificare le regole di organizzazione nelle cassette postali.

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

Sintassi

Set-SweepRule
   [-Identity] <SweepRuleIdParameter>
   [-Confirm]
   [-DestinationFolder <MailboxFolderIdParameter>]
   [-DomainController <Fqdn>]
   [-Enabled <Boolean>]
   [-ExceptIfFlagged <Boolean>]
   [-ExceptIfPinned <Boolean>]
   [-KeepForDays <Int32>]
   [-KeepLatest <Int32>]
   [-Mailbox <MailboxIdParameter>]
   [-Name <String>]
   [-Provider <String>]
   [-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

Set-SweepRule -Identity x2hlsdpGmUifjFgxxGIOJw== -KeepForDays 15 -ExceptIfPinned $true

In questo esempio viene modificata la regola esistente con il valore id regola x2hlsdpGmUifjFgxxGIOJw== con il valore specificato.

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

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

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

-Identity

Il parametro Identity consente di specificare la regola di organizzazione che si desidera modificare. È possibile utilizzare qualsiasi valore che identifichi la regola in modo univoco. Ad esempio:

  • Proprietà RuleId (ad esempio, x2hlsdpGmUifjFgxxGIOJw==).
  • Exchange Online: MailboxAlias\RuleID (ad esempio, rzaher\2hlsdpGmUifjFgxxGIOJw==).
  • Exchange locale: MailboxCanonicalName\RuleID (ad esempio, contoso.com/Users/Rick Zaher\x2hlsdpGmUifjFgxxGIOJw==).

È possibile ottenere questi valori di identità utilizzando il cmdlet Get-SweepRule.

Type:SweepRuleIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
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 utilizzare questo parametro con il parametro KeepLatest e la regola di organizzazione deve contenere un valore 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 utilizzare questo parametro con il parametro KeepForDays e la regola di organizzazione deve contenere un valore 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 indica la cassetta postale contenente la regola che si desidera modificare. È 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:Named
Default value:None
Required:False
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:False
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