Get-SweepRule

リファレンス

モジュール:: ExchangePowerShell

適用対象:: Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

このコマンドレットは、オンプレミスの Exchange およびクラウドベースのサービスで使用できます。一部のパラメーターおよび設定は、いずれかの環境専用となっている場合があります。

Get-SweepRule コマンドレットを使用して、メールボックスのスイープルールを表示します。スイープルールは、受信トレイをクリーンに保つために定期的に実行されます。

以下の構文セクションのパラメーターセットの詳細については、「Exchangeのコマンドレット構文」を参照してください。

構文

Get-SweepRule
   [[-Identity] <SweepRuleIdParameter>]
   [-BypassScopeCheck]
   [-DomainController <Fqdn>]
   [-Mailbox <MailboxIdParameter>]
   [-Provider <String>]
   [<CommonParameters>]

説明

このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。

例

例 1

Get-SweepRule

この例では、すべてのスイープルールの要約リストを返します。

例 2

Get-SweepRule -Mailbox julia@contoso.com

この例では、指定したメールボックス内のすべてのスイープルールの要約リストを返します。

例 3

Get-SweepRule -Identity "x2hlsdpGmUifjFgxxGIOJw=="

この例では、指定した RuleId プロパティの値を持つスイープルールの詳細情報を返します。

パラメーター

-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, Exchange Online Protection

-DomainController

このパラメーターは、オンプレミスの Exchange でのみ使用できます。

DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは 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

-Identity

Identity パラメーターは、表示するスイープルールを指定します。ルールを一意に識別する任意の値を使用できます。次に例を示します。

RuleId プロパティ (例: x2hlsdpGmUifjFgxxGIOJw==)。
Exchange Online: MailboxAlias\RuleID (例: rzaher\2hlsdpGmUifjFgxxGIOJw==)。
オンプレミス Exchange: MailboxCanonicalName\RuleID (例: contoso.com/Users/Rick Zaher\x2hlsdpGmUifjFgxxGIOJw==)。

Type:	SweepRuleIdParameter
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Mailbox

Mailbox パラメーターは、指定されたメールボックスで結果をフィルター処理します。メールボックスを一意に識別する任意の値を使用できます。次に例を示します。

名前
Alias
識別名 (DN)
正規 DN
Domain\Username
電子メールアドレス
GUID
LegacyExchangeDN
SamAccountName
ユーザー ID またはユーザープリンシパル名 (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, Exchange Online Protection

-Provider

Provider パラメーターは、指定されたプロバイダーで結果をフィルター処理します。

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, Exchange Online Protection