Chat now with support
Chat with Support

Foglight for Automation Action Packs 5.6.3.8 - System Preparation ActionPack User Guide

COM and Automation Objects

The COM and Automation objects are required to perform remote tasks on Windows machines that are not configured for remote activation. Therefore additional configuring of the DLL surrogate is required.

Registry Permissions

Make sure that the Administrator user has Full Control access to the following registry keys:

•
HKEY_LOCAL_MACHINE/Software/Classes/AppID
•
HKEY_LOCAL_MACHINE/Software/Classes/CLSID/{0D43FE01-F093-11CF-8940-00A0C9054228}
•
HKEY_LOCAL_MACHINE/Software/Classes/CLSID/{13709620-C279-11CE-A49E-444553540000}
•
HKEY_LOCAL_MACHINE/Software/Classes/CLSID/{72C24DD5-D70A-438B-8A42-98424B88AFB8}
•
HKEY_LOCAL_MACHINE/Software/Classes/CLSID/{76A64158-CB41-11D1-8B02-00600806D9B6}
Configuration Script

Use the script below to configure DCOM.

1
Create a file named dcom-config.ps1 that contains the script below on the target machine.
2
Run the script on behalf of the Administrator user using the following command:
runas /user:Administrator powershell -File dcom-config.ps1

 

# Copyright 2010 Quest
# ALL RIGHTS RESERVED.
#
# PROPRIETARY/CONFIDENTIAL.
#
# This software is the confidential and proprietary information
# of Quest ("Confidential Information").
#
# You shall not disclose such Confidential Information and shall
# use it only in accordance with the terms of the license agreement
# you entered into with Quest
#
 
Function ConfigureAppID($appId,$appDescription,$systemGlobal) {
Echo "Processing $appId ($appDescription)"
 
if ($systemGlobal) {
$classesKey = "HKLM:\Software\Classes"
}
else {
$classesKey = "HKCU:\Software\Classes"
}
 
$AppIDKey = $classesKey + "\AppID"
 
if (!(Test-Path $AppIDKey)) {
$item=New-Item -Name "AppID" -Path $classesKey -Type directory
}
 
$CLASS_AppIDKey = $AppIDKey + "\{$appId}"
if (!(Test-Path $CLASS_AppIDKey)) {
$item=New-Item -Name "{$appId}" -Path $AppIDKey -Type directory
}
Set-ItemProperty -Path $CLASS_AppIDKey -Name "(default)" -Value "$appDescription"
Set-ItemProperty -Path $CLASS_AppIDKey -Name "DllSurrogate" -Value ""
}
 
Function ConfigureCLSID($clsId,$appId,$systemGlobal) {
Echo "Processing $clsId"
 
$name = (Get-ItemProperty -Path "HKLM:\Software\Classes\CLSID\{$clsId}\ProgID" -Name "(default)")."(default)"
Echo $name
 
if ($systemGlobal) {
$classesKey = "HKLM:\Software\Classes"
}
else {
$classesKey = "HKCU:\Software\Classes"
}
$CLSIDKey = $classesKey + "\CLSID"
$AppIDKey = $classesKey + "\AppID"
 
if (!(Test-Path $CLSIDKey)) {
$item=New-Item -Name "CLSID" -Path $classesKey -Type directory
}
 
$CLASS_CLSIDKey = $CLSIDKey + "\{$clsId}"
if (!(Test-Path $CLASS_CLSIDKey)) {
$item=New-Item -Name "{$clsId}" -Path $CLSIDKey -Type directory
}
Set-ItemProperty -Path $CLASS_CLSIDKey -Name "AppID" -Value "{$appId}"
}
 
Function ConfigureDCOM($appId,$systemGlobal) {
if (!$appId) {
$appId = [System.Guid]::NewGuid()
}
$appDescription = "Default DLL Surrogate"
 
ConfigureAppID -appId $appId -appDescription $appDescription -systemGlobal $systemGlobal
 
$CLSIDS = @(
# Scripting.FileSystemObject
"0D43FE01-F093-11CF-8940-00A0C9054228",
# Shell.Application
"13709620-c279-11ce-a49e-444553540000"
# WScript.Shell
"72C24DD5-D70A-438B-8A42-98424B88AFB8"
# WbemScripting.SWbemLocator
"76A64158-CB41-11D1-8B02-00600806D9B6"
)
 
foreach ($clsId in $CLSIDS) {
ConfigureCLSID -clsId $clsId -systemGlobal $systemGlobal -appId $appId
}
 
}
ConfigureDCOM -systemGlobal $true
 

Actions

This section contains descriptions of the action included in this ActionPack.

Run System Preparation
Pre-conditions
•
If the computer belongs to a workgroup instead of a domain, make sure that it does not use simple file sharing.
•
If the firewall is turned on, allow your COM application network access to your machine.
•
The remote host must be powered on.
 
Table 1. Run System Preparation Input Parameters
Name
Type
Description

Domain/domain

String

The current computer domain.

User name/userName

String

The user name to log into the computer OS.

User password/userPassword

String

The user password to log into the computer OS.

Local path to sysprep/sysprepPath

String

The local path to Windows XP/2000 sysprep utility and others files (sysprep.exe, setupcl.exe, factory.exe).

Admin password/adminPassword

String

Administrator account password.

Product key/productKey

String

Product Key for each unique installation of Microsoft Windows.

Full name/fullName

String

User full name.

Organization/OrgName

String

Organization name.

Computer name/computerName

String

Computer name.

Use server license mode/useServerLicense

Boolean

Determines whether to install Microsoft Windows Server, Microsoft Windows Advanced Server, Limited Edition, or Microsoft Windows Server 2003, Datacenter Edition per-server, per-device, or per-user license.

Number of client licenses/numLicensesPerSeat

Integer

The number of client licenses purchased for the server.

Join domain/JoinDomain

Boolean

Determines whether to join a new domain or workgroup.

Target domain/joinDomain

String

The name of a new domain, to which the computer will be added.

Domain administrator/domainAdmin

String

Domain administrator’s login.

Domain admin password/domainAdminPassword

String

Domain administrator’s password.

Command line parameters/cmdLineParams

String

Parameters to add to the sysprep command.

Use DHCP/useDHCP

Array of Boolean

Specifies whether to use Dynamic Host Configuration Protocol (DHCP).

MAC Address/macAddress

Array of String

MAC address of the network adapter.

IP address/ipAddress

Array of String

IP address for the network connection.

Subnet mask/subnetMask

Array of String

Subnet mask to be assigned to the network interface.

Default gateway/defaultGateway

Array of String

Default gateway to be assigned to the network interface.

DNS Server Search Order/dnsServerSearchOrder

Array of String

 

A comma-separated list of IP addresses to use when searching for the DNS server on the network.

DNS Domain/dnsDomain

Array of String

 

The suffix of the network connection that uses this adapter.

Post-conditions
•
The OS restarts during the action execution.
•
After the first boot, the system preparation process executes.
•
SID, IP address, computer name, and other settings are modified.

 

 

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating