Skip to content

Commit ed031bd

Browse files
authored
Merge pull request MicrosoftDocs#3382 from divyachapan/patch-6
Reformatting cmdlet file
2 parents 7d6baf6 + 06a87bd commit ed031bd

File tree

1 file changed

+58
-31
lines changed

1 file changed

+58
-31
lines changed

sharepoint/sharepoint-ps/sharepoint-online/Enable-SPOCommSite.md

Lines changed: 58 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -3,9 +3,9 @@ external help file: sharepointonline.xml
33
applicable: SharePoint Online
44
title: Enable-SPOCommSite
55
schema: 2.0.0
6-
author: DC Padur
6+
author: divyachapan
77
ms.author: dipadur
8-
ms.reviewer:
8+
ms.reviewer:
99
---
1010

1111
# Enable-SPOCommSite
@@ -14,6 +14,7 @@ ms.reviewer:
1414
## SYNOPSIS
1515
Enables the modern communication site experience on an existing site.
1616

17+
1718
## SYNTAX
1819

1920
```
@@ -39,6 +40,7 @@ Use this cmdlet to enable the modern communication site experience at the classi
3940
5. Site Pages will be the default content type in the Site Pages library
4041
6. No change in permissions or content in the root site
4142

43+
4244
## EXAMPLES
4345

4446
### Example 1
@@ -49,64 +51,89 @@ Enable-SPOCommSite -SiteUrl https://contoso.sharepoint.com
4951

5052
This example enables the communication site experience at this https://contoso.sharepoint.com site.
5153

54+
### Example 2
5255

53-
## PARAMETERS
54-
55-
### -SiteUrl
56-
57-
URL of the site for enabling the modern communication site experience.
58-
59-
### -DesignPackageId
60-
61-
GUID identifying the [communication site design](https://support.office.com/en-gb/article/what-is-a-sharepoint-communication-site-94a33429-e580-45c3-a090-5512a8070732). This is not a required input. If no input is provided, the topic design will be applied to the new home page. here are the IDs for the supported design packages:
62-
63-
1. Topic: 96c933ac-3698-44c7-9f4a-5fd17d71af9e
64-
2. Showcase: 6142d2a0-63a5-4ba0-aede-d9fefca2c767
65-
3. Blank: f6cc5403-0d63-442e-96c0-285923709ffc
66-
67-
68-
### STEP BY STEP INSTRUCTIONS
69-
70-
1. Install latest SharePoint Online Management Shell (version 8715.1200 or greater) from [here] (https://www.microsoft.com/en-us/download/details.aspx?id=35588). If you have an older version installed, please uninstall it from Windows Add/Remove programs and then install the latest version.
71-
2. Make sure you have the SharePoint admin credentials for the tenant
72-
3. Make sure you have the correct root site URL. Typically its https://<tenantname>.sharepoint.com
73-
4. Copy this block of PowerShell commands into a notepad and fill in the missing details denoted by <>
74-
75-
```PowerShell
56+
```
7657
$orgName="<tenantname>"
7758
$adminUPN = "<Current SharePoint Online Admin Login ID>"
7859
$rootSiteURL = "<Root site URL>"
7960
$userCredential = Get-Credential -UserName $adminUPN -Message "Type the password."
8061
Connect-SPOService -Url https://$orgName-admin.sharepoint.com -Credential $userCredential
8162
Enable-SPOCommSite -SiteUrl $rootSiteURL
8263
```
64+
**STEP BY STEP INSTRUCTIONS**
65+
66+
1. Install latest SharePoint Online Management Shell (version 8715.1200 or greater) from [here] (https://www.microsoft.com/en-us/download/details.aspx?id=35588). If you have an older version installed, please uninstall it from Windows Add/Remove programs and then install the latest version.
67+
2. Make sure you have the SharePoint admin credentials for the tenant
68+
3. Make sure you have the correct root site URL. Typically its https://<tenantname>.sharepoint.com
69+
4. Copy this block of PowerShell commands into a notepad and fill in the missing details denoted by <>
8370
5. Open SharePoint Online Management Shell from your computer
8471
6. Execute the PowerShell commands from your notepad
8572

8673

87-
### TROUBLESHOOTING
74+
**TROUBLESHOOTING**
8875

89-
### Error case 1: Wrong credentials
76+
**Error case 1: Wrong credentials**
9077
If the SharePoint admin user credentials is wrong or invalid, you will see this error:
9178

9279
>*Connect-SPOService : The sign-in name or password does not match one in the Microsoft account system.*
9380
94-
### Error case 2: Feature is not yet enabled for your tenant
81+
**Error case 2: Feature is not yet enabled for your tenant**
9582
The use of this cmdlet is subject to the feature rollout. If the feature is not yet available for your tenant, the cmdlet will not execute and will show this error:
9683

9784
>*Enable-SPOCommSite : The requested operation is part of an experimental feature that is not supported in the current environment.*
9885
99-
### Error case 3: Site URL input is not of root site
86+
**Error case 3: Site URL input is not of root site**
10087
Currently only the root site of a tenant is supported for this cmdlet. IF the site URL input is wrong, you will see this error:
10188

10289
>*Enable-SPOCommSite : The site provided is not the root site collection. Please provide a valid root site URL.*
10390
104-
### Error case 4: Site URL input is invalid
91+
**Error case 4: Site URL input is invalid**
10592
If the site URL input points to a site that does not exist, you will see the following error message:
10693

10794
>*Enable-SPOCommSite : File Not Found.*
10895
109-
### Error case 5: Classic publishing feature is currently enabled
96+
**Error case 5: Classic publishing feature is currently enabled**
11097
We do not support root site that currently have or have had in the past enabled the classic publishing features. If you see this error, your root site is not eligible for this feature enablement
11198

11299
>*Enable-SPOCommSite : The operation cannot be performed because the Publishing feature is enabled on the site.*
100+
101+
102+
## PARAMETERS
103+
104+
### -SiteUrl
105+
106+
URL of the site for enabling the modern communication site experience. **This is a required parameter**
107+
108+
109+
```yaml
110+
Type: String
111+
Parameter Sets: (All)
112+
Aliases:
113+
Applicable: SharePoint Online
114+
Required: True
115+
Position: Named
116+
Default value: None
117+
Accept pipeline input: False
118+
Accept wildcard characters: False
119+
```
120+
### -DesignPackageId
121+
122+
GUID identifying the [communication site design](https://support.office.com/en-gb/article/what-is-a-sharepoint-communication-site-94a33429-e580-45c3-a090-5512a8070732). **This is not a required input.** If no input is provided, the topic design will be applied to the new home page. here are the IDs for the supported design packages:
123+
124+
1. Topic: 96c933ac-3698-44c7-9f4a-5fd17d71af9e
125+
2. Showcase: 6142d2a0-63a5-4ba0-aede-d9fefca2c767
126+
3. Blank: f6cc5403-0d63-442e-96c0-285923709ffc
127+
128+
129+
```yaml
130+
Type: GUID
131+
Parameter Sets: (All)
132+
Aliases:
133+
Applicable: SharePoint Online
134+
Required: False
135+
Position: Named
136+
Default value: 96c933ac-3698-44c7-9f4a-5fd17d71af9e
137+
Accept pipeline input: False
138+
Accept wildcard characters: False
139+
```

0 commit comments

Comments
 (0)