Condividi tramite

Get-SPOExternalUser

  • Riferimento
Modulo:
Microsoft.Online.SharePoint.PowerShell
Si applica a:
SharePoint Online

Restituisce utenti esterni nel tenant.

Sintassi

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

Descrizione

Il Get-SPOExternalUser cmdlet restituisce gli utenti esterni che si trovano nel tenant in base ai criteri specificati.

Per le autorizzazioni e le informazioni più aggiornate su Windows PowerShell per SharePoint Online, vedere la documentazione online alla pagina https://go.microsoft.com/fwlink/p/?LinkId=251832.

Esempio

-----------------------ESEMPIO 1-----------------------------

Get-SPOExternalUser -Position 0 -PageSize 2

Nell'esempio 1 vengono restituiti i primi due utenti esterni dell'insieme.

-----------------------ESEMPIO 2-----------------------------

Get-SPOExternalUser -Position 2 -PageSize 2

Nell'esempio 2 vengono restituiti due utenti esterni dalla terza pagina dell'insieme.

-----------------------ESEMPIO 3-----------------------------

Get-SPOExternalUser -Position 0 -PageSize 30 -SiteUrl https://contoso.sharepoint.com

Nell'esempio 3 vengono restituiti i primi 30 utenti che corrispondono a SiteUrl https://contoso.sharepoint.com.

Parametri

-Filter

Limita i risultati solo agli utenti il cui nome, cognome o indirizzo di posta elettronica inizia con il testo nella stringa usando un confronto senza distinzione tra maiuscole e minuscole.

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

-PageSize

Specifica il numero massimo di utenti da restituire nell'insieme.

Il valore deve essere minore o uguale a 50.

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

-Position

Utilizzare questo parametro per specificare l'indice a base zero della posizione del primo risultato da restituire occupata nell'insieme ordinato.

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

-ShowOnlyUsersWithAcceptingAccountNotMatchInvitedAccount

Mostra gli utenti che hanno accettato un invito ma non usano l'account a cui è stato inviato l'invito.

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

-SiteUrl

Specifica il sito per il quale recuperare gli utenti esterni.

Se non è specificato alcun sito, verranno restituiti gli utenti esterni per tutti i siti.

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

-SortOrder

Specifica che i risultati devono essere visualizzati in ordine crescente o decrescente nella proprietà SPOUser.Email.

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