SharePointDSC

1.0.0.0

DSCResources/MSFT_SPWeb/MSFT_SPWeb.psm1

function Get-TargetResource
{
    [CmdletBinding()]
    [OutputType([System.Collections.Hashtable])]
    param
    (
        [parameter(Mandatory = $true)]    [System.String]  $Url,
        [parameter(Mandatory = $false)]
        [ValidateSet("Present","Absent")] [System.String]  $Ensure = "Present",
        [parameter(Mandatory = $false)]   [System.String]  $Description,
        [parameter(Mandatory = $false)]   [System.String]  $Name,
        [parameter(Mandatory = $false)]   [System.UInt32]  $Language,
        [parameter(Mandatory = $false)]   [System.String]  $Template,
        [parameter(Mandatory = $false)]   [System.Boolean] $UniquePermissions,
        [parameter(Mandatory = $false)]   [System.Boolean] $UseParentTopNav,
        [parameter(Mandatory = $false)]   [System.Boolean] $AddToQuickLaunch,
        [parameter(Mandatory = $false)]   [System.Boolean] $AddToTopNav,
        [parameter(Mandatory = $false)]   [System.Management.Automation.PSCredential] $InstallAccount
    )

    Write-Verbose -Message "Getting SPWeb '$Url'"

    $result = Invoke-SPDSCCommand -Credential $InstallAccount -Arguments $PSBoundParameters -ScriptBlock {
        $params = $args[0]
        
        $web = Get-SPWeb -Identity $params.Url -ErrorAction SilentlyContinue

        if ($web) { 
        
            $ensureResult   = "Present" 
            $templateResult = "$($web.WebTemplate)#$($web.WebTemplateId)"
            $parentTopNav   = $web.Navigation.UseShared

        } else { 
        
            $ensureResult = "Absent" 
        }
        
        return @{
                Url               = $web.Url
                Ensure            = $ensureResult
                Description       = $web.Description
                Name              = $web.Title
                Language          = $web.Language
                Template          = $templateResult
                UniquePermissions = $web.HasUniquePerm
                UseParentTopNav   = $parentTopNav
        }
    }

    return $result
}


function Set-TargetResource
{
    [CmdletBinding()]
    param
    (
        [parameter(Mandatory = $true)]    [System.String]  $Url,
        [parameter(Mandatory = $false)]
        [ValidateSet("Present","Absent")] [System.String]  $Ensure = "Present",
        [parameter(Mandatory = $false)]   [System.String]  $Description,
        [parameter(Mandatory = $false)]   [System.String]  $Name,
        [parameter(Mandatory = $false)]   [System.UInt32]  $Language,
        [parameter(Mandatory = $false)]   [System.String]  $Template,
        [parameter(Mandatory = $false)]   [System.Boolean] $UniquePermissions,
        [parameter(Mandatory = $false)]   [System.Boolean] $UseParentTopNav,
        [parameter(Mandatory = $false)]   [System.Boolean] $AddToQuickLaunch,
        [parameter(Mandatory = $false)]   [System.Boolean] $AddToTopNav,
        [parameter(Mandatory = $false)]   [System.Management.Automation.PSCredential] $InstallAccount
    )

    Write-Verbose -Message "Creating SPWeb '$Url'"
    
    $PSBoundParameters.Ensure = $Ensure

    Invoke-SPDSCCommand -Credential $InstallAccount -Arguments $PSBoundParameters -ScriptBlock {
        $params = $args[0]
        
        if ($null -eq $params.InstallAccount) 
        {    
            $currentUserName = "$env:USERDOMAIN\$env:USERNAME"
        } 
        else
        {    
            $currentUserName = $params.InstallAccount.UserName
        }
        
        Write-Verbose "Grant user '$currentUserName' Access To Process Identity for '$($params.Url)'..."  
        (New-Object -Type Microsoft.SharePoint.SPSite -ArgumentList $params.Url).WebApplication.GrantAccessToProcessIdentity($currentUserName)  
        
        $web = Get-SPWeb -Identity $params.Url -ErrorAction SilentlyContinue

        if ($null -eq $web) 
        {
            $params.Remove("InstallAccount") | Out-Null
            $params.Remove("Ensure") | Out-Null

            New-SPWeb @params | Out-Null
        }
        else
        {
            if ($params.Ensure -eq "Absent") {
                Remove-SPweb $params.Url -confirm:$false
            }else{
                
                $changedWeb = $false
                
                if ($web.Title -ne $params.Name) {
                    $web.Title = $params.Name
                    $changedWeb = $true
                }

                if ($web.Description -ne $params.Description) {
                    $web.Description = $params.Description
                    $changedWeb = $true
                }

                if ($web.Navigation.UseShared -ne $params.UseParentTopNav) {
                    $web.Navigation.UseShared = $params.UseParentTopNav
                    $changedWeb = $true
                }

                if ($web.HasUniquePerm -ne $params.UniquePermissions) {
                    $web.HasUniquePerm = $params.UniquePermissions
                    $changedWeb = $true
                }
                
                if ($changedWeb) {
                    
                    $web.Update()
                }
            }
        }
    }
}


function Test-TargetResource
{
    [CmdletBinding()]
    [OutputType([System.Boolean])]
    param
    (
        [parameter(Mandatory = $true)]    [System.String]  $Url,
        [parameter(Mandatory = $false)]
        [ValidateSet("Present","Absent")] [System.String]  $Ensure = "Present",
        [parameter(Mandatory = $false)]   [System.String]  $Description,
        [parameter(Mandatory = $false)]   [System.String]  $Name,
        [parameter(Mandatory = $false)]   [System.UInt32]  $Language,
        [parameter(Mandatory = $false)]   [System.String]  $Template,
        [parameter(Mandatory = $false)]   [System.Boolean] $UniquePermissions,
        [parameter(Mandatory = $false)]   [System.Boolean] $UseParentTopNav,
        [parameter(Mandatory = $false)]   [System.Boolean] $AddToQuickLaunch,
        [parameter(Mandatory = $false)]   [System.Boolean] $AddToTopNav,
        [parameter(Mandatory = $false)]   [System.Management.Automation.PSCredential] $InstallAccount
    )

    $PSBoundParameters.Ensure = $Ensure

    $CurrentValues = Get-TargetResource @PSBoundParameters

    Write-Verbose -Message "Testing SPWeb '$Url'"

    $valuesToCheck = @("Url", "Name", "Description", "UniquePermissions", "UseParentTopNav", "Ensure")

    return Test-SPDSCSpecificParameters -CurrentValues $CurrentValues -DesiredValues $PSBoundParameters -ValuesToCheck $valuesToCheck
}


Export-ModuleMember -Function *-TargetResource