Extended host attribute matching

Supported host attributes

!!! This requires WPKG 1.2 or higher !!!

Below find a table of supported host attributes.

Attribute	Description	Example content collected by WPKG
hostname	the name of the host	hostname="satellite"
os	the operating system	os="microsoft windows 7 home premium, , sp1, 6.1.7601"
architecture	the processor architecture	architecture="x64"
ipaddresses	all active IP addresses	ipaddresses="10.0.0.2,192.168.56.1"
domainname	the domain the host belongs to	domainname="wpkg.org"
groups	all groups the host belongs to	groups="design,office"
lcid	the language of the operating system	lcid="c07"

Where to use them

Below find a table of where you can use these attributes.

File	Node	Example
hosts.xml	host	<host name="..." proifile-id="..." os="..." ... />
	variable	<variable name="..." value="..." os="..." ... />
profiles.xml	package	<package package-id="..." os="..." ... />
	variable	<variable name="..." value="..." os="..." ... />
packages.xml	variable	<variable name="..." value="..." os="..." ... />
	install	<install cmd="..." os="..." />
	upgrade	<upgrade cmd="..." os="..." />
	downgrade	<downgrade cmd="..." os="..." />
	remove	<remove cmd="..." os="..." />

Detailed descriptions

All attributes are matched using regular expressions. The collected information is added to the <wpkg/> node of the wpkg.xml file, which allows reporting tools to apply the extended matching too.

To learn about the regular expression syntax used in WPKG, visit the following website: http://msdn.microsoft.com/en-us/library/ae5bf541%28vs.71%29.aspx

hostname

This contains the name of the system, which is also contained in the Windows environment variable %COMPUTERNAME%.

Example usage:

<host hostname="^VM\-.+$" profile-id="VirtualMachines" />

os

This contains the full description of the operations system, which consists of the following parts:

• OS-caption
• OS-description
• CSD-version (usually the service pack)
• OS-version

Known descriptions:

(Please help to maintain this table)

OS String	Match Pattern
microsoft windows 2000 professional, , sp4, 5.0.2195	os="professional.+5\.0\.[0-9][0-9][0-9][0-9]"
microsoft windows 2000 server, , sp4, 5.0.2195	os="server.+5\.0\.[0-9][0-9][0-9][0-9]"
microsoft windows xp professional, , sp3, 5.1.2600	os="professional.+5\.1\.[0-9][0-9][0-9][0-9]"
microsoft(r) windows(r) xp professional x64 edition, , sp2, 5.2.3790	os="professional.+5\.2\.[0-9][0-9][0-9][0-9]" architecture="x64"
microsoft(r) windows(r) server 2003, standard edition, , sp2, 5.2.3790	os="server.+standard.+5\.2\.[0-9][0-9][0-9][0-9]"
microsoft(r) windows(r) server 2003 web edition, , sp2, 5.2.3790	os="server.+web.+5\.2\.[0-9][0-9][0-9][0-9]"
microsoft(r) windows(r) server 2003 enterprise x64 edition, , sp2, 5.2.3790	os="server.+enterprise.+5\.2\.[0-9][0-9][0-9][0-9]" architecture="x64"
microsoft(r) windows(r) server 2003 standard edition, r2, sp2, 5.2.3790	os="server.+standard.+r2.+5\.2\.[0-9][0-9][0-9][0-9]"
microsoft(r) windows(r) server 2003 standard x64 edition, r2, sp2, 5.2.3790	os="server.+standard.+r2.+5\.2\.[0-9][0-9][0-9][0-9]" architecture="x64"
microsoft® windows vista™ home premium, , sp2, 6.0.6002	os="premium.+6\.0\.[0-9][0-9][0-9][0-9]"
microsoft® windows® storage server 2008 standard, , sp2, 6.0.6002	os="storage.+standard.+6\.0\.[0-9][0-9][0-9][0-9]"
microsoft windows 7 home premium, , sp1, 6.1.7601	os="premium.+6\.1\.[0-9][0-9][0-9][0-9]"
microsoft windows 7 professional, , sp1, 6.1.7601	os="professional.+6\.1\.[0-9][0-9][0-9][0-9]"
microsoft windows 7 enterprise, , , 6.1.7600	os="7 enterprise.+6\.1\.[0-9][0-9][0-9][0-9]"
microsoft windows 7 ultimate, , , 6.1.7600	os="ultimate.+6\.1\.[0-9][0-9][0-9][0-9]"
microsoft windows server 2008 r2 standard, , sp1, 6.1.7601	os="server.+standard.+6\.1\.[0-9][0-9][0-9][0-9]"
microsoft windows server 2008 r2 enterprise, , sp1, 6.1.7601	os="server.+enterprise.+6\.1\.[0-9][0-9][0-9][0-9]"

Example usage:

<profile id="DesktopPC">
    <!-- install Adobe Reader 9 only on Windows 2000 -->
    <package package-id="AdobeReader9" os="5\.0\.[0-9][0-9][0-9][0-9]"/>

    <!-- install Adobe Reader 10 only on Windows XP and higher -->
    <package package-id="AdobeReader10" os="5\.[1-9]\.[0-9][0-9][0-9][0-9]|6\.[0-9]\.[0-9][0-9][0-9][0-9]"/>
</profile>

architecture

This contains the processor architecture of the current operating system.

Below find a table of possible values.

Value	Description
x86	Intel x86 compatible 32-bit architecture
x64	AMD64 compatible 64-bit architecture
ia64	Itanium compatible 64-bit architecture

Notice that a 32-bit Windows version installed on a 64-bit capable CPU is still flagged as 32-bit.

Example usage:

<!-- set destination folder based on architecture -->
<variable name="PKG_DEST" value="%ProgramFiles%\Mozilla Firefox"      architecture="x86"/>
<variable name="PKG_DEST" value="%ProgramFiles(x86)%\Mozilla Firefox" architecture="x64"/>

ipaddresses

This contains all currently active IP addresses of the system or an empty string, if no network adapter is currently active.

Example usage:

<host ipaddresses="^10\.0\.0\.[0-9]+$" profile-id="ExternalHosts" />

domainname

This contains the name of the domain the system belongs to or an empty string, if it is not a domain member.

Example usage:

<host domainname="wpkg.org" profile-id="WpkgHosts" />

groups

This contains the names of all groups the system belongs to or an empty string, if it is not a member of any group.

Example usage:

<host groups="office" profile-id="OfficeHosts" />

lcid

This contains the language identifier of the operating system, for a list of possible values visit Locale IDs Assigned by Microsoft.

Example usage:

<!-- default language is English -->
<variable name="PKG_LANGUAGE" value="en-us"/>

<!-- overwrite default language for German systems -->
<variable name="PKG_LANGUAGE" value="de" lcid="407,c07,1407,1007,807"/>