Set-SPAppPrincipalPermission

Définit les autorisations sur un principal d’application donné.

Syntax

Set-SPAppPrincipalPermission
   -AppPrincipal <SPAppPrincipal>
   -Right <SPCmdletAppPrincipalPermissionKind>
   -Scope <SPCmdletAppPrincipalPermissionScope>
   -Site <SPWebPipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-WhatIf]
   [-EnableAppOnlyPolicy]
   [<CommonParameters>]

Description

Utilisez l’applet Set-SPAppPrincipalPermission de commande pour définir les autorisations sur un principal d’application donné pour une étendue donnée (locataire, collection de sites et web) et des niveaux donnés (lecture, écriture, gestion, contrôle total).

Pour les autorisations et les informations les plus récentes sur Windows PowerShell pour les produits SharePoint, consultez la documentation en ligne sur les applets de commande SharePoint Server.

Exemples

---------------EXEMPLE-------------

$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

Cet exemple définit l’autorisation Principal d’application à gérer avec une étendue de site.

Paramètres

-AppPrincipal

Spécifie l'objet AppPrincipal.

Type:SPAppPrincipal
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-AssignmentCollection

Manages objects for the purpose of proper disposal. Use of objects, such as SPWeb or SPSite, can use large amounts of memory and use of these objects in Windows PowerShell scripts requires proper memory management. Using the SPAssignment object, you can assign objects to a variable and dispose of the objects after they are needed to free up memory. When SPWeb, SPSite, or SPSiteAdministration objects are used, the objects are automatically disposed of if an assignment collection or the Global parameter is not used.

When the Global parameter is used, all objects are contained in the global store. If objects are not immediately used, or disposed of by using the Stop-SPAssignment command, an out-of-memory scenario can occur.

Type:SPAssignmentCollection
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Confirm

Prompts you for confirmation before executing the command. For more information, type the following command: get-help about_commonparameters

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Droite

Spécifie le niveau d'autorisation pour l'objet principal de sécurité.

La valeur est l'un des niveaux suivants :

--Read

--Write

--Gérer

--Contrôle total

Type:SPCmdletAppPrincipalPermissionKind
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-EnableAppOnlyPolicy

Spécifie si la stratégie application seule est activée pour le principal d’application.

Les valeurs valides sont True et False. La valeur par défaut est False.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Portée

Spécifie l'étendue à laquelle appliquer l'autorisation de principal.

La valeur est l'une des étendues suivantes :

--Site

--SiteCollection

--SiteSubscription

Type:SPCmdletAppPrincipalPermissionScope
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Site

Spécifie le site (c’est-à-dire l’objet SPWeb) que l’AppPrincipalPermission est en cours de définition. a

Type:SPWebPipeBind
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-WhatIf

Affiche un message qui explique l’effet de la commande au lieu de l’exécuter. Pour plus d’informations, entrez la commande suivante : get-help about_commonparameters

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition