New-SPUser

Riferimento

Modulo:: SharePointServer

Si applica a:: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Aggiunge un utente esistente a un sito di SharePoint con le autorizzazioni designate.

Sintassi

New-SPUser
   [-UserAlias] <String>
   -Web <SPWebPipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-DisplayName <String>]
   [-Email <String>]
   [-Group <SPGroupPipeBind>]
   [-PermissionLevel <String[]>]
   [-SiteCollectionAdmin]
   [-WhatIf]
   [<CommonParameters>]

Descrizione

Il New-SPUser cmdlet aggiunge un utente esistente a un sito Web di SharePoint con le autorizzazioni designate. Questo utente disporrà delle autorizzazioni assegnate in tutti i siti secondari che ereditano le autorizzazioni. È necessario che l'account utente esista già nella directory degli utenti.

In un ambiente in modalità Active Directory è necessario che l'utente esista già in Servizi di dominio Active Directory ed è richiesto solo il parametro UserAlias perché tutti gli altri campi vengono recuperati da Servizi di dominio Active Directory. Se si specifica solo un alias e per la farm è attivata la modalità di creazione account di Active Directory, è richiesto anche il parametro Email.

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----------------------

New-SPUser -UserAlias 'Contoso\Jdow'-DisplayName 'Jane Dow' -Web https://contoso.com

In questo esempio viene aggiunto un nuovo utente denominato Jane Dow al dominio Contoso.

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

Get-SPWeb https://sitename | New-SPUser -UserAlias Contoso\Jdow

Questo esempio aggiunge Contoso\Jdow a tutti i web della https://sitename raccolta siti. Poiché la raccolta siti utilizza autorizzazioni ereditate, è necessario intervenire solo sul sito Web principale.

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

-Confirm

Richiede la conferma prima di eseguire il comando. Per ulteriori informazioni, digitare il comando seguente: get-help about_commonparameters

Type:	SwitchParameter
Aliases:	cf
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

-DisplayName

Specifica una stringa che contiene il nome visualizzato dell'utente.

Il tipo deve essere un nome utente valido, ad esempio Luca.

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

-Email

Specifica l'indirizzo di posta elettronica del nuovo utente.

Il tipo deve essere un indirizzo di posta elettronica valido nel formato someone@contoso.com.

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

-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

-PermissionLevel

Aggiunge un utente a un livello di autorizzazione.

Il tipo deve essere un livello di autorizzazione valido per l'applicazione Web, ad esempio Full Control, Read, Contribute o All.

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

-SiteCollectionAdmin

Specifica se aggiungere l'utente come amministratore nella raccolta siti.

Type:	SwitchParameter
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

-UserAlias

Specifica l'alias dell'utente di Servizi di dominio Active Directory (AD DS).

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

-Web

Specifica l'URL o il GUID del sito Web in cui creare l'utente.

Il tipo deve essere un URL valido nel formato https://server_name oppure un GUID nel formato 1234-5678-9876-0987.

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

-WhatIf

Visualizza un messaggio che illustra gli effetti del comando anziché eseguire il comando. Per ulteriori informazioni, digitare il comando seguente: get-help about_commonparameters

Type:	SwitchParameter
Aliases:	wi
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

Condividi tramite