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.
Sintaxe
All (Default)
Get-SPOUser
-Site <SpoSitePipeBind>
[-Limit <String>]
[<CommonParameters>]
ByGroup
Get-SPOUser
-Site <SpoSitePipeBind>
[-Group <String>]
[-Limit <String>]
[<CommonParameters>]
ByLogin
Get-SPOUser
-Site <SpoSitePipeBind>
[-LoginName <String>]
[<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 que executa o Get-SPOUser cmdlet como, pelo menos, um administrador do SharePoint Online e seja um administrador da coleção de sites do site consultado.
Para obter permissões e as informações mais recentes sobre o Windows PowerShell do SharePoint Online, consulte a documentação on-line em Introdução ao Shell de gerenciamento do SharePoint Online..
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 devolve uma conta de utilizador ou grupo de segurança cujo nome de utilizador é "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
Aplicável: SharePoint Online
Especifica o grupo do qual obter usuários.
Propriedades do parâmetro
| Tipo: | System.String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
ByGroup
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Limit
Aplicável: SharePoint Online
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".
Propriedades do parâmetro
| Tipo: | System.String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
All
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
ByGroup
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-LoginName
Aplicável: SharePoint Online
Especifica o nome de usuário.
Propriedades do parâmetro
| Tipo: | System.String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
ByLogin
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Site
Aplicável: SharePoint Online
Especifica a URL do conjunto de sites do qual obter o usuário.
Propriedades do parâmetro
| Tipo: | Microsoft.Online.SharePoint.PowerShell.SpoSitePipeBind |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.