# encoding: ascii
# api: powershell
# title: Add-PrinterDriver
# description: Add-PrinterDriver is a PowerShell function to install all printer drivers from a specified print server. The function is primarily targeted at Remote Desktop Services (formerly Terminal Services) Session Host servers.
# version: 0.1
# type: function
# author: Jan Egil Ring
# license: CC0
# function: Add-PrinterDriver
# x-poshcode-id: 2764
# x-archived: 2011-07-06T05:04:46
# x-published: 2011-07-03T09:08:00
#
# More information is available here:
# http://blog.powershell.no/2011/07/03/adding-printer-drivers-from-a-print-server-using-windows-powershell
#
#requires -version 2
function Add-PrinterDriver {
<#
.SYNOPSIS
Adds printer drivers to the local computer from a specified print server.
.DESCRIPTION
Adds printer drivers to the local computer from a specified print server. The function collects all shared printer objects from the specified print server and installs them on the local computer if not already installed. One mandatory parameter: PrintServer
.PARAMETER PrintServer
The name of the print server to add printer drivers from
.PARAMETER Clean
Switch parameter which deletes all network printer connections for the current user.
.EXAMPLE
Add-PrinterDriver -PrintServer srv01.domain.local
Add printer drivers from the specified print server
.EXAMPLE
Add-PrinterDriver -PrintServer srv01.domain.local -Clean
Add printer drivers from the specified print server, then removes all network printer connections for the current user.
.EXAMPLE
Add-PrinterDriver -PrintServer srv01.domain.local -Verbose
Add printer drivers from the specified print server with the -Verbose switch parameter
.NOTES
AUTHOR: Jan Egil Ring
BLOG: http://blog.powershell.no
LASTEDIT: 03.07.2011
You have a royalty-free right to use, modify, reproduce, and
distribute this script file in any way you find useful, provided that
you agree that the creator, owner above has no warranty, obligations,
or liability for such use.
#>
[CmdletBinding()]
Param(
[Parameter(Mandatory=$true)]
[string] $PrintServer,
[switch] $Clean
)
#Collecting all shared printer objects from the specified print server
$allprinters = @(Get-WmiObject win32_printer -ComputerName $PrintServer -Filter 'shared=true')
#Defining all unique printer drivers from the specified print server
$drivers = @($allprinters | Select-Object drivername -Unique)
#Defining a collection containing the first printer object using a unique printer driver
$printers = @()
foreach ($item in $drivers){
$printers += @($allprinters | Where-Object {$_.drivername -eq $item.drivername})[0]
}
#Collecting locally installed drivers
$localdrivers = @()
foreach ($driver in (Get-WmiObject Win32_PrinterDriver)){
$localdrivers += @(($driver.name -split ",")[0])
}
#Initializing the CurrentPrinter variable for use with Write-Progress
$CurrentPrinter = 1
#Looping through the printer objects collection, installing those who are not already installed on the local computer
foreach ($printer in $printers) {
Write-Progress -Activity "Installing printers..." -Status "Current printer: $($printer.name)" -Id 1 -PercentComplete (($CurrentPrinter/$printers.count) * 100)
#Create hash-table for output object
$outputobject = @{}
$outputobject.drivername = $printer.drivername
$locallyinstalled = $localdrivers | Where-Object {$_ -eq $printer.drivername}
if (-not $locallyinstalled) {
Write-Verbose "$($printer.drivername) is not installed locally"
$AddPrinterConnection = Invoke-WmiMethod -Path Win32_Printer -Name AddPrinterConnection -ArgumentList ([string]::Concat('\\', $printer.__SERVER, '\', $printer.ShareName)) -EnableAllPrivileges
$outputobject.returncode = $AddPrinterConnection.ReturnValue
}
else
{
Write-Verbose "$($printer.drivername) is already installed locally"
$outputobject.returncode = "Already installed"
}
#Create a new object for each driver, based on the outputobject hash-table
New-Object -TypeName PSObject -Property $outputobject
$CurrentPrinter ++
}
#Deletes all printer connections for the current user
if ($clean) {
$printers = Get-WmiObject Win32_Printer -EnableAllPrivileges -Filter network=true
if ($printers) {
foreach ($printer in $printers) {
$printer.Delete()
}
}
}
}