New command: site apppermission list

[fthorild]

Usage

spo site apppermission list [options]

Description

Lists the AAD applications granted permission to a SharePoint site collection.

Options

Option	Description
-u, --siteUrl <siteUrl>	The site collection url
-i, --appId [appId]	App Id
-n, --appDisplayName [appDisplayName]	App display name
-o, --output [output]	Output type. json,text. Default text
--verbose	Runs command with verbose logging
--debug	Runs command with debug logging

Remarks

Pass in appId and/or addDisplayName to filter by that app

Grah api docs

https://docs.microsoft.com/en-us/graph/api/site-list-permissions?view=graph-rest-1.0&tabs=http

Initial spec discussion: #2169

[waldekmastykarz]

Looking at the spec again, I wonder if it won't be confusing with regular user and group permissions you can configure on a site and if we shouldn't disambiguate these commands by adding app to it, like spo site apppermission list. What do you think?

[fthorild]

Oh that is very true - too focused on apps and the new fresh Sites.Selected I guess. What we actually discuss is to retrieve "grantedToIdentities" of type "application". "grantedToIdentities" can also be other things such as user, at least when you fire off /permissions on an item/document.

I have seen no samples where you on sites get back anything but application. Tried it out by sharing the site to an external user which does not show in the response when I do /permissions on the site object.

Bottom line, I am all for changing the noun to apppermission to be on the safe and least confusing side. Let me know and I'll update across the board. Also was my short suggestions OK? -i, --appId and -n, --appDisplayName

[waldekmastykarz]

Shall we go with spo site apppermission list then? --appId and --appDisplayName are good to make it clear which ID and name we expect

[fthorild]

Yes, let's do it 💪👍- I'll update the issues

[waldekmastykarz]

Let's use -u as the short option for site to align with other commands. Other than that, let's get it in! Thank you for writing the spec! 👏

[fthorild]

🙋‍♂️ I'd be happy to give this a go

[waldekmastykarz]

Awesome! Appreciate your help 👏