Skip to content

SPConfigWizard

dscbot edited this page Mar 17, 2023 · 17 revisions

SPConfigWizard

Parameters

Parameter Attribute DataType Description Allowed Values
IsSingleInstance Key String Specifies the resource is a single instance, the value must be 'Yes' Yes
Ensure Write String Present to run the Configuration Wizard. Absent is currently not supported Present, Absent
DatabaseUpgradeDays Write StringArray[] Specify on which dates running the Configuration Wizard is allowed mon, tue, wed, thu, fri, sat, sun
DatabaseUpgradeTime Write String Specify in which time frame running the Configuration Wizard is allowed

Description

Type: Utility Requires CredSSP: No

This resource is used to perform the upgrade step of installing SharePoint updates, like Cumulative Updates, Service Packs and Language Packs. The DatabaseUpgradeDays and DatabaseUpgradeTime parameters specify a window in which the update can be installed. This module has to be used to complete the update installation step, performed by SPProductUpdate.

Examples

Example 1

This example runs the Configuration Wizard as soon as it is applied.

    Configuration Example
    {
        param
        (
            [Parameter(Mandatory = $true)]
            [PSCredential]
            $SetupAccount
        )

        Import-DscResource -ModuleName SharePointDsc

        node localhost
        {
            SPConfigWizard RunConfigWizard
            {
                IsSingleInstance     = "Yes"
                PsDscRunAsCredential = $SetupAccount
            }
        }
    }

Example 2

This example only runs the Configuration Wizard in the specified window:

  • Saturday and Sunday night between 3am and 5am.
Configuration Example
{
    param
    (
        [Parameter(Mandatory = $true)]
        [PSCredential]
        $SetupAccount
    )

    Import-DscResource -ModuleName SharePointDsc

    node localhost
    {
        SPConfigWizard RunConfigWizard
        {
            IsSingleInstance     = "Yes"
            DatabaseUpgradeDays  = "sat", "sun"
            DatabaseUpgradeTime  = "3:00am to 5:00am"
            PsDscRunAsCredential = $SetupAccount
        }
    }
}
Clone this wiki locally