additional important hub site cmdlet details

davidchesnut · davidchesnut · commit 0d4c696cc2f4 · 2018-03-05T09:01:46.000-08:00
diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Add-SPOHubSiteAssociation.md b/sharepoint/sharepoint-ps/sharepoint-online/Add-SPOHubSiteAssociation.md
@@ -21,7 +21,7 @@ Add-SPOHubSiteAssociation [-Site] <SpoSitePipeBind> `
 ## DESCRIPTION
 Use this cmdlet to associate a site with a hub site.
 
-If the site or hub site doesn’t exist, this cmdlet returns a “File not found” error.
+> [!IMPORTANT] This cmdlet is currently in preview and is subject to change. It is not currently supported for use in production environments.
 
 ## EXAMPLES
 
@@ -79,4 +79,8 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
 
 ## NOTES
 
+If the site or hub site doesn’t exist, this cmdlet returns a “File not found” error.
+
+If the site is already a hub site, this cmdlet returns a "This site is already a HubSite" error.
+
 ## RELATED LINKS
diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOHubSite.md b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOHubSite.md
@@ -21,7 +21,9 @@ Set-SPOHubSite [-Identity] <SpoHubSitePipeBind>
 ```
 
 ## DESCRIPTION
-Lists all hub sites found on the SharePoint tenant. If you provide **-Identity** the cmdlet returns detailed information about the specific hub.
+Lists all hub sites found on the SharePoint tenant. If you provide **-Identity** the cmdlet returns detailed information about the specific hub. You can find which hub a site is associated with by providing the site's identity with this cmdlet.
+
+> [!IMPORTANT] This cmdlet is currently in preview and is subject to change. It is not currently supported for use in production environments.
 
 If the hub site doesn’t exist, this cmdlet returns a “File not found” error.
 
@@ -38,7 +40,7 @@ This example lists all hub sites in the tenant.
 ### Example 2
 
 ```
-Get-SPOHubSite https://contoso.sharepoint.com/sites/Research
+Get-SPOHubSite https://contoso.sharepoint.com/sites/online-marketing
 
 ID          : 44252d09-62c4-4913-9eb0-a2a8b8d7f863
 Title       : Marketing Hub
@@ -49,7 +51,7 @@ Description : Hub for the Marketing division
 Rights     : nestorw@contoso.onmicrosoft.com
 ```
 
-This example provides property information about the research hub site.
+This example begins with the online-marketing site. The cmdlet finds the associated hub site, which is marketing. Then it lists all the details about the marketing hub site.
 
 ## PARAMETERS
 
diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Grant-SPOHubSiteRights.md b/sharepoint/sharepoint-ps/sharepoint-online/Grant-SPOHubSiteRights.md
@@ -8,7 +8,7 @@ schema: 2.0.0
 # Grant-SPOHubSiteRights
 
 ## SYNOPSIS
-Grants rights to users or security groups to access the hub site.
+Grants rights to users or mail-enabled security groups to access the hub site.
 
 ## SYNTAX
 
