Grant-SPObjectSecurity
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 $securityEn 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 |