Printers... Many printers...

четверг, 12 ноября 2015

04:25

Hikedaya

We rise up for the things we believe in over and over again

Когда речь заходит о принтерах,
администратор сразу же уходит в серверную,
запирается там и медитирует на мигающие светодиоды.
Потому что принтеры - это скучно.
(с) Народное творчество

Допустим, есть задача. Расставить много-много принтеров для новоприбывающих сотрудников. А потом эти принтеры сделать доступными по сети через принт-сервер. А чтобы совсем весело было, добавим в эту задачку следующие условия:
- адреса этим принтерам должны прилетать от DHCP и быть там зарезервированными
- адресация принтеров начинается с 221-го номера соответствующего диапазона, заканчивается на 250-м. Если этой части диапазона не хватает (и только в этом случае), можно идти вниз от 220-го до 200-го включительно
- FQDN принтера должно равняться букве "p" c МАС-адресом и доменом: например - p112233445566.example.com
- отображаемое имя (то самое, под которым он будет виден клиентам) собирается из шаблона Город-номер_площадки-этаж-модель-индекс (индекс - если нужен): NSK-04-304-HP555 (Новосибирск, 4-й офис, 304 кабинет, модель HP LaserJet 555
- имя порта на принт-сервере должно равняться FQDN принтера.

Хорошая задачка? Вот и мне показалось, что хорошая. А уж сколько в ней оголтелого мышкокликерства, копипаста, нервов и еще чего похуже. Одним словом - так жить нельзя.
Install-Printer.ps1

########################
#Секция исходных данных#
########################

$DHCPServer =      "DHCP"        #Имя DHCP-сервера
$PrintServer =     "PrintServer" #Имя сервера печати
$DNSDomainName =   "example.com" #DNS-имя домена 
$lowLastOctet =    221           #начальный адрес в диапазоне
$lowestLastOctet = 200           #минимальный адрес в диапазоне
$highestLastOctet= 250           #максимальный адрес в диапазоне

#расположение файла с данными об устройствах
$dataFile = "C:\users\hikedaya\documents\source.csv"

#########################################################
#Секция резервирования адресов устройств на DHCP-сервере#
#########################################################

#прочитать данные об устройствах из файла
$data = Import-csv $dataFile

#список устройств с зарезервированными адресами
$reservedDevices = @()

#построчно обработать файл с данными об устройствах
foreach ($line in $data) {

    #получить исходный IP адрес устройства
    $sourceIP = $line.ip
    
    #проверить исходный IP адрес устройства, если он некорректен, сообщить и пропустить его
    if (![system.net.IPAddress]::tryparse($sourceIP,[ref]$null))  {
        write-host "IP адрес $($line.ip) of $($line.name) некорректен, пропускаем..."
        continue
    }

    #получить исходный МАС адрес устройства
    $sourceMAC = $line.mac

    #проверить исходный МАС адрес устройства, если он некорректен, сообщить и пропустить его
    if ($sourceMAC -notmatch "[0-9a-fA-F]{12}") {
        write-host "MAC адрес $($line.mac) of $($line.name) некорректен, пропускаем..."
        continue
    }

    #получить имя устройства
    $sourceHostName = $line.name

    #определить целевой диапазон устройства
    $targetScope = [string]$sourceIP.Substring(0,$sourceIP.LastIndexOf("."))+".0"

    #определить целевое имя зарезервированной записи DHCP
    $targetReservationName = "p"+$sourceMAC+"."+$DNSDomainName

    #назначить переменную для целевого IP адреса
    $targetIP = ""

    #определить целевой IP адрес устройства
    #просмотр диапазона до максимально допустимого адреса
    $checkIP = "" #предполагаемый IP адрес

    for ($i=$lowLastOctet;$i -le $highestLastOctet;$i++){
        $checkIP = [string]$sourceIP.Substring(0,$sourceIP.LastIndexOf("."))+".$i"

        #если нет зарезервированной записи с предполагаемым адресом
        #задать предполагаемый адрес в качестве целевого
        #прекратить обход диапазона
        if (!(Get-DhcpServerv4Reservation -ComputerName $DHCPServer `
                -IPAddress "$checkIP" `
                -ea        SilentlyContinue)) {
            $targetIP = $checkIP
            break
        }
    }

    #если не удалось определить целевой IP адрес в верхней части диапазона
    #просмотр нижней части диапазона до минимально допустимого
    if (!$targetIP) {
        $checkIP = ""
        for ($i=$lowLastOctet-1;$i -ge $lowestLastOctet;$i--) {
            $checkIP = [string]$sourceIP.Substring(0,$sourceIP.LastIndexOf("."))+".$i"
            if (!(Get-DhcpServerv4Reservation -ComputerName $DHCPServer `
                -IPAddress "$checkIP" `
                -ea        SilentlyContinue)) {
                $targetIP = $checkIP
                break
            }    
        }
    }
    
    #если целевой IP адрес определен
    if ($targetIP) {
    
        #если заданный МАС адрес не существует в DHCP таблице
        if (!(Get-DhcpServerv4Reservation -ComputerName $DHCPServer `
                -ScopeId $targetScope `
                -ClientId $sourceMAC `
                -erroraction SilentlyContinue)) {

                #если найденный IP адрес не зарезервирован
                if (!(Get-DhcpServerv4Reservation -ComputerName $DHCPServer `
                        -IPAddress $targetIP `
                        -erroraction SilentlyContinue)) {

                        #зарезервировать найденный IP адрес
                        Add-DhcpServerv4Reservation -ComputerName $DHCPServer `
                            -ScopeId     $targetScope `
                            -IPAddress   $targetIP `
                            -ClientId    $sourceMAC `
                            -Name        $targetReservationName `
                            -Description $sourceHostName `
                            -Type        "DHCP"
                        $templine = "" #временная переменная

                        #создать набор свойств для объектов, хранящих зарезервированные адреса
                        $hashprop = @{
                            DeviceName = $sourceHostName
                            DomainName = $targetReservationName
                            sourceIP =   $sourceIP
                            targetIP =   $targetIP
                            MAC =        $sourceMAC
                        }
                        $templine = new-object -typename PSCustomObject -Property $hashprop

                        #добавить объект из временной переменной в таблицу 
                        #устройств с зарезервированными адресами 
                        $reservedDevices += $templine
            
                        #если для целевого IP адреса не назначен параметр 15 DNS Domain Name
                        if (!(Get-DhcpServerv4OptionValue -ComputerName $DHCPServer `
                                -ReservedIP  $targetIP `
                                -optionid    "15" `
                                -ErrorAction SilentlyContinue | 
                                select -expand Value)) {

                            #добавить к зарезервированной записи параметр 15 
                            Set-DhcpServerv4OptionValue -ComputerName $DHCPServer `
                                -ReservedIP $targetIP `
                                -DnsDomain "example.com"
                        }
                        #если для целевого IP адреса назначен параметр 15 - оповестить об этом
                        else { write-host "Параметр DNS Domain Name уже назначен адресу $targetIP" }
                }
                #если целевой IP адрес уже зарезервирован - оповестить об этом
                else { write-host "IP адрес $targetIP уже зарезервирован" }
        }
        #если указанный MAC адрес есть в таблице DHCP - оповестить об этом
        else { write-host "MAC адрес $sourceMAC устройства $sourceHostName уже есть в таблице DHCP" }
    }
    #если не удалось определить целевой IP адрес - оповестить об этом
    else { write-host "Невозможно определить целевой IP адрес для устройства $sourceHostName, возможно, диапазон исчерпан" }
}
#вывести на экран список устройств и их зарезервированных адресов
$reservedDevices | ft DeviceName,DomainName,MAC,sourceIP,targetIP

