Partilhar via

Get-SPOExternalUser

  • Referência
Módulo:
Microsoft.Online.SharePoint.PowerShell
Aplica-se a:
SharePoint Online

Retorna usuários externos no locatário.

Syntax

Get-SPOExternalUser
   [[-Position] <Int32>]
   [[-PageSize] <Int32>]
   [[-Filter] <String>]
   [[-SortOrder] <SortOrder>]
   [[-SiteUrl] <String>]
   [-ShowOnlyUsersWithAcceptingAccountNotMatchInvitedAccount <Boolean>]
   [<CommonParameters>]

Description

O Get-SPOExternalUser cmdlet retorna usuários externos localizados no locatário com base nos critérios especificados.

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-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 retorna os primeiros 30 usuários que correspondem ao SiteUrl https://contoso.sharepoint.com.

Parâmetros

-Filter

Limita os resultados apenas aos usuários cujo nome, sobrenome ou endereço de email começa com o texto na cadeia de caracteres usando uma comparação sem maiúsculas de maiúsculas de minúsculas.

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

-PageSize

Especifica o número máximo de usuários a serem retornados no conjunto.

O valor deve ser igual ou menor que 50.

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

-Position

Use para especificar o índice baseado em zero da posição no conjunto classificado do primeiro resultado a ser retornado.

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

-ShowOnlyUsersWithAcceptingAccountNotMatchInvitedAccount

Mostra aos usuários que aceitaram um convite, mas não usaram a conta para a qual o convite foi enviado.

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

-SiteUrl

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.

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

-SortOrder

Especifica a classificação dos resultados em ordem Crescente ou Decrescente na propriedade SPOUser.Email que deve ocorrer.

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