Add-SPShellAdmin
Aggiunge un utente al ruolo SharePoint_Shell_Access per il database specificato.
Sintassi
Add-SPShellAdmin
[-UserName] <String>
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-database <SPDatabasePipeBind>]
[-WhatIf]
[<CommonParameters>] Descrizione
Quando si esegue questo cmdlet per aggiungere un utente al ruolo SharePoint_Shell_Access, è necessario essere membri del ruolo predefinito del server securityadmin per l'istanza di SQL Server, essere membri del ruolo predefinito del database db_owner per tutti i database interessati e disporre dell'autorizzazione di amministrazione locale nel computer locale.
Questo cmdlet deve essere usato solo con un database che usa autenticazione di Windows. Non è necessario usare questo cmdlet per i database che usano l'autenticazione SQL. in effetti, in questo modo potrebbe verificarsi un messaggio di errore.
Utilizzare il cmdlet Add-SPShellAdmin per aggiungere un utente al ruolo SharePoint_Shell_Access come segue:
- Se si specifica solo l'utente, questo verrà aggiunto al ruolo per il database di configurazione della farm.
- Se si utilizza il parametro database, l'utente verrà aggiunto al ruolo nel database di configurazione della farm, nel database del contenuto di Amministrazione centrale e nel database specificato. L'utilizzo del parametro database costituisce il metodo consigliato perché la maggior parte delle operazioni di amministrazione richiede l'accesso al database del contenuto di Amministrazione centrale.
Quando l'utente viene aggiunto al ruolo SharePoint_Shell_Access, viene aggiunto al gruppo WSS_Admin_WPG in tutti i server Web. Se il database di destinazione non dispone di un ruolo SharePoint_Shell_Access, tale ruolo verrà creato automaticamente.
Per usare Windows PowerShell per i prodotti SharePoint, un utente deve essere membro del ruolo SharePoint_Shell_Access nel database di configurazione e membro del gruppo locale WSS_ADMIN_WPG nel computer in cui è installato Prodotti SharePoint.
Tuttavia, il risultato dell'esecuzione di questo cmdlet è che l'utente specificato con il parametro UserName avrà il ruolo SPDataAccess , se esistente, o db_owner ruolo, se il ruolo SPDataAccess non esiste, nei database interessati, come descritto in precedenza. È pertanto consigliabile pianificare con attenzione gli utenti a cui viene concesso tale accesso.
È pertanto consigliabile pianificare con attenzione gli utenti a cui viene concesso tale accesso.
Per le autorizzazioni e le informazioni più aggiornate sulle Windows PowerShell per i prodotti SharePoint, vedere la documentazione online all'indirizzo https://go.microsoft.com/fwlink/p/?LinkId=251831.
Esempio
-------------------ESEMPIO 1-------------------------
Add-SPShellAdmin -UserName CONTOSO\User1Questo esempio consente di aggiungere un nuovo utente denominato User1 al ruolo SharePoint_Shell_Access solo nel database di configurazione della farm, garantendo inoltre che l'utente venga aggiunto al gruppo locale WSS_Admin_WPG in ogni server della farm.
-------------------ESEMPIO 2-------------------------
Add-SPShellAdmin -UserName CONTOSO\User1 -database 4251d855-3c15-4501-8dd1-98f960359fa6Questo esempio consente di aggiungere un nuovo utente denominato User1 al ruolo SharePoint_Shell_Access sia nel database del contenuto specificato che nel database di configurazione passando un GUID di database al cmdlet.
-------------------ESEMPIO 3-------------------------
Get-SPDatabase | Where-Object {$_.WebApplication -like "SPAdministrationWebApplication"} | Add-SPShellAdmin CONTOSO\User1Questo esempio consente di aggiungere un nuovo utente denominato User1 al ruolo SharePoint_Shell_Access sia nel database del contenuto di Amministrazione centrale specificato che nel database di configurazione.
-------------------ESEMPIO 4-------------------------
Get-SPDatabase | ?{$_.Name -eq "WSS_Content"} | Add-SPShellAdmin -Username CONTOSO\User1Questo esempio consente di aggiungere un nuovo utente denominato User1 al ruolo SharePoint_Shell_Access sia del database del contenuto specificato che del database di configurazione passando il nome del database al cmdlet.
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 |
-database
Specifica il GUID del database o l'oggetto del database che include il ruolo SharePoint_Shell_Access a cui si desidera aggiungere l'utente. Se non si specifica il parametro database, verrà utilizzato il database di configurazione. Il database di configurazione della farm verrà sempre incluso, anche se si specifica un altro database.
| Type: | SPDatabasePipeBind |
| 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 |
-UserName
Specifica il nome dell'utente da aggiungere al ruolo SharePoint_Shell_Access nel database di destinazione.
| 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 |
-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 |