#############################################
#Секция добавления принтера на сервер печати#
#############################################

#таблица добавленных принтеров
$addedPrinters = @()

foreach ($reservedDevice in $reservedDevices) {
    
    #если среди портов нет порта с целевым именем
    if (!(get-printerport -name $($reservedDevice.DomainName) -ErrorAction silentlyContinue)) {
        
        #добавить порт принтера
        Add-PrinterPort -PrinterHostAddress $reservedDevice.DomainName `
            -Name        $reservedDevice.DomainName `
            -ErrorAction SilentlyContinue
    }
    #если порт с заданным именем найден на сервере печати - опопвестить об этом
    else { write-host "Порт $($reserveddevice.DomainName) уже существует" }

    #если среди принтеров нет принтера с заданным именем устройства
    if (!(get-Printer -Name $($reservedDevice.DeviceName) -ErrorAction SilentlyContinue)){

        #определить производителя принтера на основании имени устройства
        #здесь имена XPS, EndPoint, TP - взяты для примера
        switch -Wildcard ($reservedDevice.deviceName) {
            "*XPS*"      {$driverName = "Microsoft XPS Document Writer v4"}
            "*EndPoint*" {$driverName = "Microsoft enhanced Point and Print compatibility driver"}
            "*TP*"       {$driverName = "TP Output Gateway PS"}
            default      {$driverName = "Microsoft XPS Document Writer v4"}
        }
        
        #добавить принтер с заданным именем устройства
        Add-Printer -Name $($reservedDevice.DeviceName) `
            -ShareName   $reservedDevice.DeviceName `
            -portname    $($reservedDevice.DomainName) `
            -DriverName  $driverName `
            -ErrorAction SilentlyContinue `
            -shared `
            -published

        #если принтер с заданным именем устройства добавлен успешно
        if ((Get-printer -name $($reservedDevice.DeviceName))) {

            #добавить его описание в таблицу добавленных принтеров
            $templine = "" #временная переменная

            #создать набор свойств для объектов, хранящих добавленные принтеры
            $hashprop = @{
                PrinterName = $reservedDevice.DeviceName
                DriverName =  $driverName
                PortName =    $reservedDevice.DomainName
            }
            $templine = New-Object -TypeName PSCustomObject -Property $hashprop

            #добавить объект из временной переменной в таблицу 
            #добавленных принтеров
            $addedPrinters += $templine
        }

        #если принтер с заданным именем не был добавлен - оповестить об этом
        else { write-host "Возникла ошибка при создании принтера $($reservedDevice.DeviceName)" }        
    }

    #если принтер с заданным именем устройства найден на сервере печати - оповестить об этом
    else { write-host "Принтер $($reservedDevice.DeviceName) уже существует" }
}

