Updates to PowerShell "TOC" pages

Author: Linda Caputo

docs/declarative-customization/site-design-powershell.md

@@ -1,10 +1,10 @@
 ---
-title: PowerShell cmdlets for SharePoint site designs and site scripts
+title: SharePoint site design - PowerShell cmdlets
 description: Use PowerShell cmdlets to create, retrieve, and remove site designs and site scripts.
-ms.date: 03/19/2018
+ms.date: 03/22/2018
 ---
 
-# PowerShell cmdlets for SharePoint site designs and site scripts
+# SharePoint site design: PowerShell cmdlets
 
 > [!NOTE]
 > Site designs and site scripts have been released to production and are available for general use. 
@@ -16,6 +16,7 @@ Use PowerShell cmdlets to create, retrieve, update, and remove site designs and
 To run the PowerShell cmdlets, you'll need to do the following:
 
 1. Download and install the [SharePoint Online Management Shell](https://www.microsoft.com/en-us/download/details.aspx?id=35588). If you already have a previous version of the shell installed, uninstall it first and then install the latest version.
+
 2. Follow the instructions at [Connect to SharePoint Online PowerShell](https://technet.microsoft.com/en-us/library/fp161372.aspx) to connect to your SharePoint tenant.
 
 To verify your setup, try using the [Get-SPOSiteScript](https://docs.microsoft.com/en-us/powershell/module/sharepoint-online/Get-SPOSiteScript?view=sharepoint-ps) cmdlet to read the current list of site scripts. If the cmdlet runs and returns with no errors, you're ready to proceed.
@@ -35,9 +36,7 @@ The following cmdlets are available for managing site designs and site scripts f
 - [Remove-SPOSiteScript](https://docs.microsoft.com/en-us/powershell/module/sharepoint-online/Remove-SPOSiteScript?view=sharepoint-ps)
 - [Revoke-SPOSiteDesignRights](https://docs.microsoft.com/en-us/powershell/module/sharepoint-online/Revoke-SPOSiteDesignRights?view=sharepoint-ps)
 - [Set-SPOSiteDesign](https://docs.microsoft.com/en-us/powershell/module/sharepoint-online/Set-SPOSiteDesign?view=sharepoint-ps)
-
-<!-- This particular page is not publishing for some reason; saving the link to turn on when it finally behaves :-( 
-- [Set-SPOSiteScript](https://docs.microsoft.com/en-us/powershell/module/sharepoint-online/Set-SPOSiteScript?view=sharepoint-ps)-->
+- [Set-SPOSiteScript](https://docs.microsoft.com/en-us/powershell/module/sharepoint-online/Set-SPOSiteScript?view=sharepoint-ps)
 
 
 

docs/declarative-customization/site-theming/sharepoint-site-theming-powershell.md

@@ -1,191 +1,42 @@
+---
+title: SharePoint site theming - PowerShell cmdlets
+description: SharePoint tenant administrators can use PowerShell cmdlets to create, retrieve, and remove site themes. Developers can use the SharePoint REST API to handle theme management tasks.
+ms.date: 03/22/2018
+---
+
 # SharePoint site theming: PowerShell cmdlets
 
-SharePoint tenant administrators can use PowerShell cmdlets to create, retrieve, and remove site themes. Developers can also use the SharePoint [REST API](sharepoint-site-theming-rest-api.md) to handle theme management tasks.
+SharePoint tenant administrators can use PowerShell cmdlets to create, retrieve, and remove site themes. 
+
+Developers can use the SharePoint [REST API](sharepoint-site-theming-rest-api.md) to handle theme management tasks.
 
 For information about how themes are defined and stored, see [JSON schema reference](sharepoint-site-theming-json-schema.md).
 
 ## Getting started
 
-To run the PowerShell cmdlets for theme management, you'll need to do the following:
+To run the PowerShell cmdlets for theme management, you must do the following:
 
 1. Download and install the [SharePoint Online Management Shell](https://www.microsoft.com/en-us/download/details.aspx?id=35588). If you already have a previous version of the shell installed, uninstall it first and then install the latest version.
+
 2. Follow the instructions at [Connect to SharePoint Online PowerShell](https://technet.microsoft.com/en-us/library/fp161372.aspx) to connect to your SharePoint tenant.
 
-To verify your setup, try using the **Get-SPOHideDefaultThemes** cmdlet to read the SPOHideDefaultThemes setting. If the cmdlet runs and returns False with no errors, as shown in the following example, you're ready to proceed.
+To verify your setup, try using the [Get-SPOHideDefaultThemes](https://docs.microsoft.com/en-us/powershell/module/sharepoint-online/Get-SPOHideDefaultThemes?view=sharepoint-ps) cmdlet to read the SPOHideDefaultThemes setting. If the cmdlet runs and returns False with no errors, as shown in the following example, you're ready to proceed.
 
-```powershell
-c:\> Get-SPOHideDefaultThemes
-False
-```
 ## Site theme cmdlets
 
 The following cmdlets are available for managing site themes from PowerShell:
 
-* **Add-SPOTheme** — Creates a new custom theme, or overwrites an existing theme to modify its settings.
-* **Get-SPOTheme** — Retrieves settings for an existing theme.
-* **Remove-SPOTheme** — Removes a theme from the theme gallery.
-* **Set-SPOHideDefaultThemes** — Specifies whether the default themes should be available.
-* **Get-SPOHideDefaultThemes** — Queries the current SPOHideDefaultThemes setting.
-
-## Add-SPOTheme
-
-The **Add-SPOTheme** cmdlet creates a new theme or updates an existing theme. The color pallette settings can be passed as either a hash table or a dictionary.
-
-In the following example, a new theme named "Custom Cyan" is created, with color pallette settings that are various shades of cyan. Note that the settings are passed as a hash table.
-
-```powershell
-$themepallette = @{
-  "themePrimary" = "#00ffff";
-  "themeLighterAlt" = "#f3fcfc";
-  "themeLighter" = "#daffff";
-  "themeLight" = "#affefe";
-  "themeTertiary" = "#76ffff";
-  "themeSecondary" = "#39ffff";
-  "themeDarkAlt" = "#00c4c4";
-  "themeDark" = "#009090";
-  "themeDarker" = "#005252";
-  "neutralLighterAlt" = "#f8f8f8";
-  "neutralLighter" = "#f4f4f4";
-  "neutralLight" = "#eaeaea";
-  "neutralQuaternaryAlt" = "#dadada";
-  "neutralQuaternary" = "#d0d0d0";
-  "neutralTertiaryAlt" = "#c8c8c8";
-  "neutralTertiary" = "#a6a6a6";
-  "neutralSecondaryAlt" = "#767676";
-  "neutralSecondary" = "#666666";
-  "neutralPrimary" = "#333";
-  "neutralPrimaryAlt" = "#3c3c3c";
-  "neutralDark" = "#212121";
-  "black" = "#000000";
-  "white" = "#fff";
-  "primaryBackground" = "#fff";
-  "primaryText" = "#333"
- }
-
-Add-SPOTheme -Name "Custom Cyan" -Palette $themepallette -IsInverted $false
-```
-
-> [!NOTE]
-> Prior to the December 2017 release of SPO Management Shell, the **Add-SPOTheme**
-> cmdlet required that color pallette settings be passed as a dictionary. We recommend
-> that you use the latest version of the SPO Management Shell, however the following
-> ```HashToDictionary``` function can be used to convert a hash table to a
-> dictionary if needed.
-
-```powershell
-function HashToDictionary {
-  Param ([Hashtable]$ht)
-  $dictionary = New-Object "System.Collections.Generic.Dictionary``2[System.String,System.String]"
-  foreach ($entry in $ht.GetEnumerator()) {
-    $dictionary.Add($entry.Name, $entry.Value)
-  }
-  return $dictionary
-}
-```
-If you want to update an existing theme (to modify some of its color settings, for example), use the same syntax as shown previously but add the *-Overwrite* flag to the **Add-SPOTheme** cmdlet.
-
-```powershell
-Add-SPOTheme -Name "Custom Cyan" -Palette $themepallette -IsInverted $false -Overwrite
-```
-Adding a theme does not apply the theme to any sites. It adds the theme to your tenant store, and then the theme will be available in the list of themes under the **Change the look** option for modern pages.
-
-## Get-SPOTheme
-
-The **Get-SPOTheme** cmdlet returns the settings for a named existing theme, or for all uploaded themes if no name is provided.
-
-Here's how to use the **Get-SPOTheme** cmdlet to return the settings for the "Custom Cyan" theme created in the previous example.
-
-```powershell
-C:\> Get-SPOTheme -Name "Custom Cyan" | ConvertTo-Json
-```
-```json
-{
-    "Name":  "Custom Cyan",
-    "Palette":  {
-                    "themeLight":  "#affefe",
-                    "themeTertiary":  "#76ffff",
-                    "black":  "#000000",
-                    "neutralSecondary":  "#666666",
-                    "neutralTertiaryAlt":  "#c8c8c8",
-                    "themeSecondary":  "#39ffff",
-                    "themeDarker":  "#005252",
-                    "primaryBackground":  "#fff",
-                    "neutralQuaternary":  "#d0d0d0",
-                    "neutralPrimaryAlt":  "#3c3c3c",
-                    "neutralPrimary":  "#333",
-                    "themeDark":  "#009090",
-                    "themeLighter":  "#daffff",
-                    "neutralTertiary":  "#a6a6a6",
-                    "neutralQuaternaryAlt":  "#dadada",
-                    "themeLighterAlt":  "#f3fcfc",
-                    "white":  "#fff",
-                    "neutralSecondaryAlt":  "#767676",
-                    "neutralLighter":  "#f4f4f4",
-                    "neutralLight":  "#eaeaea",
-                    "neutralDark":  "#212121",
-                    "themeDarkAlt":  "#00c4c4",
-                    "neutralLighterAlt":  "#f8f8f8",
-                    "primaryText":  "#333",
-                    "themePrimary":  "#00ffff"
-                },
-    "IsInverted":  false
-}
-```
-Note that this example uses the PowerShell _ConvertTo-Json_ filter to display the theme in JSON format.
-
-To return all uploaded themes, use the **Get-SPOTheme** command with no arguments:
-
-```powershell
-C:\> Get-SPOTheme
-```
-
-Here's an example of the output from this command:
-
-![Get-SPOTheme example](../../images/Get-SPOTheme-example.png)
-
-## Remove-SPOTheme
-
-The **Remove-SPOTheme** cmdlet removes a theme from your tenant store. For example, this cmdlet removes the "Custom Cyan" theme that was used in the previous examples.
-
-```powershell
-c:\> Remove-SPOTheme -Name "Custom Cyan"
-```
-## Set-SPOHideDefaultThemes
-
-> [!NOTE]
-> This cmdlet was named ```Set-HideDefaultThemes``` until the December 2017 release of SPO Management Shell. We recommend that you use the latest version of the PowerShell cmdlets.
-
-The **Set-SPOHideDefaultThemes** cmdlet is used to specify whether the default themes that come with SharePoint should be included in the theme picker list. For example, you might want to create custom themes for your sites and then remove the default themes, to ensure that all pages will use your custom themes.
-
-Specify the setting as either _$true_ to hide the default themes, or _$false_ (the default setting) to allow use of the default themes. For example, this cmdlet hides the default themes.
-
-```powershell
-Set-SPOHideDefaultThemes $true
-```
-After creating the "Custom Cyan" theme, hiding the default themes will leave only the one custom theme in the themes list under **Change the look**.
-
-To restore the default themes to the theme picker list, use the following cmdlet.
-```powershell
-Set-SPOHideDefaultThemes $false
-```
-
-## Get-SPOHideDefaultThemes
-
-> [!NOTE]
-> this cmdlet was named ```Get-HideDefaultThemes``` until the December 2017 release of SPO Management Shell. We recommend that you use the latest version of the PowerShell cmdlets.
-
-The **Get-SPOHideDefaultThemes** cmdlet retrieves the currrent **Set-SPOHideDefaultThemes** setting. You might want to use this cmdlet in a PowerShell script to read the setting and then take different actions based on whether the default themes are hidden. This cmdlet does not have any parameters.
-
-```powershell
-c:\> Get-SPOHideDefaultThemes
-False
-```
+* [Add-SPOTheme](https://docs.microsoft.com/en-us/powershell/module/sharepoint-online/Add-SPOTheme?view=sharepoint-ps) – Creates a new custom theme, or overwrites an existing theme to modify its settings.
+* [Get-SPOTheme](https://docs.microsoft.com/en-us/powershell/module/sharepoint-online/Get-SPOTheme?view=sharepoint-ps) – Retrieves settings for an existing theme.
+* [Remove-SPOTheme](https://docs.microsoft.com/en-us/powershell/module/sharepoint-online/Remove-SPOTheme?view=sharepoint-ps) – Removes a theme from the theme gallery.
+* [Set-SPOHideDefaultThemes](https://docs.microsoft.com/en-us/powershell/module/sharepoint-online/Set-SPOHideDefaultThemes?view=sharepoint-ps) – Specifies whether the default themes should be available.
+* [Get-SPOHideDefaultThemes](https://docs.microsoft.com/en-us/powershell/module/sharepoint-online/Get-SPOHideDefaultThemes?view=sharepoint-ps) – Queries the current SPOHideDefaultThemes setting.
+
 
 ## See also
 
 * [SharePoint site theming overview](sharepoint-site-theming-overview.md)
-* [SharePoint site theming: JSON schema](sharepoint-site-theming-json-schema.md)
 * [SharePoint site theming: CSOM](sharepoint-site-theming-csom.md)
-* [SharePoint site theming: REST API](sharepoint-site-theming-rest-api.md)
-* [SharePoint Online Management Shell](https://www.microsoft.com/en-us/download/details.aspx?id=35588)
-* [Connect to SharePoint Online PowerShell](https://technet.microsoft.com/en-us/library/fp161372.aspx)
+
+
+