Skip to content

SPPasswordChangeSettings

Brian Farnhill edited this page Jul 3, 2017 · 19 revisions

Parameters

Parameter Attribute DataType Description Allowed Values
MailAddress key string The email address to send notifications of password changes to
DaysBeforeExpiry Write Uint32 The number of days before password expiry to send send emails
PasswordChangeWaitTimeSeconds Write Uint32 The duration that a password reset will wait for before it times out
NumberOfRetries Write Uint32 How many retries if the password change fails
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 control settings that relate to the automatic changing of passwords for managed accounts (where they opt-in to be managed by SharePoint). These settings can be manually controlled through central administration, or configured in this resource. The settings relate to email notifications of when passwords are reset, as well as behavior when a reset

Examples

Example 1

This example sets the password change settings for managed accounts in the local farm

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

    node localhost {
        SPPasswordChangeSettings ManagedAccountPasswordResetSettings
        {  
            MailAddress                   = "sharepoint`@contoso.com"
            DaysBeforeExpiry              = "14"
            PasswordChangeWaitTimeSeconds = "60"
            NumberOfRetries               = "3"
            PsDscRunAsCredential          = $SetupAccount
        }
    }
}

Clone this wiki locally