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 |