@@ -18,7 +18,11 @@ Grant-SPOHubSiteRights [-Identity] <SpoHubSitePipeBind> -Principals
 ```
 
 ## DESCRIPTION
-Applies permissions to a set of users or security groups. Use this cmdlet to scope visibility of who can associate their site with the hub site when using the SharePoint user interface. Hub sites are public by default. Once you set permissions, only those groups or users you specified can associate their site with the hub site.
+Applies permissions to a set of users or mail-enabled security groups. Use this cmdlet to scope visibility of who can associate their site with the hub site when using the SharePoint user interface. Hub sites are public by default. Once you set permissions, only those groups or users you specified can associate their site with the hub site.
+
+To view which users or groups have permissions to a site, use the [Get-SPOHubSite](Get-SPOHubSite.md) cmdlet.
+
+> [!IMPORTANT] This cmdlet is currently in preview and is subject to change. It is not currently supported for use in production environments.
 
 ## EXAMPLES
 
diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Register-SPOHubSite.md b/sharepoint/sharepoint-ps/sharepoint-online/Register-SPOHubSite.md
@@ -20,7 +20,7 @@ Register-SPOHubSite [-Site] <SpoSitePipeBind>  [<CommonParameters>]
 ## DESCRIPTION
 Use this cmdlet to register an existing site collection as a hub site.
 
-If the site doesn’t exist, this cmdlet returns a “File not found” error.
+> [!IMPORTANT] This cmdlet is currently in preview and is subject to change. It is not currently supported for use in production environments.
 
 ## EXAMPLES
 
@@ -59,4 +59,10 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
 
 ## NOTES
 
+If the site doesn’t exist, this cmdlet returns a “File not found” error.
+
+If the site is already a hub site, this cmdlet returns a "This site is already a HubSite" error.
+
+If the site is already associated with another hub site, this cmdlet returns a "This site is currently associated with a HubSite" error. You'll need to run the [Remove-SPOHubSiteAssociation](Remove-SPOHubSiteAssociation.md) cmdlet first before you can make the site a hub site.
+
 ## RELATED LINKS
diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Remove-SPOHubSiteAssociation.md b/sharepoint/sharepoint-ps/sharepoint-online/Remove-SPOHubSiteAssociation.md
@@ -20,6 +20,8 @@ Remove-SPOHubSiteAssociation [-Site] <SpoSitePipeBind>
 ## DESCRIPTION
 Use this cmdlet to remove an association between a site and a hub site.
 
+> [!IMPORTANT] This cmdlet is currently in preview and is subject to change. It is not currently supported for use in production environments.
+
 If the site or hub site doesn’t exist, this cmdlet returns a “File not found” error.
 
 ## EXAMPLES
diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Revoke-SPOHubSiteRights.md b/sharepoint/sharepoint-ps/sharepoint-online/Revoke-SPOHubSiteRights.md
@@ -20,6 +20,8 @@ Revoke-SPOHubSiteRights [-Identity] <SpoHubSitePipeBind> -Principals
 ## DESCRIPTION
 Revokes rights for specified principals to the given hub site. The specified principals will no longer be able to associate sites with the hub. To find which principals have access to a hub site, use the [Get-SPOHubSite](Get-SPOHubSite.md) cmdlet.
 
+> [!IMPORTANT] This cmdlet is currently in preview and is subject to change. It is not currently supported for use in production environments.
+
 If the hub site doesn’t exist, this cmdlet returns a “File not found” error.
 
 ## EXAMPLES
diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOHubSite.md b/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOHubSite.md
@@ -23,6 +23,8 @@ Set-SPOHubSite [-Identity] <SpoHubSitePipeBind>
 ## DESCRIPTION
 Use this cmdlet to set properties such as name, logo, and description. These properties appear for the hub in the SharePoint user interface.
 
+> [!IMPORTANT] This cmdlet is currently in preview and is subject to change. It is not currently supported for use in production environments.
+
 If the hub site doesn’t exist, this cmdlet returns a “File not found” error.
 
 ## EXAMPLES
diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Unregister-SPOHubSite.md b/sharepoint/sharepoint-ps/sharepoint-online/Unregister-SPOHubSite.md
@@ -19,7 +19,9 @@ Unregister-SPOHubSite [-Identity] <SpoHubSitePipeBind>
 ```
 
 ## DESCRIPTION
-Disables the hub site feature on a site so that it is no longer a hub site.
+Disables the hub site feature on a site so that it is no longer a hub site. Associated sites may still appear associated for up to an hour. If you want to speed up the process, use the Remove-SPOHubSiteAssociation cmdlet to remove the associates sites first.
+
+> [!IMPORTANT] This cmdlet is currently in preview and is subject to change. It is not currently supported for use in production environments.
 
 If the site doesn’t exist, this cmdlet returns a “File not found” error.
 
