Home Reference WMI Reference root CIMV2 Win32_PrinterConfiguration
 

Win32_PrinterConfiguration

The Setting class represents configuration-related and operational parameters for one or more ManagedSystemElement(s). A ManagedSystemElement may have multiple Setting objects associated with it. The current operational values for an Element’s parameters are reflected by properties in the Element itself or by properties in its associations. These properties do not have to be the same values present in the Setting object. For example, a modem may have a Setting baud rate of 56Kb/sec but be operating at 19.2Kb/sec.

Quick Start

Properties

In this WMI class, all WMI properties are read-only. You can only read values but not change them.

BitsPerPel

Data type UInt32

The BitsPerPel property contains the number of bits per pixel for the output device Win32 printer. This member is used by display drivers and not by printer drivers.

Example: 8.

This property has been deprecated because it is not applicable to printers. There is no replacement value.

Caption

Data type String

A short textual description (one-line string) of the CIM_Setting object.

Collate

Data type Boolean

The Collate property specifies whether to collate the pages that are printed. To collate is to print out the entire document before printing the next copy, as opposed to printing out each page of the document the required number times. This property is ignored unless the printer driver indicates support for collation.

Values: $true or $false. If $true, the printer collates all documents.

Color

Data type UInt32

The Color property indicates whether the document is to be printed in color or monochrome. Some color printers have the capability to print using $true black instead of a combination of Yellow, Cyan, and Magenta. This usually creates darker and sharper text for documents. This option is only useful for color printers that support $true black printing.

$Color_ReturnValue = 
@{
    1='Monochrome'
    2='Color'
}

Copies

Data type UInt32

The Copies property indicates the number of copies to be printed. The printer driver must support printing multi-page copies.

Example: 2

Description

Data type String

A textual description of the CIM_Setting object.

DeviceName

Data type String

The DeviceName property specifies the friendly name of the printer. This name is unique to the type of printer and may be truncated because of the limitations of the string from which it is derived.

Example PCL/HP LaserJet

DisplayFlags

Data type UInt32

The DisplayFlags property contains two bits of information about the display. This member communicates whether the display device is monochrome or colored, and interlaced or non-interlaced, by masking its value with the DM_GRAYSCALE and DM_INTERLACED masks respectively.

This property has been deprecated because it is not applicable to printers. There is no replacement value.

DisplayFrequency

Data type UInt32

The DisplayFrequency property indicates the refresh frequency of the display The refresh frequency for a monitor is the number of times the screen is redrawn per second.

This property has been deprecated because it is not applicable to printers. There is no replacement value.

DitherType

Data type UInt32

The DitherType property indicates the dither type of the printer. This member can assume predefined values of 1 to 5, or driver-defined values from 6 to 256. Line art dithering is a special dithering method that produces well defined borders between black, white, and gray scalings. It is not suitable for images that include continuous graduations in intensity and hue such as scanned photographs.

$DitherType_ReturnValue = 
@{
    1='No Dithering'
    2='Coarse Brush'
    3='Fine Brush'
    4='Line Art'
    5='Greyscale'
}

DriverVersion

Data type UInt32

The DriverVersion property indicates the version number of the Win32 printer driver. The version numbers are created and maintained by the driver manufacturer.

Duplex

Data type Boolean

The Duplex property indicates whether printing is done on one or both sides.

Values: $true or $false. If $true, printing is done on both sides.

FormName

Data type String

The FormName property indicates the name of the form used for the print job. This property is used only on Windows NT/Windows 2000 systems.

Example: Legal

HorizontalResolution

Data type UInt32

The HorizontalResolution property indicates the print resolution along the X axis (width) of the print job. This value is only set when the PrintQuality property of this class is positive and is similar to the XResolution property.

ICMIntent

Data type UInt32

The ICMIntent (Image Color Matching Intent) property indicates the specific value of one of the three possible color matching methods (called intents) that should be used by default. ICM applications establish intents by using the ICM functions. This property can assume predefined values of 1 to 3, or driver-defined values from 4 to 256. Non-ICM applications can use this value to determine how the printer handles color printing jobs.

$ICMIntent_ReturnValue = 
@{
    1='Saturation'
    2='Contrast'
    3='Exact Color'
}

