DSCResources/VE_ROAAgent/VE_ROAAgent.ps1
|
# Localized messages data LocalizedData { # culture="en-US" ConvertFrom-StringData @' OpeningMSIDatabase = Opening MSI database '{0}'. ResourceIncorrectPropertyState = Resource property '{0}' is NOT in the desired state. Expected '{1}', actual '{2}'. ResourceInDesiredState = Resource '{0}' is in the desired state. ResourceNotInDesiredState = Resource '{0}' is NOT in the desired state. '@ } function Get-TargetResource { [CmdletBinding()] [OutputType([System.Collections.Hashtable])] param ( ## RES ONE Automation database server name/instance (equivalient to DBSERVER). [Parameter(Mandatory)] [ValidateNotNullOrEmpty()] [System.String] $SiteId, ## File path containing the RES ONE Automation MSIs or the literal path to the Agent MSI. [Parameter(Mandatory)] [ValidateNotNullOrEmpty()] [System.String] $Path, ## By default, the Agent will autodetect Dispatchers. To use a fixed list of Dispatchers instead, use ## this parameter to specify the names or GUIDs of Dispatchers to use. Separate multiple entries with a semi-colon (;). [Parameter()] [ValidateNotNullOrEmpty()] [System.String[]] $DispatcherList, ## Should the agent try autodetecting Dispatchers before using the $DispatcherList [Parameter()] [ValidateNotNull()] [System.Boolean] $UseAutodetectFirst = $true, ## Should the agent extend its list of Dispatchers by downloading a list of all Dispatchers. [Parameter()] [ValidateNotNull()] [System.Boolean] $DownloadDispatcherList = $false, ## To add the Agent as a member of one or more Teams, use this property to specify the names or GUIDs ## of the Teams. Separate multiple entries with a semi-colon (;). [Parameter()] [ValidateNotNullOrEmpty()] [System.String[]] $AddToTeam, ## To run one or more Modules, Projects or Run Books on the new Agent as soon as it comes online, use this property ## to specify the GUIDs. [Parameter()] [ValidateNotNullOrEmpty()] [System.String[]] $InvokeProject, ## RES ONE Automation component version to be installed, i.e. 8.0.3.0 [Parameter()] [ValidateNotNullOrEmpty()] [System.String] $Version, ## The specified Path is a literal file reference (bypasses the $Versioncheck). [Parameter()] [ValidateNotNull()] [System.Management.Automation.SwitchParameter] $IsLiteralPath, [Parameter()] [ValidateSet('Present','Absent')] [System.String] $Ensure = 'Present' ) $setupPath = ResolveSetupPath @PSBoundParameters -Component 'Agent'; [System.String] $msiProductName = GetWindowsInstallerPackageProperty -Path $setupPath -Property ProductName; $productName = $msiProductName.Trim(); $productEntry = GetProductEntry -Name $productName; $targetResource = @{ Path = $setupPath; ProductName = $productName; Version = $productEntry.DisplayVersion; Ensure = if ($productEntry) { 'Present' } else { 'Absent' } } return $targetResource; } #end function Get-TargetResource function Test-TargetResource { [CmdletBinding()] [OutputType([System.Boolean])] param ( ## RES ONE Automation database server name/instance (equivalient to DBSERVER). [Parameter(Mandatory)] [ValidateNotNullOrEmpty()] [System.String] $SiteId, ## File path containing the RES ONE Automation MSIs or the literal path to the Agent MSI. [Parameter(Mandatory)] [ValidateNotNullOrEmpty()] [System.String] $Path, ## By default, the Agent will autodetect Dispatchers. To use a fixed list of Dispatchers instead, use ## this parameter to specify the names or GUIDs of Dispatchers to use. Separate multiple entries with a semi-colon (;). [Parameter()] [ValidateNotNullOrEmpty()] [System.String[]] $DispatcherList, ## Should the agent try autodetecting Dispatchers before using the $DispatcherList [Parameter()] [ValidateNotNull()] [System.Boolean] $UseAutodetectFirst = $true, ## Should the agent extend its list of Dispatchers by downloading a list of all Dispatchers. [Parameter()] [ValidateNotNull()] [System.Boolean] $DownloadDispatcherList = $false, ## To add the Agent as a member of one or more Teams, use this property to specify the names or GUIDs ## of the Teams. Separate multiple entries with a semi-colon (;). [Parameter()] [ValidateNotNullOrEmpty()] [System.String[]] $AddToTeam, ## To run one or more Modules, Projects or Run Books on the new Agent as soon as it comes online, use this property ## to specify the GUIDs. [Parameter()] [ValidateNotNullOrEmpty()] [System.String[]] $InvokeProject, ## RES ONE Automation component version to be installed, i.e. 8.0.3.0 [Parameter()] [ValidateNotNullOrEmpty()] [System.String] $Version, ## The specified Path is a literal file reference (bypasses the $Versioncheck). [Parameter()] [ValidateNotNull()] [System.Management.Automation.SwitchParameter] $IsLiteralPath, [Parameter()] [ValidateSet('Present','Absent')] [System.String] $Ensure = 'Present' ) $resourceName = 'ROAAgent'; if (([System.String]::IsNullOrWhitespace($Version)) -and (-not $IsLiteralPath)) { throw "$resourceName : Version number is required when not using a literal path."; } elseif ($IsLiteralPath) { if ($Path -notmatch '\.msi$') { throw "$resourceName : Specified path '$Path' does not point to an MSI file."; } } elseif ($Version -notmatch '^\d+\.\d+\.\d+\.\d+$') { throw "$resourceName : The specified version '$Version' does not match '1.2.3.4' format."; } $targetResource = Get-TargetResource @PSBoundParameters; if ($Ensure -ne $targetResource.Ensure) { Write-Verbose -Message ($localizedData.ResourceIncorrectPropertyState -f 'Ensure', $Ensure, $targetResource.Ensure); Write-Verbose -Message ($localizedData.ResourceNotInDesiredState -f $targetResource.ProductName); return $false; } else { Write-Verbose -Message ($localizedData.ResourceInDesiredState -f $targetResource.ProductName); return $true; } } #end function Test-TargetResource function Set-TargetResource { [CmdletBinding()] param ( ## RES ONE Automation database server name/instance (equivalient to DBSERVER). [Parameter(Mandatory)] [ValidateNotNullOrEmpty()] [System.String] $SiteId, ## File path containing the RES ONE Automation MSIs or the literal path to the Agent MSI. [Parameter(Mandatory)] [ValidateNotNullOrEmpty()] [System.String] $Path, ## By default, the Agent will autodetect Dispatchers. To use a fixed list of Dispatchers instead, use ## this parameter to specify the names or GUIDs of Dispatchers to use. Separate multiple entries with a semi-colon (;). [Parameter()] [ValidateNotNullOrEmpty()] [System.String[]] $DispatcherList, ## Should the agent try autodetecting Dispatchers before using the $DispatcherList [Parameter()] [ValidateNotNull()] [System.Boolean] $UseAutodetectFirst = $true, ## Should the agent extend its list of Dispatchers by downloading a list of all Dispatchers. [Parameter()] [ValidateNotNull()] [System.Boolean] $DownloadDispatcherList = $false, ## To add the Agent as a member of one or more Teams, use this property to specify the names or GUIDs ## of the Teams. Separate multiple entries with a semi-colon (;). [Parameter()] [ValidateNotNullOrEmpty()] [System.String[]] $AddToTeam, ## To run one or more Modules, Projects or Run Books on the new Agent as soon as it comes online, use this property ## to specify the GUIDs. [Parameter()] [ValidateNotNullOrEmpty()] [System.String[]] $InvokeProject, ## RES ONE Automation component version to be installed, i.e. 8.0.3.0 [Parameter()] [ValidateNotNullOrEmpty()] [System.String] $Version, ## The specified Path is a literal file reference (bypasses the $Versioncheck). [Parameter()] [ValidateNotNull()] [System.Management.Automation.SwitchParameter] $IsLiteralPath, [Parameter()] [ValidateSet('Present','Absent')] [System.String] $Ensure = 'Present' ) $setupPath = ResolveSetupPath @PSBoundParameters -Component 'Agent'; if ($Ensure -eq 'Present') { $arguments = @( ('/i "{0}"' -f $setupPath), ('SITELICENSE="{0}"' -f $siteId), ('DISPATCHERAUTODETECTFIRST="{0}"' -f [System.Int32] $UseAutodetectFirst), ('DISPATCHERGETLIST="{0}"' -f [System.Int32] $DownloadDispatcherList) ) if ($PSBoundParameters.ContainsKey('DispatcherList')) { $arguments += 'DISPATCHERLIST="{0}"' -f ($DispatcherList -join ';'); } if ($PSBoundParameters.ContainsKey('AddToTeam')) { $arguments += 'ADDTOTEAM="{0}"' -f ($AddToTeam -join ';'); } if ($PSBoundParameters.ContainsKey('InvokeProject')) { $arguments += 'INVOKEPROJECT="{0}"' -f ($InvokeProject -join ';'); } } elseif ($Ensure -eq 'Absent') { [System.String] $msiProductCode = GetWindowsInstallerPackageProperty -Path $setupPath -Property ProductCode; $arguments = @( ('/X{0}' -f $msiProductCode) ) } ## Start install/uninstall $arguments += '/norestart'; $arguments += '/qn'; StartWaitProcess -FilePath "$env:WINDIR\System32\msiexec.exe" -ArgumentList $arguments -Verbose; } #end function Set-TargetResource |