Set-SPUser
Configura propriedades de um usuário existente.
Syntax
Set-SPUser
[-Identity] <SPUserPipeBind>
[-AddPermissionLevel <String[]>]
[-AssignmentCollection <SPAssignmentCollection>]
[-ClearPermissions]
[-Confirm]
[-DisplayName <String>]
[-Email <String>]
[-Group <SPGroupPipeBind>]
[-IsSiteCollectionAdmin]
[-PassThru]
[-RemovePermissionLevel <String[]>]
[-SyncFromAD]
[-Web <SPWebPipeBind>]
[-WhatIf]
[<CommonParameters>]Description
O Set-SPUser cmdlet configura propriedades de um usuário existente.
Para obter as permissões e informações mais recentes sobre o Windows PowerShell para Produtos SharePoint, confira a documentação online em Cmdlets do SharePoint Server.
Exemplos
------------------EXEMPLO 1-----------------------
Set-SPUser -Identity 'Contoso\jdoe' -Web https://intranet.contoso.com -AddPermissionLevel "Contributor"Este exemplo define um usuário (Contoso\jdoe) como um colaborador em https://intranet.contoso.com.
------------------EXEMPLO 2-----------------------
Set-SPUser -Identity 'Contoso\jdoe' -Web https://intranet.contoso.com -SyncFromADIsso atualiza a Lista de Informações do Usuário para o usuário 'contoso\jdoe' com os valores atuais displayName e mail de atributo da conta do Active Directory do usuário.
Parâmetros
-AddPermissionLevel
Especifica o nível de permissão a ser adicionado ao usuário.
O valor deve ser uma das seguintes opções:
--Contribuir
Pode exibir, adicionar, atualizar e excluir itens e documentos da lista.
--Design
Pode exibir, adicionar, atualizar, excluir, aprovar e personalizar documentos.
--Controle completo
Tem controle total para todos os documentos.
--Acesso limitado
Pode exibir listas específicas, bibliotecas de documentos, itens de lista, pastas ou documentos quando as permissões são concedidas.
--Ler
Pode exibir páginas e listar itens e baixar documentos.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-AssignmentCollection
Gerencia objetos para o devido descarte. O uso de objetos como SPWeb ou SPSite pode consumir grandes quantidades de memória e o uso desses objetos em scripts do Windows PowerShell requer gerenciamento de memória adequado. Usando o objeto SPAssignment, você poderá atribuir objetos a uma variável e descartar os objetos após o uso para liberar memória. Quando objetos SPWeb, SPSite ou SPSiteAdministration são usados, os objetos são automaticamente descartados se um conjunto de atribuições ou o parâmetro Global não forem usados.
Quando o parâmetro Global é usado, todos os objetos estão contidos no repositório global.
Quando os objetos não são usados imediatamente ou são descartados com o uso do comando Stop-SPAssignment, pode ocorrer um cenário de memória insuficiente.
| Type: | SPAssignmentCollection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-ClearPermissions
Exclui todas as permissões atribuídas do usuário. Se os valores Limpar e Adicionar existirem, as permissões serão primeiramente desmarcadas e, em seguida, novas permissões serão adicionadas.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Confirm
Solicita sua confirmação antes de executar o comando.
Para saber mais, digite o seguinte comando: get-help about_commonparameters
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-DisplayName
Especifica o novo nome para exibição do usuário.
O tipo deve ser um nome válido.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
Especifica o novo endereço de email do usuário.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Group
Adiciona o usuário a um grupo existente no site determinado.
| Type: | SPGroupPipeBind |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Identity
Especifica o guid, o nome de logon ou o objeto SPUser do usuário a ser retornado.
O tipo deve ser um GUID de um usuário existente no formulário, 1234-5678-9876-0987.
| Type: | SPUserPipeBind |
| Aliases: | UserAlias |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-IsSiteCollectionAdmin
Especifica se o usuário deve ser definido como administrador do conjunto de sites.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-PassThru
Caso não seja fornecido, indicará que este cmdlet não tem saída. Se fornecido, esse parâmetro indicará que o objeto SPUser para esse usuário deverá ser retornado.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-RemovePermissionLevel
Remove o nível de permissão do usuário.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-SyncFromAD
Caso seja fornecido, especifica que as informações do usuário serão sincronizadas a partir do repositório de diretório de usuário. Essa opção recupera apenas o displayName valor e mail do repositório de diretórios. Ele dá suporte ao Active Directory (Clássico ou autenticação do Windows), Autenticação baseada em Formulários e SAML. Os provedores FBA e SAML devem dar suporte à resolução de seu repositório de diretórios para que essa opção funcione. A opção só dá suporte a objetos do Usuário do SharePoint.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Web
Especifica o nome da URL ou do GUID a ser usado como escopo. Esse parâmetro não será necessário caso o objeto SPUser seja fornecido como a identidade.
O valor deve ser uma URL autentica, no formulário https://server_name, ou GUID, no formulário 1234-5678-9807.
| Type: | SPWebPipeBind |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-WhatIf
Exibe uma mensagem que descreve o efeito do comando em vez de executar o comando.
Para saber mais, digite o seguinte comando: get-help about_commonparameters
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de