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、Exchange Online Protection
BypassAdditionalDomainValidation スイッチは、コマンドが外部 Exchange organizationからのドメインの検証をスキップすることを指定します。 このスイッチで値を指定する必要はありません。
このスイッチを使用して、オンプレミスとExchange Online組織間のハイブリッド展開のフェデレーション情報のみを取得することをお勧めします。 このスイッチを使用して、クロスorganization配置でオンプレミスの Exchange 組織のフェデレーション情報を取得しないでください。
パラメーターのプロパティ
| 型: | 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、Exchange Online Protection
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、Exchange Online Protection
[強制] スイッチは、警告メッセージまたは確認メッセージを非表示にします。 このスイッチで値を指定する必要はありません。
ドメインの自動検出エンドポイントのホスト名が、エンドポイントによって提示される Secure Sockets Layer (SSL) 証明書と一致せず、ホスト名が 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、Exchange Online Protection
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
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。