ICMMethod

Data type UInt32

The ICMMethod (Image Color Matching Method) property specifies how ICM is handled. For a non-ICM application, this property determines if ICM is enabled or disabled. For ICM applications, the system examines this property to determine which part of the computer system handles ICM support.

$ICMMethod_ReturnValue = 
@{
    1='Disabled'
    2='Windows'
    3='Device Driver'
    4='Device'
}

LogPixels

Data type UInt32

The LogPixels property contains the number of pixels per logical inch. This member is valid only with devices that work with pixels (this excludes devices such as printers).

This property has been deprecated because it is not applicable to printers. There is no replacement value.

MediaType

Data type UInt32

The MediaType property specifies the type of media being printed on. The property can be set to a predefined value or a driver-defined value greater than or equal to 256. For Windows 95 and later; Windows 2000.

$MediaType_ReturnValue = 
@{
    1='Standard'
    2='Transparency'
    3='Glossy'
}

Name

Data type String

The Name property indicates the name of the printer with which this configuration is associated.

Orientation

Data type UInt32

The Orientation property indicates the printing orientation of the paper.

$Orientation_ReturnValue = 
@{
    1='Portrait'
    2='Landscape'
}

PaperLength

Data type UInt32

The PaperLength property indicates the length of the paper.

Example: 2794

PaperSize

Data type String

The PaperSize property indicates the size of the paper.

Example: A4 or Letter

PaperWidth

Data type UInt32

The PaperWidth property indicates the width of the paper.

Example: 2159

PelsHeight

Data type UInt32

The PelsHeight property indicates the height of the displayable surface.

This property has been deprecated because it is not applicable to printers. There is no replacement value.

PelsWidth

Data type UInt32

The PelsWidth property indicates the width of the displayable surface.

This property has been deprecated because it is not applicable to printers. There is no replacement value.

PrintQuality

Data type UInt32

The PrintQuality property indicates one of four quality levels of the print job. If a positive value is specified, the quality is measured in dots per inch.

Example: Draft

$PrintQuality_ReturnValue = 
@{
   -1='Draft'
   -2='Low'
   -3='Medium'
   -4='High'
}

Scale

Data type UInt32

The Scale property specifies the factor by which the printed output is to be scaled. For example a scale of 75 reduces the print output to 3/4 its original height and width.

SettingID

Data type String

The identifier by which the CIM_Setting object is known.

SpecificationVersion

Data type UInt32

The SpecificationVersion property indicates the version number of the initialization data for the device associated with the Win32 printer.

TTOption

Data type UInt32

The TTOption property specifies how TrueType(r) fonts should be printed. There are 3 possible values:

Bitmap – Prints TrueType fonts as graphics. This is the default action for dot-matrix printers.

Download – Downloads TrueType fonts as soft fonts. This is the default action for printers that use the Printer Control Language (PCL).

Substitute – Substitutes device fonts for TrueType fonts. This is the default action for PostScript(r) printers.

$TTOption_ReturnValue = 
@{
    1='Bitmap'
    2='Download'
    3='Substitute'
}

VerticalResolution

Data type UInt32

The VerticalResolution property indicates the print resolution along the Y axis (height) of the print job. This value is only set when the PrintQuality property of this class is positive, and is similar to the YResolution property.

XResolution

Data type UInt32

The XResolution property has been deprecated to theHorizontalResolution property. Please refer to the description of that property.

YResolution

Data type UInt32

The YResolution property has been deprecated to theVerticalResolution property. Please refer to the description of that property.

Methods

Examples

See Also

Help and Questions

  Community Content

You are cordially invited to add knowledge to this page. If you have sample code or additional information related to this WMI class, please share it. Use the comment form to send your information. We will edit and incorparate it into the reference library. Thank you!

Please do not use the comment form to submit questions. If you have questions or need assistance, visit our free forum: Help me with WMI.

Content last updated: 2013-12-27 12:29:23 (UTC).

Facebooktwittergoogle_pluspinterestlinkedinFacebooktwittergoogle_pluspinterestlinkedin
  • Steve Freeman

    This saved me hours of manual checking, thanks for this.