DSCResources/MSFT_xWebSiteDefaults/MSFT_xWebSiteDefaults.psm1
|
$script:resourceModulePath = Split-Path -Path (Split-Path -Path $PSScriptRoot -Parent) -Parent $script:modulesFolderPath = Join-Path -Path $script:resourceModulePath -ChildPath 'Modules' $script:localizationModulePath = Join-Path -Path $script:modulesFolderPath -ChildPath 'xWebAdministration.Common' Import-Module -Name (Join-Path -Path $script:localizationModulePath -ChildPath 'xWebAdministration.Common.psm1') # Import Localization Strings $script:localizedData = Get-LocalizedData -ResourceName 'MSFT_xWebSiteDefaults' function Get-TargetResource { <# .SYNOPSIS This will return a hashtable of results #> [CmdletBinding()] [OutputType([System.Collections.Hashtable])] param ( [Parameter(Mandatory = $true)] [ValidateSet('Yes')] [String] $IsSingleInstance ) Assert-Module Write-Verbose -Message $script:localizedData.VerboseGetTargetResource return @{ LogFormat = (Get-Value 'siteDefaults/logFile' 'logFormat') TraceLogDirectory = ( Get-Value 'siteDefaults/traceFailedRequestsLogging' 'directory') DefaultApplicationPool = (Get-Value 'applicationDefaults' 'applicationPool') AllowSubDirConfig = (Get-Value 'virtualDirectoryDefaults' 'allowSubDirConfig') IsSingleInstance = 'Yes' LogDirectory = (Get-Value 'siteDefaults/logFile' 'directory') } } function Set-TargetResource { <# .SYNOPSIS This will set the desired state .NOTES Only a limited number of settings are supported at this time We try to cover the most common use cases We have a single parameter for each setting #> [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSDSCUseVerboseMessageInDSCResource", "")] [CmdletBinding()] param ( [Parameter(Mandatory = $true)] [ValidateSet('Yes')] [String] $IsSingleInstance, [Parameter()] [ValidateSet('W3C','IIS','NCSA','Custom')] [String] $LogFormat, [Parameter()] [String] $LogDirectory, [Parameter()] [String] $TraceLogDirectory, [Parameter()] [String] $DefaultApplicationPool, [Parameter()] [ValidateSet('true','false')] [String] $AllowSubDirConfig ) Assert-Module Set-Value -Path 'siteDefaults/logFile' -Name 'logFormat' -NewValue $LogFormat Set-Value -Path 'siteDefaults/logFile' -Name 'directory' -NewValue $LogDirectory Set-Value -Path 'siteDefaults/traceFailedRequestsLogging' -Name 'directory' -NewValue $TraceLogDirectory Set-Value -Path 'applicationDefaults' -Name 'applicationPool' -NewValue $DefaultApplicationPool Set-Value -Path 'virtualDirectoryDefaults' -Name 'allowSubDirConfig' -NewValue $AllowSubDirConfig } function Test-TargetResource { <# .SYNOPSIS This tests the desired state. If the state is not correct it will return $false. If the state is correct it will return $true #> [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSDSCUseVerboseMessageInDSCResource", "")] [OutputType([System.Boolean])] param ( [Parameter(Mandatory = $true)] [ValidateSet('Yes')] [String] $IsSingleInstance, [Parameter()] [ValidateSet('W3C','IIS','NCSA','Custom')] [String] $LogFormat, [Parameter()] [String] $LogDirectory, [Parameter()] [String] $TraceLogDirectory, [Parameter()] [String] $DefaultApplicationPool, [Parameter()] [ValidateSet('true','false')] [String] $AllowSubDirConfig ) Assert-Module # check for the various given settings: if (-not(Confirm-Value -Path 'virtualDirectoryDefaults' ` -Name 'allowSubDirConfig' ` -NewValue $AllowSubDirConfig)) { return $false } if (-not(Confirm-Value -Path 'siteDefaults/logFile' ` -Name 'logFormat' ` -NewValue $LogFormat)) { return $false } if (-not(Confirm-Value -Path 'siteDefaults/logFile' ` -Name 'directory' ` -NewValue $LogDirectory)) { return $false } if (-not(Confirm-Value -Path 'siteDefaults/traceFailedRequestsLogging' ` -Name 'directory' ` -NewValue $TraceLogDirectory)) { return $false } if (-not(Confirm-Value -Path 'applicationDefaults' ` -Name 'applicationPool' ` -NewValue $DefaultApplicationPool)) { return $false } return $true } #region Helper Functions function Confirm-Value { [OutputType([System.Boolean])] [CmdletBinding()] param ( [Parameter()] [String] $Path, [Parameter()] [String] $Name, [Parameter()] [String] $NewValue ) if (-not($NewValue)) { return $true } $existingValue = Get-Value -Path $Path -Name $Name if ($existingValue -ne $NewValue) { return $false } else { $relPath = $Path + '/' + $Name Write-Verbose($script:localizedData.ValueOk -f $relPath,$NewValue); return $true } } function Set-Value { [CmdletBinding()] param ( [Parameter()] [String] $Path, [Parameter()] [String] $Name, [Parameter()] [String] $NewValue ) # if the variable doesn't exist, the user doesn't want to change this Value if (-not($NewValue)) { return } # get the existing Value to compare $existingValue = Get-Value -Path $Path -Name $Name if ($existingValue -ne $NewValue) { Set-WebConfigurationProperty -PSPath 'MACHINE/WEBROOT/APPHOST' ` -Filter "system.applicationHost/sites/$Path" ` -Name $Name ` -Value "$NewValue" $relPath = $Path + '/' + $Name Write-Verbose($script:localizedData.SettingValue -f $relPath,$NewValue); } } function Get-Value { [CmdletBinding()] param ( [Parameter()] [String] $Path, [Parameter()] [String] $Name ) return Get-WebConfigurationProperty -PSPath 'MACHINE/WEBROOT/APPHOST' ` -Filter "system.applicationHost/sites/$Path" ` -Name $Name } #endregion Export-ModuleMember -Function *-TargetResource |