Updates from: 05/08/2021 03:15:14
Service Microsoft Docs article Related commit history on GitHub Change details
SharePoint Home Site https://github.com/MicrosoftDocs/OfficeDocs-SharePoint/commits/live/SharePoint/SharePointOnline/home-site.md
When you set a site as your home site:
- The site is automatically set up as an [organization news site](organization-news-site.md). (Although you can have only one home site, you can have multiple organization news sites.) - The site is enabled for [configuring the global navigation in the SharePoint app bar](sharepoint-app-bar.md#get-started-customizing-the-global-navigation-tab).
+- Having a home site enables you to use [Viva Connections](https://docs.microsoft.com/SharePoint/viva-connections).
+ > [!NOTE] > Integration between the home site and [SharePoint start page](https://support.office.com/article/6b85097a-87e0-4611-a29a-dfd49b1a1220) (where the branding, theming, header, navigation, and footer elements from the home site are applied to the start page and users can easily navigate between the pages) is not available at this time. Please watch for updates in the [Microsoft 365 roadmap](https://www.microsoft.com/microsoft-365/roadmap?filters=SharePoint).
After you create and customize the communication site that you want to use as yo
3. Run `Set-SPOHomeSite -HomeSiteUrl <siteUrl>`. (Where siteUrl is the site you want to use)
+
+### Next, set up global navigation in the SharePoint app bar
+
+The [SharePoint app bar](https://docs.microsoft.com/SharePoint/sharepoint-app-bar) is being released to customers. Once the SharePoint app bar is available in your tenant, [enable and customize global navigation](https://docs.microsoft.com/SharePoint/sharepoint-app-bar#customize-global-navigation-in-the-app-bar). Then, consider [integrating your home site in Microsoft Teams using Viva Connections](https://docs.microsoft.com/SharePoint/viva-connections).
> [!NOTE]
-> You can set only one site in your organization as a home site. The site can be registered as a hub site, but can't be associated with a hub. The first time you set up a home site, it might take up to several minutes for the changes to take effect. If you run the command again to switch your home site to a different site, it might take up to 2 hours.
+> You can set only one site in your organization as a home site. The site can be registered as a hub site, but can't be associated with a hub. The first time you set up a home site, it might take up to several minutes for the changes to take effect. If you run the command again to switch your home site to a different site, it might take up to 2 hours.
SharePoint Sharepoint App Bar https://github.com/MicrosoftDocs/OfficeDocs-SharePoint/commits/live/SharePoint/SharePointOnline/sharepoint-app-bar.md
The SharePoint app bar brings together intranet resources and personalized conte
> - The SharePoint app bar will not display in SharePoint for external or guests users. > - When Microsoft Graph is disabled, the news and sites experience will be degraded. > - The SharePoint app bar can be temporarily disabled between today and when it becomes available to all customers to give customers more time to prepare for this change. Temporarily disabling the app bar will delay the rollout of this feature in your organization until October 31, 2021.
+> - Global navigation in the SharePoint app bar must be enabled in order for SharePoint resources to display in the [Microsoft Teams app bar for Viva Connections](https://docs.microsoft.com/SharePoint/viva-connections).
+ The SharePoint app bar is a significant change to the user experience and your organization's [intranet information architecture](./information-architecture-modern-experience.md). To ensure a seamless experience, we've created specific guidance on how to design current navigation to compliment the new global navigation feature. We have also created [end-user guidance](https://support.microsoft.com/office/use-the-sharepoint-app-bar-b2ab82d5-9af7-445e-ad24-236c5a86b5f8?ui=en-US&rs=en-US&ad=US) to help onboard the rest of your organization.
SharePoint Viva Connections https://github.com/MicrosoftDocs/OfficeDocs-SharePoint/commits/live/SharePoint/SharePointOnline/viva-connections.md
Microsoft [Viva Connections](https://techcommunity.microsoft.com/t5/microsoft-vi
## Benefits of using Viva Connections
- ![Image of the SharePoint home site in Teams](media/viva-features-2.png)
+![Image of the SharePoint home site in Teams](media/viva-features-2.png)
1. **Highlight specific resources:** Viva Connections uses the company-curated [global navigation](./sharepoint-app-bar.md) links along with personalized content like sites and news, which are powered by [Microsoft Graph](/graph/overview). Global navigation is configured in SharePoint and can be accessed by selecting the icon in Teams app bar. 2. **Navigate intranet resources in Teams:** Navigate to all modern SharePoint sites, pages, and news within Teams without losing context. All files will open in the Teams file preview window.
-3. **Search for intranet content in Teams:** On the home page, you can search for intranet content in SharePoint by searching in the Teams search bar. Search results will be displayed on a SharePoint site in the browser.
+3. **Search for intranet content in Teams:** On the home page, you can search for intranet content in SharePoint by searching in the Teams search bar. Search results will be displayed on a SharePoint site in the browser.
- ![Image of a search on the home site in Teams](media/viva-search-2.png)
+ ![Image of a search on the home site in Teams](media/viva-search-2.png)
4. **Share content easily:** Features in the SharePoint site header will dynamically display tools that help users collaborate depending on the type of content being viewed. Tasks such as sharing a link to a SharePoint page in a Teams chat are much easier.
->[!IMPORTANT]
+> [!IMPORTANT]
> - You need SharePoint admin permissions (or higher) to create the Viva Connections for Teams desktop app in PowerShell, and you need Teams admin permissions (or higher) to apply the app in the Teams Admin Center. > - Viva Connections for desktop is not yet supported in the Teams mobile app. > - Only modern SharePoint sites and pages can be viewed in Teams and all other content will open in a browser.
+> - [Global navigation in the SharePoint app bar](https://docs.microsoft.com/SharePoint/viva-connections) must be enabled in order for SharePoint resources to display in the Microsoft Teams app bar for Viva Connections.
> - Global navigation menu links can be [audience targeted](https://support.microsoft.com/office/target-content-to-a-specific-audience-on-a-sharepoint-site-68113d1b-be99-4d4c-a61c-73b087f48a81) so that specific content is surfaced to certain groups of people. Audience targeting settings in the SharePoint global navigation menu will carry over to global navigation in Teams. > - Search customizations applied to SharePoint sites will apply to search results in Teams when on the home site. > All SharePoint out-of-the-box site headers are compatible with Viva Connections desktop. However, if you modify your SharePoint site to remove, or significantly change the site header, then these contextual actions may not be available to the user.
The first version of Viva Connections can be provisioned through PowerShell and
- **Modern SharePoint sites and pages -** Only modern SharePoint sites and pages can be viewed in Teams and all other content will open in a browser. Learn more about how to [modernize classic SharePoint sites and pages](/sharepoint/dev/transform/modernize-userinterface-site-pages). - ## Step-by-step guide to setting up Viva Connections desktop+ Complete the following steps to enable Viva Connections desktop using [SharePoint PowerShell](/powershell/sharepoint/sharepoint-online/introduction-sharepoint-online-management-shell?view=sharepoint-ps): 1. **Set up a SharePoint home site:** We highly recommend that you set up a [SharePoint home site](./home-site.md) and use that site as the default landing experience for your users in Teams.
Complete the following steps to enable Viva Connections desktop using [SharePoin
3. **Create a Viva Connections app package in PowerShell:** The SharePoint admin needs to download and run PowerShell script from the Microsoft download center to create the Viva Connections desktop package. Ensure that you are using the [latest version](https://www.powershellgallery.com/packages/Microsoft.Online.SharePoint.PowerShell/16.0.20912.12000) of the [SharePoint Management Shell](/powershell/sharepoint/sharepoint-online/introduction-sharepoint-online-management-shell?view=sharepoint-ps) tool before running the script. -
->[!IMPORTANT]
-> - The [Viva Connections for desktop PowerShell script](https://www.microsoft.com/download/confirmation.aspx?id=102888) is available now.
-> - SharePoint admin credentials are required to use SharePoint PowerShell.
-> - The SharePoint admin who creates the Viva Connections desktop package needs site owner permissions (or higher) to the home site in SharePoint.
-> - If your tenant is using an older version of PowerShell, uninstall the older version and replace it with the most [up to date version](https://www.powershellgallery.com/packages/Microsoft.Online.SharePoint.PowerShell/16.0.20912.12000).
-> - Icons need to be PNG files
+ > [!IMPORTANT]
+ > - The [Viva Connections for desktop PowerShell script](https://www.microsoft.com/download/confirmation.aspx?id=102888) is available now.
+ > - SharePoint admin credentials are required to use SharePoint PowerShell.
+ > - The SharePoint admin who creates the Viva Connections desktop package needs site owner permissions (or higher) to the home site in SharePoint.
+ > - If your tenant is using an older version of PowerShell, uninstall the older version and replace it with the most [up to date version](https://www.powershellgallery.com/packages/Microsoft.Online.SharePoint.PowerShell/16.0.20912.12000).
+ > - Icons need to be PNG files.
4. **Provide tenant and site information to create the package:** Download the [Viva Connections for desktop PowerShell script](https://www.microsoft.com/download/confirmation.aspx?id=102888) and provide the information below. -
-**When you create a new package in PowerShell, you will be required to complete the following fields:**
--- **URL of your tenantΓÇÖs home site:** Provide the tenant's home site URL starting with "https://". This site will become the default landing experience for Viva Connections.-- Provide the following details when requested:
-<br>
-
- - **Name:** The name of your Viva Connections desktop package, as it should appear in Teams app bar.
- - **App short description (80 characters):** A short description for your app, which will appear in Teams app catalog.
- - **App long description (4000 characters):** A long description for your app, which will appear in Teams app catalog.
- - **Privacy policy:** The privacy policy for custom Teams apps in your organization (needs to start with https://). If you do not have a separate privacy policy, press Enter and the script will use the default SharePoint privacy policy from Microsoft.
- - **Terms of use:** The terms of use for custom Teams apps in your organization (needs to start with https://). If you do not have separate terms of use, press Enter and the script will use the default SharePoint terms of use from Microsoft.
- - **Company name:** Your organization name that will be visible on the app page in Teams app catalog in ΓÇ£Created ByΓÇ¥ section.
- - **Company website:** Your companyΓÇÖs public website (needs to start with https://) that will be linked to your companyΓÇÖs app name on the app page in Teams app catalog in ΓÇ£Created ByΓÇ¥ section.
- - **Icons:** You are required to provided two PNG icons, which will be used to represent your Viva Connections desktop app in Teams; a 192X192 pixel colored icon for Teams app catalog and a 32X32 pixel monochrome icon for Teams app bar. [Learn more about Teams icon guidelines](/microsoftteams/platform/concepts/build-and-test/apps-package#app-icons).
-
->[!NOTE]
-> Microsoft does not have access to any information provided by you while running this script.
+ **When you create a new package in PowerShell, you will be required to complete the following fields:**
+
+ - **URL of your tenantΓÇÖs home site:** Provide the tenant's home site URL starting with "https://". This site will become the default landing experience for Viva Connections.
+ - Provide the following details when requested:
+
+ - **Name:** The name of your Viva Connections desktop package, as it should appear in Teams app bar.
+ - **App short description (80 characters):** A short description for your app, which will appear in Teams app catalog.
+ - **App long description (4000 characters):** A long description for your app, which will appear in Teams app catalog.
+ - **Privacy policy:** The privacy policy for custom Teams apps in your organization (needs to start with https://). If you do not have a separate privacy policy, press Enter and the script will use the default SharePoint privacy policy from Microsoft.
+ - **Terms of use:** The terms of use for custom Teams apps in your organization (needs to start with https://). If you do not have separate terms of use, press Enter and the script will use the default SharePoint terms of use from Microsoft.
+ - **Company name:** Your organization name that will be visible on the app page in Teams app catalog in ΓÇ£Created ByΓÇ¥ section.
+ - **Company website:** Your companyΓÇÖs public website (needs to start with https://) that will be linked to your companyΓÇÖs app name on the app page in Teams app catalog in ΓÇ£Created ByΓÇ¥ section.
+ - **Icons:** You are required to provided two PNG icons, which will be used to represent your Viva Connections desktop app in Teams; a 192X192 pixel colored icon for Teams app catalog and a 32X32 pixel monochrome icon for Teams app bar. [Learn more about Teams icon guidelines](/microsoftteams/platform/concepts/build-and-test/apps-package#app-icons).
+
+ > [!NOTE]
+ > Microsoft does not have access to any information provided by you while running this script.
5. **Upload the Viva Connections desktop package in the Teams Admin Center:** Once you successfully provide the details, a Teams app manifest, which is a .zip file, will be created and saved on your device. The Teams administrator of your tenant will then need to upload this app manifest to **Teams admin center > Manage apps**. <br>