Get-FederationInformation
このコマンドレットは、オンプレミスの Exchange およびクラウド ベースのサービスで使用できます。 一部のパラメーターと設定は、1 つの環境または別の環境に限定される場合があります。
Get-FederationInformation コマンドレットを使用して、外部の Exchange organizationからフェデレーション情報を取得します。
ヒント
セキュリティとプライバシーを向上させるために Get-FederationInformation コマンドレットに加えられた変更については、「Exchange Online の Get-FederationInformation コマンドレットの重要な更新」を参照してください。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Default (既定)
Get-FederationInformation
-DomainName <SmtpDomain>
[-BypassAdditionalDomainValidation]
[-Force]
[-TrustedHostnames <MultiValuedProperty>]
[<CommonParameters>]
説明
Get-FederationInformation コマンドレットは、指定されたドメインからフェデレーション情報を取得します。このドメインではフェデレーションが有効になっている必要があります。
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 この記事にはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
例
例 1
Get-FederationInformation -DomainName contoso.com
この例では、contoso.com ドメインからフェデレーション情報を取得します。
パラメーター
-BypassAdditionalDomainValidation
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、オンプレミス用の組み込みセキュリティ アドオンメールボックス
BypassAdditionalDomainValidation スイッチは、コマンドが外部 Exchange organization からのドメインの検証をスキップすることを指定します。 このスイッチで値を指定する必要はありません。
このスイッチは、オンプレミス組織と Exchange Online 組織間のハイブリッド展開でフェデレーション情報を取得する場合にのみ使用することをお勧めします。 このスイッチを使用して、組織間の配置でオンプレミスの Exchange 組織のフェデレーション情報を取得しないでください organization。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DomainName
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、オンプレミス用の組み込みセキュリティ アドオンメールボックス
DomainName パラメーターには、取得するフェデレーション情報のドメイン名を指定します。
パラメーターのプロパティ
| 型: | SmtpDomain |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Force
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、オンプレミス用の組み込みセキュリティ アドオンメールボックス
[強制] スイッチは、警告または確認メッセージを非表示にします。 このスイッチで値を指定する必要はありません。
ドメインの自動検出エンドポイントのホスト名が、エンドポイントによって提示されたトランスポート層セキュリティ (TLS) 証明書と一致せず、ホスト名が TrustedHostnames パラメーターで指定されていない場合、確認プロンプトによって警告が表示されます。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-TrustedHostnames
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、オンプレミス用の組み込みセキュリティ アドオンメールボックス
TrustedHostnames パラメーターには、フェデレーション エンドポイントの完全修飾ドメイン名 (FQDN) を指定します。 フェデレーション エンドポイントは、フェデレーションが有効な組織内のメールボックス サーバー上のクライアント アクセス (フロントエンド) サービスです。 TrustedHostnames パラメーターを明示的に指定すると、エンドポイントによって提示された証明書が、DomainName パラメーターの中で指定されたドメイン名と一致しない場合に、コマンドレットがプロンプトを表示しなくなります。
パラメーターのプロパティ
| 型: | MultiValuedProperty |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、「about_CommonParameters」を参照してください。
入力
Input types
このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。
出力
Output types
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。