Compartir a través de

Set-SPAppPrincipalPermission

Módulo:
SharePointServer module

Establece los permisos de una entidad de seguridad de aplicaciones especificada.

Sintaxis

Default (Es el valor predeterminado). 

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

Aplicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica el objeto AppPrincipal.

Propiedades del parámetro

Tipo:SPAppPrincipal
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-AssignmentCollection

Aplicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propiedades del parámetro

Tipo:SPAssignmentCollection
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Confirm

Aplicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Le pide confirmación antes de ejecutar el comando. Para obtener más información, escriba el siguiente comando: get-help about_commonparameters

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:cf

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-EnableAppOnlyPolicy

Aplicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Right

Aplicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica el nivel de permisos del objeto de entidad de seguridad.

Puede aplicar cualquiera de los siguientes niveles:

--Leer

--Escribir

--Gestionar

--Control total

Propiedades del parámetro

Tipo:SPCmdletAppPrincipalPermissionKind
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Scope

Aplicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propiedades del parámetro

Tipo:SPCmdletAppPrincipalPermissionScope
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Site

Aplicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica el sitio (es decir, el objeto SPWeb) que se está estableciendo appPrincipalPermission.

Propiedades del parámetro

Tipo:SPWebPipeBind
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-WhatIf

Aplicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:Wi

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.