DSCResources/VE_XD7Administrator/VE_XD7Administrator.psm1
|
Import-LocalizedData -BindingVariable localizedData -FileName VE_XD7Administrator.Resources.psd1; function Get-TargetResource { [CmdletBinding()] [Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSAvoidUsingEmptyCatchBlock', '')] [OutputType([System.Collections.Hashtable])] param ( [Parameter(Mandatory)] [ValidateNotNullOrEmpty()] [System.String] $Name, [Parameter()] [AllowNull()] [System.Management.Automation.PSCredential] [System.Management.Automation.CredentialAttribute()] $Credential, [Parameter()] [ValidateSet('Present','Absent')] [System.String] $Ensure = 'Present', [Parameter()] [ValidateNotNullOrEmpty()] [System.Boolean] $Enabled = $true ) begin { AssertXDModule -Name 'Citrix.DelegatedAdmin.Admin.V1' -IsSnapin; } process { $scriptBlock = { Add-PSSnapin -Name 'Citrix.DelegatedAdmin.Admin.V1' -ErrorAction Stop; try { $xdAdministrator = Get-AdminAdministrator -Name $using:Name -ErrorAction SilentlyContinue; } catch { } $targetResource = @{ Name = $using:Name; Enabled = [System.Boolean] $xdAdministrator.Enabled; Ensure = 'Absent'; }; if ($xdAdministrator) { $targetResource['Ensure'] = 'Present'; } return $targetResource; } #end scriptblock $invokeCommandParams = @{ ScriptBlock = $scriptBlock; ErrorAction = 'Stop'; } Write-Verbose ($localizedData.InvokingScriptBlockWithParams -f [System.String]::Join("','", @($Name, $Enabled, $Ensure))); if ($Credential) { AddInvokeScriptBlockCredentials -Hashtable $invokeCommandParams -Credential $Credential; $targetResource = Invoke-Command @invokeCommandParams; } else { $invokeScriptBlock = [System.Management.Automation.ScriptBlock]::Create($scriptBlock.ToString().Replace('$using:','$')); $targetResource = InvokeScriptBlock -ScriptBlock $invokeScriptBlock; } return $targetResource; } #end process } #end function Get-TargetResource function Test-TargetResource { [CmdletBinding()] [OutputType([System.Boolean])] param ( [Parameter(Mandatory)] [ValidateNotNullOrEmpty()] [System.String] $Name, [Parameter()] [AllowNull()] [System.Management.Automation.PSCredential] [System.Management.Automation.CredentialAttribute()] $Credential, [Parameter()] [ValidateSet('Present','Absent')] [System.String] $Ensure = 'Present', [Parameter()] [ValidateNotNullOrEmpty()] [System.Boolean] $Enabled = $true ) process { $targetResource = Get-TargetResource @PSBoundParameters; $isInCompliance = $true; if ($Ensure -ne $targetResource['Ensure']) { Write-Verbose ($localizedData.ResourcePropertyMismatch -f 'Ensure', $Ensure, $targetResource['Ensure']); $isInCompliance = $false; } elseif (($Ensure -eq 'Present')-and ($Enabled -ne $targetResource['Enabled'])) { Write-Verbose ($localizedData.ResourcePropertyMismatch -f 'Enabled', $Enabled, $targetResource['Enabled']); $isInCompliance = $false; } if ($isInCompliance) { Write-Verbose ($localizedData.ResourceInDesiredState -f $Name); } else { Write-Verbose ($localizedData.ResourceNotInDesiredState -f $Name); } return $isInCompliance; } #end process } #end function Test-TargetResource function Set-TargetResource { [CmdletBinding()] [Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSUseShouldProcessForStateChangingFunctions', '')] [Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSAvoidUsingEmptyCatchBlock', '')] param ( [Parameter(Mandatory)] [ValidateNotNullOrEmpty()] [System.String] $Name, [Parameter()] [AllowNull()] [System.Management.Automation.PSCredential] [System.Management.Automation.CredentialAttribute()] $Credential, [Parameter()] [ValidateSet('Present','Absent')] [System.String] $Ensure = 'Present', [Parameter()] [ValidateNotNullOrEmpty()] [System.Boolean] $Enabled = $true ) begin { AssertXDModule -Name 'Citrix.DelegatedAdmin.Admin.V1' -IsSnapin; } process { $scriptBlock = { Add-PSSnapin -Name 'Citrix.DelegatedAdmin.Admin.V1' -ErrorAction Stop; try { ## Cmdlet ignores $ErrorActionPreference :@ $xdAdministrator = Get-AdminAdministrator -Name $using:Name -ErrorAction SilentlyContinue; } catch { } if ($using:Ensure -eq 'Present') { if ($xdAdministrator) { Write-Verbose ($using:localizedData.UpdatingAdministrator -f $using:Name); Set-AdminAdministrator -Name $using:Name -Enabled $using:Enabled; } else { Write-Verbose ($using:localizedData.AddingAdministrator -f $using:Name); New-AdminAdministrator -Name $using:Name -Enabled $using:Enabled; } } else { if ($xdAdministrator) { Write-Verbose ($using:localizedData.RemovingAdministrator -f $using:Name); Remove-AdminAdministrator -Name $using:Name; } } } #end scriptblock $invokeCommandParams = @{ ScriptBlock = $scriptBlock; ErrorAction = 'Stop'; } Write-Verbose ($localizedData.InvokingScriptBlockWithParams -f [System.String]::Join("','", @($Name, $Enabled, $Ensure))); if ($Credential) { AddInvokeScriptBlockCredentials -Hashtable $invokeCommandParams -Credential $Credential; [ref] $null = Invoke-Command @invokeCommandParams; } else { $invokeScriptBlock = [System.Management.Automation.ScriptBlock]::Create($scriptBlock.ToString().Replace('$using:','$')); [ref] $null = InvokeScriptBlock -ScriptBlock $invokeScriptBlock; } } #end process } #end function Set-TargetResource $moduleRoot = Split-Path -Path $MyInvocation.MyCommand.Path -Parent; ## Import the XD7Common library functions $moduleParent = Split-Path -Path $moduleRoot -Parent; Import-Module (Join-Path -Path $moduleParent -ChildPath 'VE_XD7Common'); ## Import the InvokeScriptBlock function into the current scope . (Join-Path -Path (Join-Path -Path $moduleParent -ChildPath 'VE_XD7Common') -ChildPath 'InvokeScriptBlock.ps1'); Export-ModuleMember -Function *-TargetResource; |