Condividi tramite


Get-SPUser

Restituisce uno o più account utente corrispondenti ai criteri di ricerca specificati.

Sintassi

Get-SPUser
   [[-Identity] <SPUserPipeBind>]
   -Web <SPWebPipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Group <SPGroupPipeBind>]
   [-Limit <String>]
   [<CommonParameters>]

Descrizione

Il cmdlet Get-SPUser restituisce tutti gli account utente di SharePoint che corrispondono all'ambito specificato dal parametro Identity, Web o Group.

Il parametro Identity può utilizzare l'alias di un utente per restituire corrispondenze esatte.

Per le autorizzazioni e le informazioni più recenti su Windows PowerShell per i prodotti SharePoint, vedere la documentazione online nella pagina Cmdlet server SharePoint.

Esempio

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

Get-SPUser -Web 'https://sharepoint.contoso.com' -Group 'Viewers'

In questo esempio vengono restituiti tutti i membri del gruppo di SharePoint Visualizzatori nel sito https://sharepoint.contoso.com.

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

Get-SPUser -Identity 'i:0#.w|contoso\jdoe' -Web 'https://sharepoint.contoso.com'

In questo esempio viene restituito l'utente specifico identificato tramite attestazioni Windows nel sito https://sharepoint.contoso.com.

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

Get-SPUser -Identity 'contoso\jdoe' -Web 'https://sharepoint.contoso.com'

In questo esempio viene restituito l'utente specifico identificato tramite la autenticazione di Windows classica nel sito https://sharepoint.contoso.com.

Parametri

-AssignmentCollection

Consente di gestire gli oggetti ai fini della corretta eliminazione dalla memoria. Oggetti quali SPWeb o SPSite richiedono quantità di memoria elevate e per utilizzarli negli script Windows PowerShell è necessario gestire la memoria in modo appropriato. Tramite l'oggetto SPAssignment è possibile assegnare oggetti a una variabile ed eliminarli quando è necessario liberare memoria. Gli oggetti SPWeb, SPSite e SPSiteAdministration utilizzati vengono automaticamente eliminati dalla memoria se non viene utilizzato un insieme di assegnazioni o il parametro Global.

Quando viene utilizzato il parametro Global, tutti gli oggetti vengono memorizzati nell'area di archiviazione globale. Se gli oggetti non vengono utilizzati immediatamente o eliminati dalla memoria tramite il comando Stop-SPAssignment, può verificarsi una condizione di memoria insufficiente.

Type:SPAssignmentCollection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Group

Specifica il gruppo di utenti a cui appartiene il nuovo utente.

Type:SPGroupPipeBind
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Identity

Specifica l'ID o il nome di accesso dell'utente da restituire.

Il tipo deve essere un ID o un nome di accesso valido, ad esempio il formato 'CONTOSO\jdoe' per l'autenticazione classica di Windows o 'i:0#.w| CONTOSO\jdoe' per attestazioni windows.

Type:SPUserPipeBind
Aliases:UserAlias
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Limit

Specifica il numero massimo di utenti da restituire. Il valore predefinito è 500.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Web

Specifica il sito Web da utilizzare come ambito.

Il tipo deve essere un GUID valido, nel formato 12345678-90ab-cdef-1234-567890bcdefgh; un nome valido di un sito Web di SharePoint Foundation (ad esempio, MySPSite1); o un'istanza di un oggetto SPWeb valido.

Type:SPWebPipeBind
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019