Test-ApplicationAccessPolicy

  • リファレンス
モジュール:
ExchangePowerShell
適用対象:
Exchange Online, Exchange Online Protection

このコマンドレットは、クラウドベースのサービスでのみ使用できます。

Test-ApplicationAccessPolicy コマンドレットを使用して、特定のユーザー/メールボックスへのアプリケーションのアクセス権をテストします。

以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。

構文

Test-ApplicationAccessPolicy
    [-Identity] <RecipientIdParameter>
    -AppId <String>
    [<CommonParameters>]

説明

この機能は、Outlook リソースのMicrosoft Graph APIに接続するアプリにのみ適用されます。

このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。

例

例 1

Test-ApplicationAccessPolicy -Identity "Engineering Staff" -AppID 3dbc2ae1-7198-45ed-9f9f-d86ba3ec35b5

次の使用例は、グループ "Engineering Staff" の指定されたアプリへのアクセスをテストします。

例 2

Test-ApplicationAccessPolicy -Identity RandomUser9911@AppPolicyTest2.com -AppId e7e4dbfc-046-4074-9b3b-2ae8f144f59b

次の使用例は、指定したアプリのユーザー RandomUser9911@AppPolicyTest2.com へのアクセスをテストします。

パラメーター

-AppId

Identity パラメーターは、テストするアプリの GUID を指定します。 アプリの GUID 値を確認するには、コマンド Get-App | Format-Table -Auto DisplayName,AppId を実行します。

複数のアプリ GUID 値をコンマで区切って指定できます。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-Identity

Identity パラメーターは、テストする受信者を指定します。 受信者を一意に識別する任意の値を使用できます。 たとえば、次の値を使用できます。

  • 名前
  • 名前
  • 識別名 (DN)
  • 電子メール アドレス
  • GUID
Type:RecipientIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection