Add Office 365 CLI Setup script

[garrytrinder]

Provide an option for users on non Windows systems to be able to setup the Studio in their tenant.

[garrytrinder]

Happy to help out with this one 👍🏻

[ypcode]

Hello Garry,

I gave it a short try a few weeks ago... but I am definitely not as proficient in bash as in PowerShell. I will push what I already have done. A helping help would indeed be really appreciated :)

Kind regards Yannick

[ypcode]

I will do even better and provide a working PowerShell script using the CLI, then it would be awesome if you can give the translation in bash :)

[garrytrinder]

Sounds like a deal 👍🏻😁

[garrytrinder]

So I was thinking, we could create a script using CLI commands or instead we could look to add a specialist command in the CLI for the setup of this project. Thoughts?

[ypcode]

Hi @garrytrinder, I think the existing commands should be sufficient. On the other hand, dedicated commands would make it more "promoted" but I don't want to ask you too much effort on this :)

What do you think? I will work on the PowerShell script tomorrow.

[garrytrinder]

Looking at the script you have for PowerShell, looks like we need a script to replicate the following

• [ ] Add package to tenant App Catalog
• [ ] Add WebApiPermissions to Microsoft Graph
• [ ] Create Communication Site
• [ ] Deploy app to site
• [ ] Create Page sds2.aspx
• [ ] Set page as welcome page
• [ ] Add web part to page
• [ ] Create list
• [ ] Break permission inheritance on list
• [ ] Add unique permissions
• [ ] Add links to Global Navigation

Does that cover it all?

[ypcode]

I think that's it. Take care that it should set the permissions on the preview image library to "everyone except externals" I don't know if there an option in the CLI for that?

[garrytrinder]

Thanks for clarifying.

If we are missing commands then we can can build them 👍🏻

[ypcode]

Hi @garrytrinder,

I am writing, as promised, the PowerShell version of the o365 CLI setup script and Indeed some features might be missing (or I am just not sure what command to use if there is one...

The "missing" features would be:

• add the permissions for the SPFx app e.g. in the PnP Tenant Template, what is corresponding:

        <pnp:WebApiPermissions>
            <pnp:WebApiPermission Resource="Microsoft.Graph" Scope="Directory.AccessAsUser.All"/>
        </pnp:WebApiPermissions>

• set permissions to the preview images list to everyone except external users

<pnp:Security>
    <pnp:BreakRoleInheritance CopyRoleAssignments="false" ClearSubscopes="false">
        <pnp:RoleAssignment Principal="{associatedmembergroupid}" RoleDefinition="Contribute"/>
        <pnp:RoleAssignment Principal="c:0-.f|rolemanager|spo-grid-all-users/{parameter:TenantId}" RoleDefinition="Read"/>
    </pnp:BreakRoleInheritance>
</pnp:Security>

Your wisdom would be really appreciated here :)

[ypcode]

Hi @garrytrinder , I pushed a draft of the PS1 setup script using the CLI It is here on the dev branch: https://github.com/pnp/sp-site-designs-studio/blob/dev/setup/o365cli/setup-0365.ps1

Related to my previous comment, the are 2 missing steps so far, and it was not really tested, I pushed it only for reference so far. :)

Regards, Yannick

[garrytrinder]

Thanks @ypcode

Let me create some issues in the CLI repo to cover the missing commands to progress.