Skip to content

SPCacheAccounts

Brian Farnhill edited this page Sep 21, 2016 · 18 revisions

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 String POWERSHELL 4 ONLY: The account to run this resource as, use PsDscRunAsCredential if using PowerShell 5

Description

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
        }
    }
}
Clone this wiki locally