-
Notifications
You must be signed in to change notification settings - Fork 107
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #166 from PowerShell/release-v0.10
Release v0.10
- Loading branch information
Showing
87 changed files
with
5,048 additions
and
89 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
151 changes: 151 additions & 0 deletions
151
...rePoint/DSCResources/MSFT_xSPHealthAnalyzerRuleState/MSFT_xSPHealthAnalyzerRuleState.psm1
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,151 @@ | ||
| function Get-TargetResource | ||
| { | ||
| [CmdletBinding()] | ||
| [OutputType([System.Collections.Hashtable])] | ||
| param | ||
| ( | ||
| [parameter(Mandatory = $true)] [System.String] $Name, | ||
| [parameter(Mandatory = $true)] [System.Boolean] $Enabled, | ||
| [parameter(Mandatory = $false)] [ValidateSet("All Servers","Any Server")] [System.String] $RuleScope, | ||
| [parameter(Mandatory = $false)] [ValidateSet("Hourly","Daily","Weekly","Monthly","OnDemandOnly")] [System.String] $Schedule, | ||
| [parameter(Mandatory = $false)] [System.Boolean] $FixAutomatically, | ||
| [parameter(Mandatory = $false)] [System.Management.Automation.PSCredential] $InstallAccount | ||
| ) | ||
|
|
||
| Write-Verbose -Message "Getting Health Rule configuration settings" | ||
|
|
||
| $result = Invoke-xSharePointCommand -Credential $InstallAccount -Arguments $PSBoundParameters -ScriptBlock { | ||
| $params = $args[0] | ||
|
|
||
| try { | ||
| $spFarm = Get-SPFarm | ||
| } catch { | ||
| Write-Verbose -Verbose "No local SharePoint farm was detected. Health Analyzer Rule settings will not be applied" | ||
| return $null | ||
| } | ||
|
|
||
| $caWebapp = Get-SPwebapplication -includecentraladministration | where {$_.IsAdministrationWebApplication} | ||
| if ($null -eq $caWebapp) { | ||
| Write-Verbose -Verbose "Unable to locate central administration website" | ||
| return $null | ||
| } | ||
|
|
||
| # Get CA SPWeb | ||
| $caWeb = Get-SPWeb($caWebapp.Url) | ||
| $healthRulesList = $caWeb.Lists | ? { $_.BaseTemplate -eq "HealthRules"} | ||
|
|
||
| if ($healthRulesList -ne $null) { | ||
| $spQuery = New-Object Microsoft.SharePoint.SPQuery | ||
| $querytext = "<Where><Eq><FieldRef Name='Title'/><Value Type='Text'>$($params.Name)</Value></Eq></Where>" | ||
| $spQuery.Query = $querytext | ||
| $results = $healthRulesList.GetItems($spQuery) | ||
| if ($results.Count -eq 1) { | ||
| $item = $results[0] | ||
|
|
||
| return @{ | ||
| # Set the Health Analyzer Rule settings | ||
| Name = $params.Name | ||
| Enabled = $item["HealthRuleCheckEnabled"] | ||
| RuleScope = $item["HealthRuleScope"] | ||
| Schedule = $item["HealthRuleSchedule"] | ||
| FixAutomatically = $item["HealthRuleAutoRepairEnabled"] | ||
| InstallAccount = $params.InstallAccount | ||
| } | ||
| } else { | ||
| Write-Verbose -Verbose "Unable to find specified Health Analyzer Rule" | ||
| return $null | ||
| } | ||
| } else { | ||
| Write-Verbose -Verbose "Unable to locate Health Analyzer Rules list" | ||
| return $null | ||
| } | ||
| } | ||
|
|
||
| return $result | ||
| } | ||
|
|
||
|
|
||
| function Set-TargetResource | ||
| { | ||
| [CmdletBinding()] | ||
| param | ||
| ( | ||
| [parameter(Mandatory = $true)] [System.String] $Name, | ||
| [parameter(Mandatory = $true)] [System.Boolean] $Enabled, | ||
| [parameter(Mandatory = $false)] [ValidateSet("All Servers","Any Server")] [System.String] $RuleScope, | ||
| [parameter(Mandatory = $false)] [ValidateSet("Hourly","Daily","Weekly","Monthly","OnDemandOnly")] [System.String] $Schedule, | ||
| [parameter(Mandatory = $false)] [System.Boolean] $FixAutomatically, | ||
| [parameter(Mandatory = $false)] [System.Management.Automation.PSCredential] $InstallAccount | ||
| ) | ||
|
|
||
| Write-Verbose -Message "Setting Health Analyzer Rule configuration settings" | ||
|
|
||
| Invoke-xSharePointCommand -Credential $InstallAccount -Arguments $PSBoundParameters -ScriptBlock { | ||
| $params = $args[0] | ||
|
|
||
| try { | ||
| $spFarm = Get-SPFarm | ||
| } catch { | ||
| throw "No local SharePoint farm was detected. Health Analyzer Rule settings will not be applied" | ||
| return | ||
| } | ||
|
|
||
| $caWebapp = Get-SPwebapplication -includecentraladministration | where {$_.IsAdministrationWebApplication} | ||
| if ($null -eq $caWebapp) { | ||
| throw "No Central Admin web application was found. Health Analyzer Rule settings will not be applied" | ||
| return | ||
| } | ||
|
|
||
| # Get Central Admin SPWeb | ||
| $caWeb = Get-SPWeb($caWebapp.Url) | ||
| $healthRulesList = $caWeb.Lists | ? { $_.BaseTemplate -eq "HealthRules"} | ||
|
|
||
| if ($healthRulesList -ne $null) { | ||
| $spQuery = New-Object Microsoft.SharePoint.SPQuery | ||
| $querytext = "<Where><Eq><FieldRef Name='Title'/><Value Type='Text'>$($params.Name)</Value></Eq></Where>" | ||
| $spQuery.Query = $querytext | ||
| $results = $healthRulesList.GetItems($spQuery) | ||
| if ($results.Count -eq 1) { | ||
| $item = $results[0] | ||
|
|
||
| $item["HealthRuleCheckEnabled"] = $params.Enabled | ||
| if ($params.ContainsKey("RuleScope")) { $item["HealthRuleScope"] = $params.RuleScope } | ||
| if ($params.ContainsKey("Schedule")) { $item["HealthRuleSchedule"] = $params.Schedule } | ||
| if ($params.ContainsKey("FixAutomatically")) { $item["HealthRuleAutoRepairEnabled"] = $params.FixAutomatically } | ||
|
|
||
| $item.Update() | ||
| } else { | ||
| throw "Could not find specified Health Analyzer Rule. Health Analyzer Rule settings will not be applied" | ||
| return | ||
| } | ||
| } else { | ||
| throw "Could not find Health Analyzer Rules list. Health Analyzer Rule settings will not be applied" | ||
| return | ||
| } | ||
| } | ||
| } | ||
|
|
||
|
|
||
| function Test-TargetResource | ||
| { | ||
| [CmdletBinding()] | ||
| [OutputType([System.Boolean])] | ||
| param | ||
| ( | ||
| [parameter(Mandatory = $true)] [System.String] $Name, | ||
| [parameter(Mandatory = $true)] [System.Boolean] $Enabled, | ||
| [parameter(Mandatory = $false)] [ValidateSet("All Servers","Any Server")] [System.String] $RuleScope, | ||
| [parameter(Mandatory = $false)] [ValidateSet("Hourly","Daily","Weekly","Monthly","OnDemandOnly")] [System.String] $Schedule, | ||
| [parameter(Mandatory = $false)] [System.Boolean] $FixAutomatically, | ||
| [parameter(Mandatory = $false)] [System.Management.Automation.PSCredential] $InstallAccount | ||
| ) | ||
|
|
||
| Write-Verbose -Message "Testing Health Analyzer rule configuration settings" | ||
| $CurrentValues = Get-TargetResource @PSBoundParameters | ||
|
|
||
| if ($null -eq $CurrentValues) { return $false } | ||
|
|
||
| return Test-xSharePointSpecificParameters -CurrentValues $CurrentValues -DesiredValues $PSBoundParameters | ||
| } | ||
|
|
||
| Export-ModuleMember -Function *-TargetResource |
30 changes: 30 additions & 0 deletions
30
...t/DSCResources/MSFT_xSPHealthAnalyzerRuleState/MSFT_xSPHealthAnalyzerRuleState.schema.mof
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,30 @@ | ||
| /* | ||
| **Description** | ||
|
|
||
| This resource is used to configure Health Analyzer rules for the local farm. | ||
| The resource is able to enable/disable and configure the specified rule. | ||
|
|
||
| **Example** | ||
|
|
||
| xSPHealthAnalyzerRuleState DisableDiskSpaceRule | ||
| { | ||
| Name = "Drives are at risk of running out of free space." | ||
| Enabled = $true | ||
| RuleScope = "All Servers" | ||
| Schedule = "Daily" | ||
| FixAutomatically = $false | ||
| InstallAccount = $InstallAccount | ||
| } | ||
| */ | ||
|
|
||
| [ClassVersion("1.0.0.0"), FriendlyName("xSPHealthAnalyzerRuleState")] | ||
| class MSFT_xSPHealthAnalyzerRuleState : OMI_BaseResource | ||
| { | ||
| [Key] String Name; | ||
| [Required] Boolean Enabled; | ||
| [Write, ValueMap{"All Servers","Any Server"}, Values{"All Servers","Any Server"}] String RuleScope; | ||
| [Write, ValueMap{"Hourly","Daily","Weekly","Monthly","OnDemandOnly"}, Values{"Hourly","Daily","Weekly","Monthly","OnDemandOnly"}] String Schedule; | ||
| [Write] Boolean FixAutomatically; | ||
| [Write, EmbeddedInstance("MSFT_Credential")] String InstallAccount; | ||
| }; | ||
|
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.