#вывести на экран список добавленных принтеров
$addedPrinters

Традиционно, как готовить. Из текста скрипта ясно, что он берет входные данные из csv-файла. Формат его таков:
Name,MAC,IP
Само собой, что эти данные у нас должны быть. Пример файла ниже:

Name,MAC,IP
GEO-01-45-EndPoint,333333333333,192.168.101.54
GEO-01-103-XPS-4,444444444444,192.168.101.75
SVG-01-109-TP-2,555555555555,192.168.102.15

Также скрипт подразумевает, что на принт-сервере уже установлены все необходимые драйверы.

Если используются другие принципы именования портов на принт-сервере и записей на DHCP - изменить логику работы скрипта не так уж сложно. Все в соответствующих переменных.
Можно его еще и расширить, чтобы он на основании имени выбирал, на какой сервер печати принтер устанавливать. Например, если на площадке с индексом 01 свой принт-сервер, и на 04 - тоже свой. C DHCP-сервером - ровно то же самое. В общем, возможностей по его изменению - достаточно.

И, наверное, стоит завести еще одну традицию - напоминание. Предварительное тестирование скрипта в лабораторных условиях - ОБЯЗАТЕЛЬНО. В нем нет никаких действий по удалению имеющихся объектов где-бы то ни было, но тем не менее.

@музыка: Eleni Voilaris - Song to the Earth

@темы: PowerShell, Scripting

URL

все воскрсенье занималась уборкой, до сих пор наприятно б... Час Х приближается. Нервов уже не осталось. Кофеину бы. Проблемы, которые кажутся неразрешимыми, часто испаряются...

временами ощущаю, что загубила в себе великого снабженца!... Ши:Ха! Нет, Сью у нас точно Накагава Норико - из любой с... Корейцы молодцы!!! буду за них болеть!

Комментарии

12.11.2015 в 05:25

Линда Кайе

Тотальная неудачница и убийца жёстких дисков.

- FQDN принтера должно равняться букве "p" c МАС-адресом и доменом: например - p112233445566.example.com

У тебя FQDN – не FQDN ^^ /* Не могла удержаться! */

Также скрипт подразумевает, что на принт-сервере уже установлены все необходимые драйверы.

Помнится, я пожаловалась, что на Хероксовский принтер дрова тяжёлые, и через 3G выковыривать тяжело. Тогда появился Арканоид и сильно опечалил меня пальцовками про то, что он работает только с принтерами, поддерживающими PPD, и никакие драйверы ему не нужны. При всём уважении к титану мысли, мой принтер был куплен для печати диплома по запросу «Заверните самый дешёвый принтер и два картриджа к нему» =_=

Вспомнилось.

URL

12.11.2015 в 05:55

Hikedaya

We rise up for the things we believe in over and over again

У тебя FQDN – не FQDN ^^
Ты про отсутствие точки в конце?

URL

12.11.2015 в 06:26

Hikedaya

We rise up for the things we believe in over and over again

Кстати, про драйверы. HP наконец-то исправились в этом плане и все же выпустили нормальный Universal Print Driver, который в большинстве случаев и используется. И это замечательно, потому что больше не надо закачивать 100-метровые паки под каждую модель. Хватаем UPD для х86 и х64 версий 5 и 6, ставим, наслаждаемся жизнью. Остальные вендоры бы подтянулись - вообще шикарно было бы.

URL

12.11.2015 в 07:35

Линда Кайе

Тотальная неудачница и убийца жёстких дисков.

Ты про отсутствие точки в конце?

Угу ^^

Хватаем UPD для х86 и х64 версий 5 и 6, ставим, наслаждаемся жизнью.

Кажется, я даже их качала, но так и не испробовала. Нашла их пока искала дрова для HP LJ 1200 на x64 Windows 8.

URL

12.11.2015 в 09:32

Hikedaya

We rise up for the things we believe in over and over again

HP LJ 1200
Это ж даже не то, что динозавр, это окаменелость!

URL

12.11.2015 в 09:57

Линда Кайе

Тотальная неудачница и убийца жёстких дисков.

But it works.

URL

12.11.2015 в 13:16

Hikedaya

We rise up for the things we believe in over and over again

Не, я просто предполагал, что к нему уже забросили дрова писать, как это, кажется, с 1536 случилось. Перевели его на UPD, а тот в те славыне времена еще толком не работал.

URL