Get-InboxRule
內部部署 Exchange 和雲端式服務有提供此 Cmdlet。 有些參數和設定可能是某一個環境所專屬。
使用 Get-InboxRule Cmdlet 來檢視收件匣規則屬性。 收件匣規則是根據指定的條件來處理收件匣中的訊息，並採取動作，例如將訊息移至指定的資料夾或刪除訊息。
如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。
Syntax
Get-InboxRule
[[-Identity] <InboxRuleIdParameter>]
[-BypassScopeCheck]
[-DescriptionTimeFormat <String>]
[-DescriptionTimeZone <ExTimeZoneValue>]
[-DomainController <Fqdn>]
[-IncludeHidden]
[-Mailbox <MailboxIdParameter>]
[-SweepRules]
[<CommonParameters>] Description
您必須已獲指派權限，才能執行此指令程式。 雖然本主題已列出這個指令程式的所有參數，不過，如果某些參數並未包含在指派給您的權限中，您可能就無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。
注意：此 Cmdlet 不適用於 Exchange Online 中View-Only組織管理角色群組的成員或 Azure Active Directory 中的全域讀取者角色。
範例
範例 1
Get-InboxRule -Mailbox Joe@Contoso.com此範例會擷取信箱 的所有收件匣 Joe@Contoso.com 規則。
範例 2
Get-InboxRule "ReceivedLastYear" -Mailbox joe@contoso.com -DescriptionTimeFormat "mm/dd/yyyy" -DescriptionTimeZone "Pacific Standard Time"此範例會從建立規則時設定 ReceivedBeforeDate 參數的信箱 joe@contoso.com 擷取收件匣規則 ReceivedLastYear。 在此範例中，會使用 DescriptionTimeFormat 和 DescriptionTimeZone 參數來指定時間格式，以及規則的 Description 屬性中使用的時區。
參數
-BypassScopeCheck
BypassScopeCheck 參數會指定是否要略過執行命令之使用者的範圍檢查。 您不需要使用此參數指定值。
| Type: | SwitchParameter |
| 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 |
-DescriptionTimeFormat
DescriptionTimeFormat 參數會指定規則描述中時間值的格式。 例如：
mm/dd/yyyy，其中 mm 是 2 位數的月份，dd 是 2 位數的日期，而 yyyy 是 4 位數的年份。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-DescriptionTimeZone
DescriptionTimeZone 參數會指定用於規則描述中時間值的時區。
$false：停用規則或原則。
若要查看可用的值，請執行下列命令： $TimeZone = Get-ChildItem "HKLM:\Software\Microsoft\Windows NT\CurrentVersion\Time zones" | foreach {Get-ItemProperty $_.PSPath}; $TimeZone | sort Display | Format-Table -Auto PSChildname,Display 。
如果值包含空格，請使用引號 (") 括住值。 預設值是 Exchange Server 的時區設定。
| Type: | ExTimeZoneValue |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, 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 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Identity
Identity 參數會指定您想要檢視的收件匣規則。 您可以使用唯一識別規則的任何值。 例如：
- 名稱
- RuleIdentity 屬性 (例如，16752869479666417665) 。
- Exchange Online：
MailboxAlias\RuleIdentity(例如，rzaher\16752869479666417665) 。 - 內部部署 Exchange：
MailboxCanonicalName\RuleIdentity(例如，contoso.com/Users/Rick Zaher\16752869479666417665) 。
| Type: | InboxRuleIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-IncludeHidden
IncludeHidden 參數會指定是否要在結果中包含隱藏的收件匣規則。 您不需要使用此參數指定值。
| 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, 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 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-SweepRules
此參數僅適用於內部部署 Exchange。
SweepRules 參數會指定是否只傳回結果中的掃掠規則。 您不需要使用此參數指定值。
掃掠規則會定期執行，以協助保持收件匣乾淨。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019 |
輸入
Input types
若要查看此指令程式可接受的輸入類型，請參閱指令程式輸入和輸出類型。 如果指令程式的 [輸入類型] 欄位是空的，表示指令程式不接受輸入資料。
輸出
Output types
若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型)，請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的，表示指令程式不會傳回資料。