Find-EntraPermission
Aide les utilisateurs à déterminer les autorisations nécessaires pour les ressources et à identifier les autorisations appropriées requises pour différentes commandes.
Syntaxe
Search
Find-EntraPermission
[-SearchString] <String>
[-ExactMatch]
[-PermissionType <String>]
[-Online]
[<CommonParameters>]
All
Find-EntraPermission
[-PermissionType <String>]
[-Online]
[-All]
[<CommonParameters>]
Description
L’applet Find-EntraPermission de commande permet aux utilisateurs de déterminer les autorisations nécessaires pour les ressources et d’identifier les autorisations appropriées requises pour différentes commandes.
Exemples
Exemple 1 : Obtenir la liste de toutes les autorisations d’application
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...
Exemple 2. Obtenir la liste des autorisations pour les autorisations en lecture
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.
Exemple 3. Rechercher des autorisations avec une correspondance exacte
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.
Cet exemple montre comment rechercher des autorisations qui correspondent exactement à un nom d’autorisation spécifié.
Exemple 4. Obtenir toutes les autorisations du type spécifié
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,
Cet exemple montre comment obtenir toutes les autorisations d’un type spécifié, par exemple Delegated , ou Application des autorisations.
Paramètres
-All
Définit si l’applet de commande retourne tous les paramètres.
Propriétés du paramètre
| Type: | System.Management.Automation.SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ExactMatch
Définit si la chaîne de recherche doit correspondre exactement.
Propriétés du paramètre
| Type: | System.Management.Automation.SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Online
Utilisez le paramètre -Online avec -SearchString dans Find-MgGraphPermission pour extraire les autorisations les plus récentes de Microsoft Graph avant de rechercher. Cela garantit que Find-MgGraphPermission retourne des résultats précis en incluant les nouvelles autorisations ajoutées pour les API récentes. La commande utilise la connexion Microsoft Graph existante établie par Connect-MgGraph. Si votre connexion ne dispose pas des autorisations nécessaires pour accéder à ces données ou s’il n’y a pas de connectivité réseau, la commande échoue. Une fois mis à jour, Find-MgGraphPermission continuera à utiliser la liste d’autorisations actualisée pour les recherches futures, même sans le paramètre -Online.
Propriétés du paramètre
| Type: | System.Management.Automation.SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-PermissionType
Spécifie le type d’autorisation, par exemple Délégué ou Application.
Propriétés du paramètre
| Type: | System.String |
| Valeur par défaut: | Any |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-SearchString
Spécifie le filtre pour les autorisations, par exemple, domaine et étendue.
Propriétés du paramètre
| Type: | System.String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.