Grant-SPObjectSecurity
Adiciona uma nova entidade de segurança para um objeto SPObjectSecurity.
Syntax
Grant-SPObjectSecurity
[-Identity] <SPObjectSecurity>
[-Principal] <SPClaim>
[-Rights] <String[]>
[-AssignmentCollection <SPAssignmentCollection>]
[-Replace]
[<CommonParameters>]
Description
O cmdlet Grant-SPObjectSecurity adiciona uma nova entidade de segurança, como um usuário, a um objeto SPObjectSecurity. Um objeto SPObjectSecurity é um objeto comum que é usado para representar a ACL (lista de controle de acesso de segurança) de objetos administrativos do SharePoint, em particular, aplicativos de serviço.
Para obter as permissões e informações mais recentes sobre o Windows PowerShell para Produtos SharePoint, confira a documentação online em Cmdlets do SharePoint Server.
Exemplos
------------------EXEMPLO------------------
$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
Este exemplo recupera o objeto SPObjectSecurity correspondente à ACL do administrador no Aplicativo de Serviço de Perfil de Usuário e adiciona uma nova entidade de usuário a essa ACL.
O novo usuário é um administrador do aplicativo de serviço $serviceApp.
Parâmetros
-AssignmentCollection
Gerencia objetos para o devido descarte. O uso de objetos como SPWeb ou SPSite pode consumir grandes quantidades de memória e o uso desses objetos em scripts do Windows PowerShell requer gerenciamento de memória adequado. Usando o objeto SPAssignment, você poderá atribuir objetos a uma variável e descartar os objetos após o uso para liberar memória. Quando objetos SPWeb, SPSite ou SPSiteAdministration são usados, os objetos são automaticamente descartados se um conjunto de atribuições ou o parâmetro Global não forem usados.
Quando o parâmetro Global é usado, todos os objetos estão contidos no repositório global. Se os objetos não forem usados imediatamente ou forem descartados usando o comando Stop-SPAssignment, um cenário de falta de memória poderá ocorrer.
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
Especifica o objeto SPObjectSecurity para o qual a entidade de segurança é adicionada. Você pode usar o cmdlet Get-SPServiceApplicationSecurity para obter um objeto 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
Especifica a entidade de segurança à qual os direitos se aplicam.
O tipo deve ser um nome válido de entidade de segurança; por exemplo, Controle Total.
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
Substitui os direitos existentes no objeto SPObjectSecurity pelos novos direitos especificados. Caso esse parâmetro não seja especificado, os novos direitos serão adicionados aos direitos existentes.
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
Especifica os direitos concedidos à entidade de segurança.
O tipo deve ser uma matriz válida de cadeias de caracteres que represente os direitos concedidos à entidade de segurança.
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 |