Skip to content

New command: spo tenant applicationcustomizer set #4266

@martinlingstuyl

Description

@martinlingstuyl

Usage

spo tenant applicationcustomizer set

Description

Update an application customizer that's deployed as a tenant wide extension.

Options

Option Description
-t, --title [title] The title of the Application Customizer to update. Specify either title, id or clientSideComponentId.
-i, --id [id] The id of the Application Customizer to update. Specify either title, id or clientSideComponentId.
-c, --clientSideComponentId [clientSideComponentId] The Client Side Component Id (GUID) of the Application Customizer to update. Specify either title, id or clientSideComponentId.
--newTitle [newTitle] The updated title of the Application Customizer
-p, --clientSideComponentProperties [clientSideComponentProperties] The Client Side Component properties of the application customizer.
--webTemplate [webTemplate] Optionally add a web template (e.g. STS#3, SITEPAGEPUBLISHING#0, etc) as a filter for what kind of sites the application customizer is registered on.

Examples

Updates the title of an application customizer that's deployed tenant wide

m365 spo tenant applicationcustomizer set --id 3 --newTitle "Some customizer" 

Updates the properties of an application customizer that is deployed tenant wide

m365 spo tenant applicationcustomizer set --id 5 --clientSideComponentProperties '{ "someProperty": "Some value" }'

Remarks

Add the following notice (like on https://pnp.github.io/cli-microsoft365/cmd/spo/customaction/customaction-add/)

Escaping JSON in PowerShell When using the --clientSideComponentProperties option it's possible to enter a JSON string. In PowerShell 5 to 7.2 specific escaping rules apply due to an issue. Remember that you can also use file tokens instead.

Additional Info

Some things to consider while building.

  • we need to update an item in the TenantWideExtensions list for this command. We can reuse the existing listitem set command for that.
  • We would need a note in the docs saying you need to be a SharePoint admin to deploy tenant wide.

Metadata

Metadata

Assignees

Type

No type

Projects

No projects

Milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions