Set-SPAppPrincipalPermission
Establece los permisos de una entidad de seguridad de aplicaciones especificada.
Syntax
Set-SPAppPrincipalPermission
-AppPrincipal <SPAppPrincipal>
-Right <SPCmdletAppPrincipalPermissionKind>
-Scope <SPCmdletAppPrincipalPermissionScope>
-Site <SPWebPipeBind>
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-WhatIf]
[-EnableAppOnlyPolicy]
[<CommonParameters>]
Description
Use el Set-SPAppPrincipalPermission
cmdlet para establecer los permisos en una entidad de seguridad de aplicación determinada para un ámbito determinado (inquilino, colección de sitios y web) y niveles determinados (lectura, escritura, administración, control total).
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-------------
$clientID = "11111111-2222-3333-4444-555555555555"
$site = Get-SPSite https://siteUrl
$realm = Get-SPAuthenticationRealm -ServiceContext $site
$appIdentifier = $clientID + "@" + $realm
$appPrincipal = Get-SPAppPrincipal -NameIdentifier $appIdentifier -Site $site.RootWeb
Set-AppPrincipalPermission -AppPrincipal $appPrincipal -Site $site.RootWeb -Scope Site -Level Manage
En este ejemplo se establece el permiso de entidad de seguridad de aplicación para Administrar con un ámbito de Sitio.
Parámetros
-AppPrincipal
Especifica el objeto AppPrincipal.
Type: | SPAppPrincipal |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Confirm
Le pide confirmación antes de ejecutar el comando.
Para obtener más información, escriba el siguiente comando: get-help about_commonparameters
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-EnableAppOnlyPolicy
Especifica si se activa la única directiva de aplicación para la entidad de seguridad de la aplicación.
Los valores válidos son True y False. El valor predeterminado es False.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Right
Especifica el nivel de permisos del objeto de entidad de seguridad.
Puede aplicar cualquiera de los siguientes niveles:
--Leer
--Escribir
--Administrar
--Control total
Type: | SPCmdletAppPrincipalPermissionKind |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Scope
Especifica el ámbito en el que desea aplicar el permiso de la entidad de seguridad.
Puede aplicar cualquiera de los siguientes valores:
--Sitio
--SiteCollection
--SiteSubscription
Type: | SPCmdletAppPrincipalPermissionScope |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Site
Especifica el sitio (es decir, el objeto SPWeb) que se está estableciendo appPrincipalPermission.
Type: | SPWebPipeBind |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-WhatIf
Muestra un mensaje que describe el efecto del comando en lugar de ejecutar dicho comando.
Para obtener más información, escriba el siguiente comando: get-help about_commonparameters
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |