UMN-DSC.psm1
|
### # Copyright 2017 University of Minnesota, Office of Information Technology # This program is free software: you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation, either version 3 of the License, or # (at your option) any later version. # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU General Public License for more details. # You should have received a copy of the GNU General Public License # along with Foobar. If not, see <http://www.gnu.org/licenses/>. ### enum State { Enabled Disabled } enum Present { Present NotPresent } <# dsc CLASS to enable the IIS remote management service #> [DscResource()] class WebMgmtSvcState { # A DSC resource must define at least one key property. [DscProperty(Key)] [State]$state [DscProperty(NotConfigurable)] [string]$Key = "HKLM:\SOFTWARE\Microsoft\WebManagement\Server" [DscProperty(NotConfigurable)] [string]$ValueName = "EnableRemoteManagement" # Sets the desired state of the resource. [void] Set() { if ($this.state -eq [State]::Enabled) { ## Stop wmsvc Stop-Service wmsvc $ValueData = "1" New-ItemProperty -Path $this.Key -Name $this.ValueName -Value $ValueData -Force ## re-enable service start-service wmsvc } else { ## Stop wmsvc Stop-Service wmsvc $ValueData = "0" New-ItemProperty -Path $this.Key -Name $this.ValueName -Value $ValueData -Force ## re-enable service start-service wmsvc } } # Tests if the resource is in the desired state. [bool] Test() { if ($this.state -eq [State]::Enabled) { return ((Get-ItemPropertyValue -Path $this.Key -Name $this.ValueName) -eq 1) } else { return ((Get-ItemPropertyValue -Path $this.Key -Name $this.ValueName) -eq 0) } } # Gets the resource's current state. [WebMgmtSvcState] Get() { $curState = Get-ItemPropertyValue -Path $this.Key -Name $this.ValueName if ($curState -eq 1){$this.state = [State]::Enabled} else {$this.state = [State]::Disabled} # Return this instance or construct a new instance. return $this } } # [DscResource()] indicates the class is a DSC resource. [DscResource()] class PackageProvider { # A DSC resource must define at least one key property. [DscProperty(Key)] [Present]$present # Mandatory indicates the property is required and DSC will guarantee it is set. [DscProperty(Mandatory)] [string]$packageProvider # Sets the desired state of the resource. [void] Set() { if ($this.present -eq [Present]::Present){Install-PackageProvider -Name $this.packageProvider -MinimumVersion 2.8.5.201 -Force} # there doesn't seam to be a uninstall } # Tests if the resource is in the desired state. [bool] Test() { if ($this.present -eq [Present]::Present) { try{if((Get-PackageProvider -Name $this.packageProvider).Name -eq $this.packageProvider){return $true}else{return $false}} catch{return $false} } else{ try{if((Get-PackageProvider -Name $this.packageProvider).Name -eq $this.packageProvider){return $false}else{return $true}} catch{return $true} } } # Gets the resource's current state. [PackageProvider] Get() { try{if((Get-PackageProvider -Name $this.packageProvider).Name -eq $this.packageProvider){$this.present = [Present]::Present}else{$this.present = [Present]::NotPresent}} catch{$this.present = [Present]::NotPresent} return $this } } # The docker package is all jacked up. Once you install it and logout, get-package will not return it so the test is broken # hence the need for this goof thing [DscResource()] class PackageDocker { # A DSC resource must define at least one key property. [DscProperty(Key)] [Present]$present # Sets the desired state of the resource. [void] Set() { if ($this.present -eq [Present]::Present){Install-Package -Name docker -ProviderName DockerMsftProvider -Confirm:$false -Force} } # Tests if the resource is in the desired state. [bool] Test() { if ($this.present -eq [Present]::Present) { if(Test-Path -Path 'C:\Program Files\Docker'){return $true}else{return $false} } else{ if(Test-Path -Path 'C:\Program Files\Docker'){return $false}else{return $true} } } # Gets the resource's current state. [PackageDocker] Get() { if(Test-Path -Path 'C:\Program Files\Docker'){$this.present = [Present]::Present}else{$this.present = [Present]::NotPresent} return $this } } # [DscResource()] indicates the class is a DSC resource. [DscResource()] class cModule { # A DSC resource must define at least one key property. [DscProperty(Mandatory)] [Present]$present # Mandatory indicates the property is required and DSC will guarantee it is set. [DscProperty(Key)] [string]$module [string]$requiredVersion # Sets the desired state of the resource. [void] Set() { if ($this.present -eq [Present]::Present) { if ($this.requiredVersion){Install-Module -Name $this.module -RequiredVersion $this.requiredVersion -Force;Restart-Computer} else{Install-Module -Name $this.module -Force;Restart-Computer} } else{ if ($this.requiredVersion){Uninstall-Module -Name $this.module -RequiredVersion $this.requiredVersion -Force} else{Uninstall-Module -Name $this.module -Force} } # there doesn't seam to be a uninstall } # Tests if the resource is in the desired state. [bool] Test() { $mod = Get-Module -Name $this.module -ListAvailable if ($this.present -eq [Present]::Present) { if ($this.requiredVersion){if ($mod.Version -eq $this.requiredVersion){return $true}else{return $false}} else{if($mod -ne $null){return $true}else{return $false}} } else{ if ($this.requiredVersion){if ($mod.Version -eq $this.requiredVersion){return $false}else{return $true}} else{if($mod -ne $null){return $false}else{return $true}} } } # Gets the resource's current state. [cModule] Get() { $mod = Get-Module -Name $this.module -ListAvailable if ($this.requiredVersion){if ($mod.Version -eq $this.requiredVersion){$this.present = [Present]::Present}else{$this.present = [Present]::NotPresent}} else{if($mod -ne $null){$this.present = [Present]::Present}else{$this.present = [Present]::NotPresent}} return $this } } # [DscResource()] class DockerTransNet { # A DSC resource must define at least one key property. [DscProperty(Key)] [Present]$present # Mandatory indicates the property is required and DSC will guarantee it is set. [DscProperty(Mandatory)] [string]$name [DscProperty(Mandatory)] [string]$interfaceName # Sets the desired state of the resource. [void] Set() { $ErrorActionPreference = 'Stop' if ($this.present -eq [Present]::Present) { ## Validate InterfaceName exits # (Get-NetIPInterface -AddressFamily IPv4 | Where-Object {$_.InterfaceAlias -notlike "*Loopback*"}).InterfaceAlias # single nic instance or containers with dynamic Interface names try{ if (Get-NetAdapter -Name $this.interfaceName) { docker network create -d transparent -o com.docker.network.windowsshim.interface=$($this.interfaceName) $($this.name) } else{Throw "Unable to Find Network Interface"} }catch{Throw "Unable to Find Network Interface"} } } # Tests if the resource is in the desired state. [bool] Test() { $ErrorActionPreference = 'Stop' if ($this.present -eq [Present]::Present) { try{if ((docker network inspect $($this.name) | ConvertFrom-Json).Name -eq $this.name){return $true}else{return $false}} catch{return $false} } else{ try{if ((docker network inspect $($this.name) | ConvertFrom-Json).Name -eq $this.name){return $false}else{return $true}} catch{return $true} } } # Gets the resource's current state. [DockerTransNet] Get() { $ErrorActionPreference = 'Stop' try{if ((docker network inspect $($this.name) | ConvertFrom-Json).Name -eq $this.name){$this.present = [Present]::Present}else{$this.present = [Present]::NotPresent}} catch{$this.present = [Present]::NotPresent} return $this } } |