En utilisant PowerShell, comment obtenir les autorisations d'une document à partir de…
- User
En utilisant PowerShell, comment obtenir les autorisations d'une document à partir de son URL sachant que je suis déjà connecté au sites?
- Assistant
Pour obtenir les autorisations d'un document à partir de son URL en utilisant PowerShell, vous pouvez utiliser le module PnP PowerShell (PowerShell pour SharePoint). Voici les étapes détaillées :
Étapes requises
-
Installer le module PnP PowerShell (si ce n'est pas déjà fait) :
Install-Module -Name PnP.PowerShell -Scope CurrentUser -
Connecter-vous à votre site SharePoint (si ce n'est pas déjà fait) :
Connect-PnPOnline -Url "https://votre-tenant.sharepoint.com/sites/votre-site" -InteractiveL'option
-Interactivevous demande de vous authentifier via un navigateur. -
Obtenir l'élément (fichier) à partir de son URL :
$file = Get-PnPFile -Url "https://votre-tenant.sharepoint.com/sites/votre-site/chemin/vers/votre-fichier.docx" -AsFile -
Récupérer les autorisations de l'élément :
$permissions = Get-PnPItemPermission -Item $file -
Afficher les autorisations :
$permissions | Format-List
Exemple complet
# Installer le module PnP PowerShell (si nécessaire) # Install-Module -Name PnP.PowerShell -Scope CurrentUser # Connecter au site Connect-PnPOnline -Url "https://votre-tenant.sharepoint.com/sites/votre-site" -Interactive # Récupérer le fichier à partir de son URL $file = Get-PnPFile -Url "https://votre-tenant.sharepoint.com/sites/votre-site/chemin/vers/votre-fichier.docx" -AsFile # Obtenir les autorisations de l'élément $permissions = Get-PnPItemPermission -Item $file # Afficher les autorisations $permissions | Format-List
Explications
Get-PnPFile: Récupère le fichier à partir de son URL. L'option-AsFileretourne un objet de typeFile.Get-PnPItemPermission: Obtenir les autorisations de l'élément (fichier ou liste).Format-List: Affiche les autorisations sous forme lisible (utilisateurs, groupes, rôles).
Cas particuliers
- Si le fichier est dans une bibliothèque de documents : Assurez-vous que le nom de la bibliothèque est correct (ex.
"Documents"). - Si l'héritage des autorisations est cassé : Les autorisations affichées seront propres au fichier.
- Si vous avez besoin de l'ID de l'élément : Utilisez
Get-PnPListItemavec l'URL du fichier.
Alternative avec REST API (si besoin)
Si vous préférez utiliser l'API REST directement (sans PnP), voici un exemple :
$siteUrl = "https://votre-tenant.sharepoint.com/sites/votre-site" $fileUrl = "https://votre-tenant.sharepoint.com/sites/votre-site/chemin/vers/votre-fichier.docx" $restUrl = "$siteUrl/_api/web/GetFileByServerRelativeUrl('$fileUrl')/ListItemAllFields" $headers = @{ "Accept" = "application/json;odata=verbose" } $response = Invoke-RestMethod -Uri $restUrl -Headers $headers -Method Get -UseDefaultCredentials $itemId = $response.d.Id # Obtenir les autorisations via une autre requête REST $permissionsUrl = "$siteUrl/_api/web/lists/getbytitle('Documents')/items($itemId)/roleassignments" $permissionsResponse = Invoke-RestMethod -Uri $permissionsUrl -Headers $headers -Method Get -UseDefaultCredentials $permissionsResponse.d.results
Remarques
- Assurez-vous d'avoir les droits nécessaires pour accéder aux autorisations.
- Le module PnP PowerShell est idéal pour les opérations courantes sur SharePoint Online.
-
Other models, same or similar prompt
Responses were produced in different, uncontrolled contexts (system prompts, settings, prior turns). This is not a benchmark.