Included Resources

• PrinterDriver
• Printer

PrinterDriver

Install a printer driver.

Syntax

PrinterDriver [string]
{
    DriverName = [string]
    [InfPath = [string]]
    [Environment = [string]] { x86 | x64 }
    [Ensure = [string]] { Present | Absent }
}

Properties

• DriverName: Specifies the printer driver name.
• InfPath: Specifies the path to the printer driver INF file in the driver store. INF files contain information about the printer and the printer driver.
• Environment: Specifies the printer driver environment.
  • Supported values are 'x64' or 'x86'.
  • If not specified, it defaults to 'x64'.
• Ensure: Whether the role is to be installed or not.
  • Supported values are Present or Absent.
  • If not specified, it defaults to Present.

Configuration

Configuration PrinterDriverExample {
    Import-DscResource -ModuleName PrinterManagement
    PrinterDriver PrinterDriverExample {
       DriverName = 'Microsoft XPS Class Driver'
       Environment = 'x64'
       Ensure = 'Present'
    }
}

Printer

Creates and shares a local printer.

Syntax

Printer [string]
{
    Name = [string]
    DriverName = [string]
    PortName = [string]
    [Comment = [string]]
    [Location = [string]]
    [Published = [bool]]
    [ShareName = [string]]
    [Ensure = [string]] { Present | Absent }
}

Properties

• Name: Specifies the name of the printer.
• DriverName: Specifies the name of the printer driver for the printer.
• PortName: Specifies the name of the port used or created for the printer.
• Comment: Specifies the text to add to the Comment field for the specified printer.
• Location: Specifies the location of the printer
• Published: Specifies whether or not the printer is published in the network directory service.
  • If not specified, it defaults to $false.
• ShareName: Specifies the name by which to share the printer on the network.
• Ensure: Whether the role is to be installed or not.
  • Supported values are Present or Absent.
  • If not specified, it defaults to Present.

Configuration

Configuration PrinterExample {
    Import-DscResource -ModuleName PrinterManagement
    Printer SharedExamplePrinter {
        Name = 'Example Printer'
        DriverName = 'Microsoft XPS Class Driver'
        PortName = 'PORTPROMPT:'
        ShareName = 'Shared Printer'
        Published = $true
        Ensure = 'Present'
    }
}