Partilhar via


Get-SPOUser

Retorna as contas do usuário ou grupo de segurança do Microsoft Office SharePoint Online que correspondem a um determinado critério de pesquisa.

Syntax

Get-SPOUser
   [-Group <String>]
   [-Limit <String>]
   -Site <SpoSitePipeBind>
   [<CommonParameters>]
Get-SPOUser
   [-Limit <String>]
   -Site <SpoSitePipeBind>
   [<CommonParameters>]
Get-SPOUser
   [-LoginName <String>]
   -Site <SpoSitePipeBind>
   [<CommonParameters>]

Description

Este cmdlet contém mais de um parâmetro definido. Você pode usar apenas parâmetros de um conjunto de parâmetro e você não pode combinar parâmetros de diferentes conjuntos de parâmetros. Para obter mais informações sobre como usar conjuntos de parâmetros, confira Conjuntos de Parâmetros de Cmdlets.

O cmdlet Get-SPOUser corresponde um e apenas um usuário ou grupo de segurança.

Certifique-se de executar o Get-SPOUsercmdlet utilizando um administrador SharePoint Online ou um Administrador Global e ser um administrador da coleção do site consultado.

Para ver as permissões e as informações mais recentes sobre o Windows PowerShell para SharePoint Online, confira a documentação online em https://go.microsoft.com/fwlink/p/?LinkId=251832.

Exemplos

-----------------------EXEMPLO 1-----------------------------

Get-SPOUser -Site https://contoso.sharepoint.com/sites/finance

O exemplo 1 retorna todas as contas de usuários ou grupos de segurança do conjunto de sites https://contoso.sharepoint.com/sites/finance.

-----------------------EXEMPLO 2-----------------------------

Get-SPOUser -Site https://contoso.sharepoint.com/sites/finance -LoginName melissa.kerr@contoso.com

O exemplo 2 retorna uma conta de grupo de segurança ou usuário cujo nome de usuário é "melissa.kerr@contoso.com" da coleção https://contoso.sharepoint.com/sites/financede sites .

-----------------------EXEMPLO 3-----------------------------

Get-SPOUser -Site https://contoso.sharepoint.com/sites/finance -Group "Team Site Members"

O exemplo 3 retorna uma conta de usuário ou grupo de segurança dentro do grupo Membros do Site de Equipe do conjunto de sites https://contoso.sharepoint.com/sites/finance.

Parâmetros

-Group

Especifica o grupo do qual obter usuários.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-Limit

Especifica o número máximo de usuários retornados. O valor padrão é de 500 usuários. Para retornar todos os usuários, especifique o valor "Todos".

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-LoginName

Especifica o nome de usuário.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-Site

Especifica a URL do conjunto de sites do qual obter o usuário.

Type:SpoSitePipeBind
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online