SPCacheAccounts

SPCacheAccounts

Parameters

Parameter	Attribute	DataType	Description	Allowed Values
WebAppUrl	Key	string	The URL of the web application to set the accounts for
SuperUserAlias	Required	string	The account name for the super user
SuperReaderAlias	Required	string	The account name for the super reader
SetWebAppPolicy	Write	boolean	Should the web app policy be set for these accounts?
InstallAccount	Write	PSCredential	POWERSHELL 4 ONLY: The account to run this resource as, use PsDscRunAsCredential if using PowerShell 5

Description

Type: Distributed Requires CredSSP: No

This resource is used to set the "super user" and "super reader" cache accounts for the specified web application object (as described in the TechNet article Configure object cache user accounts in SharePoint Server 2013).

Examples

Example 1

This example sets the super use and reader accounts for the specified web app. It will also set the appropriate web app policies by default for these accounts.

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

        node localhost {
            SPCacheAccounts SetCacheAccounts
            {
                WebAppUrl            = "http://sharepoint.contoso.com"
                SuperUserAlias       = "DEMO\svcSPSuperUser"
                SuperReaderAlias     = "DEMO\svcSPReader"
                PsDscRunAsCredential = $SetupAccount
            }
        }
    }

Example 2

This example sets the super use and reader accounts for the specified web app. It will not set the web app policies for these accounts though, allowing them to be controlled elsewhere (either manually or with SPWebAppPolicy)

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

        node localhost {
            SPCacheAccounts SetCacheAccounts
            {
                WebAppUrl            = "http://sharepoint.contoso.com"
                SuperUserAlias       = "DEMO\svcSPSuperUser"
                SuperReaderAlias     = "DEMO\svcSPReader"
                SetWebAppPolicy      = $false
                PsDscRunAsCredential = $SetupAccount
            }
        }
    }