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 とコールバック トークンが含まれます。
重要:
- 現時点では、AllowLegacyExchangeTokens スイッチは、organizationでレガシ Exchange トークンを許可するかどうかを指定するだけです。 ここでは、スイッチによって返される空の Allowed 配列と Blocked 配列は無視してください。
- レガシ Exchange トークンは、最終的にすべてのクラウドベースの組織で既定でブロックされます。 詳細については、「 入れ子になったアプリ認証」と「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 |