Get-SPOExternalUser
Devolve utilizadores externos no inquilino.
Sintaxe
Default (Default)
Get-SPOExternalUser
[[-Position] <Int32>]
[[-PageSize] <Int32>]
[[-Filter] <String>]
[[-SortOrder] <SortOrder>]
[[-SiteUrl] <String>]
[-ShowOnlyUsersWithAcceptingAccountNotMatchInvitedAccount <Boolean>]
[<CommonParameters>]
Description
O Get-SPOExternalUser cmdlet devolve utilizadores externos localizados no inquilino com base em critérios especificados.
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-SPOExternalUser -Position 0 -PageSize 2
O exemplo 1 retorna os dois primeiros usuários externos no conjunto.
EXEMPLO 2
Get-SPOExternalUser -Position 2 -PageSize 2
O exemplo 2 retorna dois usuários externos da terceira página do conjunto.
EXEMPLO 3
Get-SPOExternalUser -Position 0 -PageSize 30 -SiteUrl https://contoso.sharepoint.com
O exemplo 3 devolve os primeiros 30 utilizadores que correspondem ao SiteUrl https://contoso.sharepoint.com.
Parâmetros
-Filter
Aplicável: SharePoint Online
Limita os resultados apenas aos utilizadores cujo nome próprio, apelido ou endereço de e-mail começa com o texto na cadeia através de uma comparação não sensível a maiúsculas e minúsculas.
Propriedades do parâmetro
| Tipo: | System.String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 4 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-PageSize
Aplicável: SharePoint Online
Especifica o número máximo de usuários a serem retornados no conjunto.
O valor deve ser igual ou menor que 50.
Propriedades do parâmetro
| Tipo: | System.Int32 |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 3 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Position
Aplicável: SharePoint Online
Use para especificar o índice baseado em zero da posição no conjunto classificado do primeiro resultado a ser retornado.
Propriedades do parâmetro
| Tipo: | System.Int32 |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 2 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ShowOnlyUsersWithAcceptingAccountNotMatchInvitedAccount
Aplicável: SharePoint Online
Mostra os utilizadores que aceitaram um convite, mas que não utilizam a conta para a qual o convite foi enviado.
Propriedades do parâmetro
| Tipo: | System.Boolean |
| 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 |
-SiteUrl
Aplicável: SharePoint Online
Especifica o site para recuperação de usuários externos.
Se nenhum site for especificado, são retornados os usuários externos de todos os sites.
Propriedades do parâmetro
| Tipo: | System.String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 6 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-SortOrder
Aplicável: SharePoint Online
Especifica a classificação dos resultados em ordem Crescente ou Decrescente na propriedade SPOUser.Email que deve ocorrer.
Propriedades do parâmetro
| Tipo: | Microsoft.Online.SharePoint.TenantManagement.SortOrder |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 5 |
| Obrigatório: | False |
| 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.