Grant-SPObjectSecurity
Aggiunge una nuova entità di sicurezza a un oggetto SPObjectSecurity.
Sintassi
Grant-SPObjectSecurity
[-Identity] <SPObjectSecurity>
[-Principal] <SPClaim>
[-Rights] <String[]>
[-AssignmentCollection <SPAssignmentCollection>]
[-Replace]
[<CommonParameters>]
Descrizione
Il cmdlet Grant-SPObjectSecurity aggiunge a un oggetto SPObjectSecurity una nuova entità di sicurezza, ad esempio un utente. Un oggetto SPObjectSecurity è un oggetto comune utilizzato per rappresentare l'elenco di controllo di accesso di sicurezza degli oggetti amministrativi di SharePoint, in particolare delle applicazioni di servizio.
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------------------
$principal = New-SPClaimsPrincipal "CONTOSO\JaneDoe" -IdentityType WindowsSamAccountName
$sa = Get-SPServiceApplication | ?{$_.TypeName -eq 'User Profile Service Application'}
$security = Get-SPServiceApplicationSecurity $sa -Admin
Grant-SPObjectSecurity $security $principal "Full Control"
Set-SPServiceApplicationSecurity $sa -Admin $security
In questo esempio viene recuperato l'oggetto SPObjectSecurity corrispondente all'ACL amministratore nell'applicazione del servizio profili utente e viene aggiunta una nuova entità utente all'ACL.
Il nuovo utente è un amministratore dell'applicazione di servizio $serviceApp.
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 |
-Identity
Specifica l'oggetto SPObjectSecurity a cui viene aggiunta la nuova entità di sicurezza. È possibile utilizzare il cmdlet Get-SPServiceApplicationSecurity per recuperare un oggetto SPObjectSecurity.
Type: | SPObjectSecurity |
Position: | 1 |
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 |
-Principal
Specifica l'entità a cui si applicano i diritti.
Il tipo deve essere un nome valido di un'entità, ad esempio Controllo completo.
Type: | SPClaim |
Position: | 2 |
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 |
-Replace
Sostituisce i diritti esistenti per l'oggetto SPObjectSecurity con i nuovi diritti specificati. Se non si specifica questo parametro, i nuovi diritti verranno aggiunti ai diritti esistenti.
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 |
-Rights
Specifica i diritti concessi all'entità.
Il tipo deve essere una matrice valida di stringhe che rappresenta i diritti concessi all'entità.
Type: | String[] |
Position: | 3 |
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 |