Find-EntraPermission
ユーザーがリソースに必要なアクセス許可を決定し、さまざまなコマンドに必要な適切なアクセス許可を特定するのに役立ちます。
構文
Search
Find-EntraPermission
[-SearchString] <String>
[-ExactMatch]
[-PermissionType <String>]
[-Online]
[<CommonParameters>]
All
Find-EntraPermission
[-PermissionType <String>]
[-Online]
[-All]
[<CommonParameters>]
説明
Find-EntraPermission コマンドレットは、ユーザーがリソースに必要なアクセス許可を決定し、さまざまなコマンドに必要な適切なアクセス許可を識別するのに役立ちます。
例
例 1: すべてのアプリケーションアクセス許可の一覧を取得する
Find-EntraPermission application
PermissionType: Delegated
Id Consent Name Description
-- ------- ---- -----------
c79f8feb-a9db-4090-85f9-90d820caa0eb Admin Application.Read.All Allows the app to read applications and service principals on behalf of the signed-in user.
bdfbf15f-ee85-4955-8675-146e8e5296b5 Admin Application.ReadWrite.All Allows the app to create, read, update and delete applications and service principals on behalf of the signed-in user. Does not allow management of consent grants.
PermissionType: Application
Id Consent Name Description
-- ------- ---- -----------
9a5d68dd-52b0-4cc2-bd40-abcf44ac3a30 Admin Application.Read.All Allows the app to read all applications and service principals without a signed-in user.
1bfefb4e-e0b5-418b-a88f-73c46d2cc8e9 Admin Application.ReadWrite.All Allows the app to create, read, update and delete applications and service principals without a signed-in user. Does not allow management of consent grants.
18a4783c-866b-4cc7-a460-3d5e5662c884 Admin Application.ReadWrite.OwnedBy Allows the app to create other applications, and fully manage those applications (read, update, update application secrets and delete), without a signed-in user...
例 2. 読み取りアクセス許可のアクセス許可の一覧を取得する
Find-EntraPermission application.Read | Format-List
Id : c79f8feb-a9db-4090-85f9-90d820caa0eb
PermissionType : Delegated
Consent : Admin
Name : Application.Read.All
Description : Allows the app to read applications and service principals on behalf of the signed-in user.
Id : bdfbf15f-ee85-4955-8675-146e8e5296b5
PermissionType : Delegated
Consent : Admin
Name : Application.ReadWrite.All
Description : Allows the app to create, read, update and delete applications and service principals on behalf of the signed-in user. Does not allow management of consent grants.
Id : 9a5d68dd-52b0-4cc2-bd40-abcf44ac3a30
PermissionType : Application
Consent : Admin
Name : Application.Read.All
Description : Allows the app to read all applications and service principals without a signed-in user.
例 3. 完全に一致するアクセス許可を検索する
Find-EntraPermission -SearchString 'User.Read.All' -ExactMatch
PermissionType: Delegated
Id Consent Name Description
-- ------- ---- -----------
a154be20-db9c-4678-8ab7-66f6cc099a59 Admin User.Read.All Allows the app to read the full set of profile properties, reports, and ma…
PermissionType: Application
Id Consent Name Description
-- ------- ---- -----------
df021288-bdef-4463-88db-98f22de89214 Admin User.Read.All Allows the app to read user profiles without a signed in user.
この例では、指定したアクセス許可名と完全に一致するアクセス許可を検索する方法を示します。
例 4. 指定した型のすべてのアクセス許可を取得する
Find-EntraPermission -PermissionType 'Delegated'
Id Consent Name Description
-- ------- ---- -----------
ebfcd32b-babb-40f4-a14b-42706e83bd28 Admin AccessReview.Read.All Allows the app to read access re…
e4aa47b9-9a69-4109-82ed-36ec70d85ff1 Admin AccessReview.ReadWrite.All Allows the app to read, update, …
5af8c3f5-baca-439a-97b0-ea58a435e269 Admin AccessReview.ReadWrite.Membership Allows the app to read,
この例では、 Delegated や Application のアクセス許可など、指定した種類のすべてのアクセス許可を取得する方法を示します。
パラメーター
-All
コマンドレットがすべてのパラメーターを返すかどうかを設定します。
パラメーターのプロパティ
| 型: | System.Management.Automation.SwitchParameter |
| 規定値: | False |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ExactMatch
検索文字列が完全に一致するかどうかを設定します。
パラメーターのプロパティ
| 型: | System.Management.Automation.SwitchParameter |
| 規定値: | False |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Online
Find-MgGraphPermission の -SearchString と共に -Online パラメーターを使用して、検索する前にMicrosoft Graphから最新のアクセス許可をフェッチします。 これにより、Find-MgGraphPermission は、最近の API に追加された新しいアクセス許可を含めることで、正確な結果を返すことができます。 このコマンドは、Connect-MgGraph によって確立された既存のMicrosoft Graph接続を使用します。 接続にこのデータにアクセスするためのアクセス許可がない場合、またはネットワーク接続がない場合、コマンドは失敗します。 更新されると、Find-MgGraphPermission は、-Online パラメーターがなくても、今後の検索に更新されたアクセス許可リストを引き続き使用します。
パラメーターのプロパティ
| 型: | System.Management.Automation.SwitchParameter |
| 規定値: | False |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-PermissionType
アクセス許可の種類を指定します (たとえば、委任またはアプリケーション)。
パラメーターのプロパティ
| 型: | System.String |
| 規定値: | Any |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-SearchString
アクセス許可のフィルター (ドメインやスコープなど) を指定します。
パラメーターのプロパティ
| 型: | System.String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。