Get-TransportRule
このコマンドレットは、オンプレミスの Exchange およびクラウド ベースのサービスで使用できます。 一部のパラメーターおよび設定は、いずれかの環境専用となっている場合があります。
組織内のトランスポート ルール (メール フロー ルール) を表示するには、Get-TransportRule コマンドレットを使用します。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Get-TransportRule
[[-Identity] <RuleIdParameter>]
[-DomainController <Fqdn>]
[-State <RuleState>]
[-DlpPolicy <String>]
[-ExcludeConditionActionDetails <Boolean>]
[-Filter <String>]
[-ResultSize <Unlimited>]
[<CommonParameters>] 説明
メールボックス サーバーでは、このコマンドレットは、Active Directory に格納されている Exchange 組織内のすべてのルールを返します。 エッジ トランスポート サーバーでは、このコマンドレットはローカル サーバーで構成されている規則のみを返します。
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
例
例 1
Get-TransportRuleこの例では、組織内のすべてのルールの要約リストを返します。
例 2
Get-TransportRule "Ethical Wall - Sales and Brokerage Departments" | Format-Listこの例では、"Ethical Wall - Sales and Brokerage Departments" という名前のルールの詳細情報を返します。
パイプラインの詳細については、「 パイプラインについて」を参照してください。 コマンドの出力を操作する方法の詳細については、「コマンド出力の 操作」を参照してください。
例 3
Get-TransportRule -DlpPolicy "PII (U.S.)"この例では、組織で PII (U.S.) という DLP ポリシーを適用するために使用するルールの要約リストが返されます。
例 4
Get-TransportRule | Where {$_.DlpPolicy -ne $null}この例では、組織で DLP ポリシーを適用するために使用するすべてのルールの要約リストが返されます。
パラメーター
-DlpPolicy
DlpPolicy パラメーターは、指定されたデータ損失防止 (DLP) ポリシーの名前で結果をフィルター処理します。 値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。
組織の DLP ポリシーでは、秘匿性の高い情報を誤って開示してしまうことを防止できます。 各 DLP ポリシーは、一連のトランスポート ルールを使用して適用されます。
| Type: | String |
| 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 |
-DomainController
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメイン コントローラーを指定します。 ドメイン コントローラーは、完全修飾ドメイン名 (FQDN) で識別します。 たとえば、dc01.contoso.com です。
DomainController パラメーターは、エッジ トランスポート サーバーではサポートされません。 エッジ トランスポート サーバーは、Active Directory ライトウェイト ディレクトリ サービス (AD LDS) のローカル インスタンスを使用してデータの読み書きを行います。
| 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 |
-ExcludeConditionActionDetails
このパラメーターは、クラウドベースのサービスでのみ使用できます。
ExcludeConditionActionDetails パラメーターは、結果から特定の詳細を非表示にするかどうかを指定します。 有効な値は次のとおりです。
- $true: Description プロパティ、Conditions プロパティ、Actions プロパティ、および構成済みの条件、例外、およびアクション プロパティの値は空白です。
- $false: プロパティまたはプロパティ値は非表示です。 これは既定の値です。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-Filter
Filter パラメーターは、OPATH を使用して結果をフィルター処理します。 このパラメーターは、トランスポート ルールの条件、例外、アクション、関連値を含む Description プロパティを検索します。
このパラメーターには、構文 "Description -like 'Text*'" を使用します。 たとえば、「 "Description -like '192.168.1.1*'" 」のように入力します。
Exchange の OPATH フィルターの詳細については、「 その他の OPATH 構文情報」を参照してください。
| Type: | String |
| 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, Exchange Online Protection |
-Identity
Identity パラメーターは、表示するルールを指定します。 ルールを一意に識別する任意の値を使用できます。 次に例を示します。
- 名前
- 識別名 (DN)
- GUID
| Type: | RuleIdParameter |
| 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, Exchange Online Protection |
-ResultSize
ResultSize パラメーターは、返される結果の最大数を指定します。 クエリに一致するすべてのリクエストを返す場合は、このパラメーターの値に unlimited を使用します。 既定値は 1,000 です。
| Type: | Unlimited |
| 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, Exchange Online Protection |
-State
State パラメーターは、有効または無効になっているルールによって結果をフィルター処理します。 有効な値は次のとおりです。
- Enabled:有効になっているルールのみが結果で返されます。
- Disabled:無効になっているルールのみが結果で返されます。
このパラメーターを使用しない場合は、有効と無効の両方のルールがすべて返されます。
| Type: | RuleState |
| 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, Exchange Online Protection |
入力
Input types
このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。
出力
Output types
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。