Compartilhar via

Criar sites do hub do SharePoint usando o PowerShell

  • Artigo

Se você for um administrador global ou do SharePoint no Office 365, poderá converter qualquer site existente em um site do hub usando o Microsoft PowerShell. Neste exemplo, você saberá como criar um site do hub do SharePoint e associar outro site a ele. Nesse cenário, você está configurando sites para o departamento de marketing da Contoso:

  • Você criará um site do hub ao qual todos os outros sites de marketing estarão associados.
  • Depois você especificará as configurações e permissões para o site do hub.
  • Por fim, você criará um segundo site e o associará ao site do hub.

Observação

Para trabalhar com este exemplo no SharePoint Online, é recomendável usar um locatário do desenvolvedor e não seu locatário de produção. Todas as etapas a seguir usam um locatário fictício chamado "Contoso", o qual pode ser substituído pelo nome do seu próprio locatário.

Uso do PnP PowerShell

Os exemplos a seguir podem ser executados usando o PnP PowerShell.

Observação

No restante deste exercício, contoso será usado como o nome do locatário. Continue usando o nome do seu próprio locatário em vez de contoso.

Observação

O PnP PowerShell é uma solução de software livre com uma comunidade ativa de suporte. Não há nenhuma SLA para o suporte da ferramenta de software livre por parte da Microsoft.

Criar um novo site do hub

Primeiro, vamos criar o site de marketing que servirá como um site do hub ao qual outros sites podem se associar. O objetivo é que todos os sites orientados ao marketing façam parte do site do hub. Isso aplica uma navegação e uma identidade visual comuns a todos os sites associados, permite que membros da equipe façam pesquisas em todos os sites associados com o único site do hub e se beneficia de outros recursos dos sites do hub.

  1. Conecte-se ao Centro de Administração do SharePoint Online usando:

    Connect-PnPOnline -Url https://contoso-admin.sharepoint.com -UseWebLogin

  2. Crie o site a ser usado como um site do hub usando o cmdlet New-PnPSite:

    New-PnPSite -Type TeamSite -Title "Contoso marketing division" -Alias "marketing" -Description "Main site for collaboration for marketing teams at Contoso"

    O cmdlet retorna a URL do novo site de modo semelhante ao seguinte:

    https://contoso.sharepoint.com/sites/marketing

  3. Registre o novo site de marketing como um site do hub usando o cmdlet Register-PnPHubSite:

    Register-PnPHubSite -Site https://contoso.sharepoint.com/sites/marketing

Definir propriedades e permissões no site do hub

O site do hub ainda não tem logotipo ou descrição. Também queremos restringi-lo para que somente uma pessoa possa fazer alterações ao site do hub.

Configurar as propriedades

  1. Carregue a imagem do logotipo do site indo até https://contoso.sharepoint.com/sites/marketing/SiteAssets e carregando a imagem desejada. Anote o nome do arquivo de imagem.

  2. Use o cmdlet Set-PnPHubSite para definir o logotipo e a descrição. Em vez de mylogo.jpg, especifique o nome da imagem que você carregou:

    Set-PnPHubSite
  -Identity https://contoso.sharepoint.com/sites/marketing
  -LogoUrl https://contoso.sharepoint.com/sites/marketing/SiteAssets/mylogo.jpg
  -Description "Main hub site for collaboration on marketing activities across Contoso"

Definir permissões

Agora restringiremos o acesso para que somente o usuário nestorw@contoso.com possa fazer alterações às associações do site do hub.

  • Execute o cmdlet Grant-PnPHubSiteRights para conceder direitos a um usuário para o site do hub de marketing. Vamos usar nestorw@contoso neste exemplo, mas você pode usar qualquer usuário válido em seu locatário (é possível especificar vários usuários separando-os com uma vírgula):

    Grant-PnPHubSiteRights -Identity https://contoso.sharepoint.com/sites/marketing -Principals "nestorw@contoso"

Criar e associar um novo site

A etapa final é criar o site que queremos associar ao hub. É possível repetir essas etapas para quantos sites desejar integrar ao hub.

  1. Provisione o site usando o cmdlet New-PnPSite:

    New-PnPSite -Type TeamSite -Title "Online advertising team" -Alias "online-advertising" -Description "For collaboration on online advertising resources"

    O cmdlet retorna a URL do novo site de modo semelhante ao seguinte:

    https://contoso.sharepoint.com/sites/online-advertising

  2. Associe este site ao site do hub usando o cmdlet Add-PnPHubSiteAssociation:

    Add-PnPHubSiteAssociation
  -Site https://contoso.sharepoint.com/sites/online-advertising
  -HubSite https://contoso.sharepoint.com/sites/marketing

Confirmar que o site do hub está funcionando

Para confirmar, você pode:

  • Executar o cmdlet Get-PnPHubSite.
  • Conectar-se ao SharePoint Online e exibir o site do hub diretamente em https://contoso.sharepoint.com/sites/marketing.

A navegação do site do hub aparecerá na parte superior do site. Se você acessar o site https://contoso.sharepoint.com/sites/online-advertising, ele também mostrará a mesma navegação de site do hub na parte superior.

Confira também