spo tenant appcatalog add¶
Creates new tenant app catalog site
Usage¶
m365 spo tenant appcatalog add [options]
Options¶
-u, --url <url>
- The absolute site url
--owner <owner>
- The account name of the site owner
-z, --timeZone <timeZone>
- Integer representing time zone to use for the site
--wait
- Wait for the site to be provisioned before completing the command
--force
- Force creating a new app catalog site if one already exists
-h, --help [help]
- Output usage information. Optionally, specify which section of command's help you want to see. Allowed values are
options
,examples
,remarks
,response
,full
. Default isfull
. --query [query]
- JMESPath query string. See http://jmespath.org/ for more information and examples
-o, --output [output]
- Output type.
json,text,csv,md
. Defaultjson
--verbose
- Runs command with verbose logging
--debug
- Runs command with debug logging
Remarks¶
If there is an app catalog registered in your tenant, creating a new app catalog using this command will fail, unless you use the force
option.
If you use the force
option, and either the app catalog or the site at the specified URL exists (or both), this command will delete both sites bypassing the recycle bin.
Creating an app catalog site might take a while. If you need to wait for the site to be created before continuing, use the wait
option.
Important
To use this command you have to have permissions to access the tenant admin site.
Examples¶
Creates new app catalog. Will fail if another app catalog or site at the specified URL exists
m365 spo tenant appcatalog add --url https://contoso.sharepoint.com/sites/apps --owner admin@contoso.com --timeZone 4
Creates new app catalog and waits for completion. Will fail if another app catalog or site at the specified URL exists
m365 spo tenant appcatalog add --url https://contoso.sharepoint.com/sites/apps --owner admin@contoso.com --timeZone 4 --wait
Creates new app catalog and deletes existing app catalog and existing site at the specified URL
m365 spo tenant appcatalog add --url https://contoso.sharepoint.com/sites/apps --owner admin@contoso.com --timeZone 4 --force