Skip to content

SPUserProfileServiceAppPermissions

Yorick Kuijs edited this page Dec 27, 2017 · 20 revisions

SPUserProfileServiceAppPermissions

Parameters

Parameter Attribute DataType Description Allowed Values
ProxyName Key string The name of the proxy that is attached to the user profile service you wish to set permissions for
CreatePersonalSite Required string[] A list of user principals that will have the Create personal site permission
FollowAndEditProfile Required string[] A list of user principals that will have the Follow users and edit profile permission
UseTagsAndNotes Required string[] A list of user principals that will have the Use tags and notes permission
InstallAccount Write PSCredential POWERSHELL 4 ONLY: The account to run this resource as, use PsDscRunAsCredential if using PowerShell 5

Description

This resource will apply permissions to a user profile service application. These can control access to create my sites, use social features, and use tagging. If you want to allow all users the ability to use a specific permisisons include "Everyone" as a user in the corresponding property. To specify that there should be no permissions on a type, use "none"

Examples

Example 1

This example applies permissions for the user profile service application to limit access to specific features.

    Configuration Example 
    {
        param(
            [Parameter(Mandatory = $true)]
            [PSCredential]
            $SetupAccount
        )
        Import-DscResource -ModuleName SharePointDsc

        node localhost {
            SPUserProfileServiceAppPermissions UPAPermissions
            {
                ProxyName            = "User Profile Service Application Proxy"
                CreatePersonalSite   = @("DEMO\Group", "DEMO\User1")
                FollowAndEditProfile = @("Everyone")
                UseTagsAndNotes      = @("None")
                PsDscRunAsCredential = $SetupAccount
            }
        }
    }

Clone this wiki locally