共用方式為

New-SweepRule

  • 參考
模組:
ExchangePowerShell
適用於:
Exchange Server 2016, Exchange Server 2019, Exchange Online

內部部署 Exchange 和雲端式服務有提供此 Cmdlet。 有些參數和設定可能是某一個環境所專屬。

使用 New-SweepRule Cmdlet 在信箱中建立掃掠規則。 掃掠規則會定期執行，以協助保持收件匣乾淨。

如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。

Syntax

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>]

Description

您必須已獲指派權限，才能執行此指令程式。 雖然本主題已列出這個指令程式的所有參數，不過，如果某些參數並未包含在指派給您的權限中，您可能就無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。

範例

範例 1

New-SweepRule -Name "From Michelle" -Mailbox "Felipe Apodaca" -Provider Exchange16 -Sender michelle@fabrikam.com -KeepLatest 1

此範例會在 Felipe Apodaca 的信箱中建立名為 「From 按下層」 的新掃掠規則，以將最新的郵件保留 michelle@fabrikam.com 在 [收件匣] 資料夾中，並將較舊的郵件移至 [刪除的郵件] 資料夾。

範例 2

New-SweepRule -Name "From Lila" -Mailbox "Felipe Apodaca" -Provider Exchange16 -Sender lila@fabrikam.com -KeepForDays 10

此範例會在 Felipe Apodaca 的信箱中建立名為 「From Lila」 的新掃掠規則，將郵件從 lila@fabrikam.com [收件匣] 資料夾中超過 10 天的郵件移至 [刪除的郵件] 資料夾。

範例 3

New-SweepRule -Name "From Jeff" -Mailbox "Felipe Apodaca" -Provider Exchange16 -Sender jeffm@fabrikam.com -SourceFolder "Felipe:\Sent Items" -KeepForDays 10

此範例會在 Felipe Apodaca 的信箱中建立名為 「From Jeff」 的新掃掠規則，將郵件從 jeffm@fabrikam.com [寄件人] 資料夾中超過 10 天的郵件移至 [刪除的郵件] 資料夾。

參數

-Confirm

Confirm 參數會指定要顯示或隱藏確認提示。 這個參數對 Cmdlet 的影響取決於 Cmdlet 是否需要確認才能繼續作業。

  • 例如，具破壞性的 Cmdlet (例如 Remove-* Cmdlet) 內建暫停，可強制您在繼續之前確認命令。 對於這些 Cmdlet，您可以使用以下確切語法來略過確認提示：-Confirm:$false。
  • 其他大部分的 Cmdlet (例如，New-* 和 Set-* Cmdlet) 沒有內建暫停。 在使用這些 Cmdlet 時，指定不含任何值的 Confirm 參數會引入強迫您認可命令後才繼續作業的暫停。
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

DestinationFolder 參數會指定將訊息移至指定資料夾之掃掠規則的動作。 語法為 MailboxID:\ParentFolder[\SubFolder] 。

針對 的 MailboxID 值，您可以使用可唯一識別信箱的任何值。 例如：

  • 名稱
  • 別名
  • 辨別名稱 (DN)
  • 辨別名稱 (DN)
  • Domain\Username
  • 電子郵件地址
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • 使用者識別碼或使用者主要名稱 (UPN)

此參數的範例值為 john@contoso.com:\Unimportant 或 John:\Inbox\Misc 。 預設值為 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

此參數僅適用於內部部署 Exchange。

DomainController 參數會指定此 Cmdlet 用來向 Active Directory 讀取或寫入資料的網域控制站。 您可以透過網域控制站的完整網域名稱 (FQDN) 來識別網域控制站。 例如，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

Enabled 參數會指定是否啟用或停用掃掠規則。 有效值為：

  • $true：已啟用規則。 這是預設值。
  • $false：已停用規則。

建立規則之後，您可以使用 Enable-SweepRule 和 Disable-SweepRule Cmdlet 來啟用或停用它。

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

ExceptIfFlagged 參數會指定掃掠規則的例外狀況，該規則會尋找已套用訊息旗標的訊息。 有效值為：

  • $true：規則動作不會套用至已套用訊息旗標的訊息。
  • $false：不使用例外狀況。

典型的訊息旗標值為：

  • 任何
  • 通話
  • DoNotForward
  • 隨訪
  • ForYourInformation
  • 轉寄
  • NoResponseNecessary
  • 讀取
  • 回覆
  • ReplyToAll
  • 檢閱
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

PinMessage 參數會指定尋找釘選訊息之掃掠規則的例外狀況。 有效值為：

  • $true：規則動作不會套用至釘選到 [收件匣] 頂端的訊息。
  • $false：不使用例外狀況。
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

KeepForDays 參數會指定掃掠規則的動作，指定保留符合規則條件之訊息的天數。 經過天數之後，訊息會移至 DestinationFolder 參數預設指定的位置， ([刪除的郵件] 資料夾) 。

您無法搭配 KeepLatest 參數使用此參數，而且掃掠規則必須包含 KeepForDays 或 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

KeepLatest 參數會指定掃掠規則的動作，指定要保留符合規則條件的訊息數目。 超過訊息數目之後，最舊的訊息會移至 DestinationFolder 參數預設 (指定的位置，[刪除的郵件] 資料夾) 。

您無法搭配 KeepForDays 參數使用此參數，且 Sweep 規則必須包含 KeepForDays 或 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

Mailbox 參數會指定您要在其中建立掃掠規則的信箱。 您可以使用可唯一識別信箱的任何值。 例如：

  • 名稱
  • 別名
  • 辨別名稱 (DN)
  • 辨別名稱 (DN)
  • Domain\Username
  • 電子郵件地址
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • 使用者識別碼或使用者主要名稱 (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

Name 參數會指定掃掠規則的名稱。 如果值包含空格，請使用引號括住值。

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

Provider 參數會指定掃掠規則的提供者。 如果值包含空格，請使用引號括住值。

針對您在 Outlook 網頁版 中建立的掃掠規則，預設值為 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

Sender 參數會指定掃掠規則的條件，以在訊息中尋找指定的寄件者。 針對外部寄件者，您可以使用唯一識別寄件者的任何值。 例如：

  • 名稱
  • 別名
  • 辨別名稱 (DN)
  • 辨別名稱 (DN)
  • 標準 DN
  • GUID

針對外部寄件者，請使用其電子郵件地址。

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

SourceFolder 參數會指定掃掠規則的條件，以在指定的資料夾中尋找訊息。 語法為 MailboxID:\ParentFolder[\SubFolder] 。

針對 的 MailboxID 值，您可以使用可唯一識別信箱的任何值。 例如：

  • 名稱
  • 別名
  • 辨別名稱 (DN)
  • 辨別名稱 (DN)
  • Domain\Username
  • 電子郵件地址
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • 使用者識別碼或使用者主要名稱 (UPN)

此參數的範例值為 john@contoso.com:\Marketing 或 John:\Inbox\Reports 。 預設值為 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

SystemCategory 參數會指定掃掠規則的條件，以尋找具有指定系統類別目錄的訊息。 系統類別可供組織中的所有信箱使用。 有效值為：

  • NotDefined
  • 條例 草案
  • 文件
  • DocumentPlus
  • 事件
  • 系列
  • 檔案
  • 飛行
  • FromContact
  • 重要事項
  • LiveView
  • 住宿
  • MailingList
  • 通訊
  • 照片
  • 購買
  • RentalCar
  • RestaurantReservation
  • RetiredPromotion
  • ShippingNotification
  • 購物
  • SocialUpdate
  • 旅行
  • 影片
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

WhatIf 參數會模擬命令的動作。 使用此參數時，您不需要實際套用變更即可檢視可能會發生的變更。 您不需要使用此參數指定值。

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