Grant-SPObjectSecurity

Referencia

Módulo:: SharePointServer

Se aplica a:: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Agrega una nueva entidad de seguridad a un objeto SPObjectSecurity.

Syntax

Grant-SPObjectSecurity
     [-Identity] <SPObjectSecurity>
     [-Principal] <SPClaim>
     [-Rights] <String[]>
     [-AssignmentCollection <SPAssignmentCollection>]
     [-Replace]
     [<CommonParameters>]

Description

El cmdlet Grant-SPObjectSecurity agrega una nueva entidad de seguridad, como un usuario, a un objeto SPObjectSecurity. Un objeto SPObjectSecurity es un objeto común que se usa para representar la lista de control de acceso de seguridad (ACL) de objetos administrativos de SharePoint, en particular, las aplicaciones de servicio.

Para obtener permisos y la información más reciente acerca de Windows PowerShell para Productos de SharePoint, vea la documentación en línea en Cmdlets de SharePoint Server.

Ejemplos

------------------EJEMPLO------------------

$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

En este ejemplo se recupera el objeto SPObjectSecurity correspondiente a la ACL de administrador en la aplicación de servicio de perfiles de usuario y se agrega una nueva entidad de seguridad de usuario a esa ACL.

El nuevo usuario es un administrador de la aplicación de servicio $serviceApp.

Parámetros

-AssignmentCollection

Administra objetos para su correcta eliminación. El uso de objetos como SPWeb o SPSite puede requerir una gran cantidad de memoria y su uso en scripts de Windows PowerShell requiere una administración adecuada de la memoria. Mediante el uso del objeto SPAssignment se pueden asignar objetos a una variable y eliminar los objetos cuando ya no sean necesarios para liberar memoria. Cuando se usan los objetos SPWeb, SPSite o SPSiteAdministration, los objetos se eliminan automáticamente si no se usa una colección de asignaciones o el parámetro Global.

Cuando se usa el parámetro Global, todos los objetos se guardan en el almacén global. Si los objetos no se usan de forma inmediata o se eliminan mediante el comando Stop-SPAssignment, puede producirse un error de memoria insuficiente.

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 el objeto SPObjectSecurity al que se agrega la nueva entidad de seguridad. Puede usar el cmdlet Get-SPServiceApplicationSecurity para obtener un 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 la entidad de seguridad a la que se aplican los derechos.

El tipo debe ser un nombre válido de entidad de seguridad, como, por ejemplo, Full Control.

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

Reemplaza los derechos existentes en el objeto SPObjectSecurity por los nuevos derechos especificados. Si este parámetro no se especifica, los nuevos derechos se agregarán a los ya 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 los derechos concedidos a la entidad de seguridad.

El tipo debe ser una matriz de cadenas válida que represente los derechos concedidos a la entidad de seguridad.

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