Get-AuthenticationPolicy
このコマンドレットは、オンプレミスの Exchange およびクラウド ベースのサービスで使用できます。 一部のパラメーターおよび設定は、いずれかの環境専用となっている場合があります。
Get-AuthenticationPolicy コマンドレットを使用して、organizationの認証ポリシーを表示します。 以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Get-AuthenticationPolicy
[[-Identity] <AuthPolicyIdParameter>]
[-AllowLegacyExchangeTokens]
[-TenantId <String>]
[<CommonParameters>]
説明
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
例
例 1
Get-AuthenticationPolicy | Format-Table -Auto Name
この例では、すべての認証ポリシーの概要リストを返します。
例 2
Get-AuthenticationPolicy -Identity "Engineering Group"
次の使用例は、エンジニアリング グループという名前の認証ポリシーの詳細情報を返します。
例 3
Get-AuthenticationPolicy -AllowLegacyExchangeTokens
Exchange Onlineでは、この例では、Outlook アドインのレガシ Exchange トークンをorganizationで許可するかどうかを指定します。
パラメーター
-AllowLegacyExchangeTokens
このパラメーターは、クラウドベースのサービスでのみ使用できます。
AllowLegacyExchangeTokens スイッチは、organization内の Outlook アドインに従来の Exchange トークンを許可するかどうかを指定します。 このスイッチで値を指定する必要はありません。
従来の Exchange トークンには、Exchange ユーザー ID とコールバック トークンが含まれます。
重要:
-
Set-AuthenticationPolicy コマンドレットの AllowLegacyExchangeTokens パラメーターまたは BlockLegacyExchangeTokens パラメーターを使用して、organizationでトークンが明示的に許可またはブロックされていない場合、AllowLegacyExchangeTokens スイッチは
Not Set
を返します。 詳細については、「レガシ Exchange Online トークンとそれを使用するアドインの状態を取得する」を参照してください。 - 2025 年 2 月 17 日の時点で、従来の Exchange トークンは、すべてのクラウドベースの組織で既定でブロックされます。 トークンは既定ではブロックされますが、Set-AuthenticationPolicy コマンドレットで AllowLegacyExchangeTokens パラメーターまたは BlockLegacyExchangeTokens パラメーターを使用していない場合、AllowLegacyExchangeTokens スイッチは引き続き
Not Set
を返します。 詳細については、「 入れ子になったアプリ認証」と「Outlook レガシ トークンの非推奨に関する FAQ」を参照してください。
型: | SwitchParameter |
配置: | Named |
規定値: | True |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Online, Exchange Online Protection |
-Identity
Identity パラメーターは、表示する認証ポリシーを指定します。 ポリシーを一意に識別する任意の値を使用できます。 次に例を示します。
- 名前
- 識別名 (DN)
- GUID
型: | AuthPolicyIdParameter |
配置: | 0 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Server 2019, Exchange Online, Exchange Online Protection |
-TenantId
このパラメーターは、クラウドベースのサービスでのみ使用できます。
{{ Fill TenantId Description }}
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Online, Exchange Online Protection |