Condividi tramite


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