Compartilhar via


Gerenciar usuários e grupos do SharePoint

Este artigo mostra como adicionar ou remover grupos e usuários em uma determinada coleção de sites. Os exemplos de código neste artigo adicionam usuários e grupos e, em seguida, dão-lhes níveis de permissão de acesso ao SharePoint. Essas ações de nível de permissão de usuário e grupo são implementadas por meio de métodos de extensão na amostra PnP Core.GroupManagement .

Antes de começar

Para começar, baixe o suplemento de exemplo Core.GroupManagement do projeto Office 365 Padrões e Práticas do Desenvolvedor no GitHub.

Observação

The code in this article is provided as-is, without warranty of any kind, either express or implied, including any implied warranties of fitness for a particular purpose, merchantability, or non-infringement.

Adicionar e remover grupos e usuários

O exemplo a seguir mostra como adicionar grupos e adicionar usuários a grupos.

cc.Load(cc.Web, web => web.CurrentUser);
cc.ExecuteQuery();
Microsoft.SharePoint.Client.User currentUser = cc.Web.CurrentUser;

if (!cc.Web.GroupExists("Test"))
{
  Group group = cc.Web.AddGroup("Test", "Test group", true);
  cc.Web.AddUserToGroup("Test", currentUser.LoginName);
}

O próximo exemplo remove um grupo.

if (cc.Web.GroupExists("Test"))
{
  cc.Web.RemoveGroup("Test");
}

O próximo exemplo remove usuários de grupos.

cc.Load(cc.Web, web => web.CurrentUser);
cc.ExecuteQuery();
Microsoft.SharePoint.Client.User currentUser = cc.Web.CurrentUser;
if (cc.Web.GroupExists("Test"))
{
  if (cc.Web.IsUserInGroup("Test", currentUser.LoginName))
  {
    cc.Web.RemoveUserFromGroup("Test", currentUser.LoginName);
  }
}

Adicionar nível de permissão ao grupo ou ao usuário

O exemplo a seguir adiciona um nível de permissão a um grupo.

if (cc.Web.GroupExists("Test"))
{
  cc.Web.AddPermissionLevelToGroup("Test", RoleType.Contributor);
}

O próximo exemplo adiciona um nível de permissão a um usuário.

cc.Load(cc.Web, web => web.CurrentUser);
cc.ExecuteQuery();
Microsoft.SharePoint.Client.User currentUser = cc.Web.CurrentUser;
cc.Web.AddPermissionLevelToUser(currentUser.LoginName, RoleType.Reader);

Remover o nível de permissão do grupo ou do usuário

O exemplo a seguir remove um nível de permissão de um grupo.

if (cc.Web.GroupExists("Test"))
{
  cc.Web.RemovePermissionLevelFromGroup("Test", RoleType.Reader);
}


O próximo exemplo remove um nível de permissão de um usuário.

cc.Load(cc.Web, web => web.CurrentUser);
cc.ExecuteQuery();
Microsoft.SharePoint.Client.User currentUser = cc.Web.CurrentUser;
cc.Web.RemovePermissionLevelFromUser(currentUser.LoginName, RoleType.Reader);

Confira também