Printers... Many printers...

Допустим, есть задача. Расставить много-много принтеров для новоприбывающих сотрудников. А потом эти принтеры сделать доступными по сети через принт-сервер. А чтобы совсем весело было, добавим в эту задачку следующие условия:
- адреса этим принтерам должны прилетать от 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-сервером - ровно то же самое. В общем, возможностей по его изменению - достаточно.

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