Skip to content

Модуль PowerShell, предоставляющий командлеты для выполнения типовых операций при обслуживании / публикации принтеров через GPO в домене Windows.

Notifications You must be signed in to change notification settings

IT-Service/ITG.DomainUtils.Printers

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

65 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ITG.DomainUtils.Printers

Данный модуль предоставляет набор командлет для автоматизации ряда операций с публикацией принтеров в домене Windows.

Использование функционала модуля

В первую очередь необходимо подключить модуль:

Import-Module ITG.DomainUtils.Printers;

До начала использования модуля необходимо инициализировать конфигурацию модуля. Структура модуля поддерживает и локализовать используемые идентификаторы групп и объектов групповой политики, и тип контейнера для групп безопасности. Однако, всеми администраторами должны использоваться общие параметры, поэтому они сохраняются в AD. Для их инициализации и необходимо вызвать один раз следующий командлет:

Initialize-DomainUtilsPrintersConfiguration -Verbose;

Опять-таки, один раз до начала использования модуля для создания контейнера, в котором будут размещаться объекты групп безопасности, используемые очередями печати, необходимо вызвать следующий командлет:

Initialize-ADPrintQueuesEnvironment;

Ну а далее - можно ограничиться одной строкой при регулярном использовании:

Get-ADPrintQueue | Update-ADPrintQueueEnvironment -Verbose;

Данная инструкция для всех очередей печати, опубликованных в AD, создаёт группы безопасности (пользователи и операторы), объекты GPO для них и назначает необходимые права на объекты GPO. В случае наличия групп и GPO командлет не изменяет их.

P.S. Естественно, указанные действия можно выполнить и для конкретного принтера, указав в Get-ADPrintQueue параметр -Filter.

По умолчанию группы безопасности будут созданы в контейнере "Принтеры", и именоваться "Принтер <имя очереди печати> - пользователи" и "Принтер <имя очереди печати> - операторы".

Важно! Данный модуль подразумевает, что при именовании очередей печати (в имени общего ресурса для принтера) Вы используете уникальные идентификаторы, и ни для каких двух разных принтеров эти идентификаторы не будут повторяться.

Объекты групповой политики создаются и именуются "itg Принтер <имя очереди печати>", но не связываются автоматически ни с одним OU. Поэтому после выполнения приведённого выше кода Вам необходимо самостоятельно связать их с необходимым Вам OU. Например, следующим образом:

Get-ADPrintQueue `
| Get-ADPrintQueueGPO `
| Set-GPLink `
	-Target 'OU=Новгородский филиал,OU=ФБУ \"Тест-С .-Петербург\",DC=csm,DC=nov,DC=ru' `
	-LinkEnabled Yes `
	-Verbose `
;

Или же выполнить данные действия с помощью консоли.

Созданные объекты групповой политики предоставляют право членам группы "Принтер ... - пользователи" применения групповой политики, и только членам данной группы право применения политики и предоставлено. Включая необходимых Вам пользователей в данную группу Вы получите следующие результаты:

  • при применении политики пользователю будет "подключен" сетевой принтер
  • пользователь будет иметь право печати на данном принтере

Группа "Принтер ... - операторы" не получает права применения политики, поэтому принтер членам данной группы автоматически подключен не будет. Члены данной группы получат право управления документами в очереди печати, в том числе - и чужими (удаление документов, изменение приоритетов, очистка очереди печати).

На данный момент в стадии разработки набор командлет для публикации локальных принтеров в AD с применением необходимых прав доступа к публикуемым принтерам.

Тестирование модуля и подготовка к публикации

Для сборки модуля использую проект psake. Для инициирования сборки используйте сценарий build.ps1. Для модульных тестов использую проект pester.

Версия модуля: 0.4

ПОДДЕРЖИВАЮТСЯ КОМАНДЛЕТЫ

ADPrintQueue

КРАТКОЕ ОПИСАНИЕ Get-ADPrintQueue

Возвращает один или несколько объектов AD с классом printQueue.

Get-ADPrintQueue [-Filter <String>] [-Properties <String[]>] [-ResultPageSize <Int32>] [-ResultSetSize <Int32>] [-SearchBase <String>] [-SearchScope] [-Server <String>] <CommonParameters>

Get-ADPrintQueue [-Identity] <ADObject> [-Properties <String[]>] [-ResultPageSize <Int32>] [-ResultSetSize <Int32>] [-SearchBase <String>] [-SearchScope] [-Server <String>] <CommonParameters>

Get-ADPrintQueue -LDAPFilter <String> [-Properties <String[]>] [-ResultPageSize <Int32>] [-ResultSetSize <Int32>] [-SearchBase <String>] [-SearchScope] [-Server <String>] <CommonParameters>

КРАТКОЕ ОПИСАНИЕ Test-ADPrintQueue

Определяет существует ли объект AD с классом printQueue с указанными фильтрами.

Test-ADPrintQueue -Filter <String> [-SearchBase <String>] [-SearchScope] [-Server <String>] <CommonParameters>

Test-ADPrintQueue [-Identity] <ADObject> [-SearchBase <String>] [-SearchScope] [-Server <String>] <CommonParameters>

Test-ADPrintQueue -LDAPFilter <String> [-SearchBase <String>] [-SearchScope] [-Server <String>] <CommonParameters>

ADPrintQueueEnvironment

КРАТКОЕ ОПИСАНИЕ Remove-ADPrintQueueEnvironment

Удаляет группы безопасности и объект GPO для указанной очереди печати.

Remove-ADPrintQueueEnvironment [-InputObject] <ADObject> [-Domain <String>] [-Server <String>] [-WhatIf] [-Confirm] <CommonParameters>

КРАТКОЕ ОПИСАНИЕ Update-ADPrintQueueEnvironment

Создаёт (при отсутствии) группы безопасности и объект GPO.

Update-ADPrintQueueEnvironment [-InputObject] <ADObject> [-Domain <String>] [-Server <String>] [-DefaultPrinterSelectionMode <String>] [-Port <String>] [-AsPersistent] [-WhatIf] [-Confirm] <CommonParameters>

ADPrintQueueGPO

КРАТКОЕ ОПИСАНИЕ Get-ADPrintQueueGPO

Возвращает объект групповой политики, применяемой к пользователям указанного объекта printQueue.

Get-ADPrintQueueGPO [-InputObject] <ADObject> [-Domain <String>] [-Server <String>] <CommonParameters>

КРАТКОЕ ОПИСАНИЕ New-ADPrintQueueGPO

Создаёт групповую политику, применяемую к пользователям указанного объекта printQueue.

New-ADPrintQueueGPO [-InputObject] <ADObject> [-Domain <String>] [-Server <String>] [-Force] [-DefaultPrinterSelectionMode <String>] [-Port <String>] [-AsPersistent] [-PassThru] [-WhatIf] [-Confirm] <CommonParameters>

КРАТКОЕ ОПИСАНИЕ Test-ADPrintQueueGPO

Проверяет наличие объекта групповой политики, применяемой к пользователям указанного объекта printQueue.

Test-ADPrintQueueGPO [-InputObject] <ADObject> [-Domain <String>] [-Server <String>] <CommonParameters>

ADPrintQueueGroup

КРАТКОЕ ОПИСАНИЕ Get-ADPrintQueueGroup

Возвращает затребованные группы безопасности для указанного объекта printQueue.

Get-ADPrintQueueGroup [-InputObject] <ADObject> [-GroupType <String[]>] [-Domain <String>] [-Server <String>] <CommonParameters>

КРАТКОЕ ОПИСАНИЕ New-ADPrintQueueGroup

Создаёт группы безопасности для указанного объекта printQueue.

New-ADPrintQueueGroup [-InputObject] <ADObject> [-GroupType <String[]>] [-Domain <String>] [-Server <String>] [-PassThru] [-WhatIf] [-Confirm] <CommonParameters>

ADPrintQueuesEnvironment

КРАТКОЕ ОПИСАНИЕ Initialize-ADPrintQueuesEnvironment

Создаёт корневой контейнер для контейнеров объектов printQueue.

Initialize-ADPrintQueuesEnvironment [[-Domain] <String>] [[-Server] <String>] [-PassThru] [-WhatIf] [-Confirm] <CommonParameters>

DomainUtilsPrintersConfiguration

КРАТКОЕ ОПИСАНИЕ Get-DomainUtilsPrintersConfiguration

Получаем объект, содержащий конфигурацию модуля для указанного домена.

Get-DomainUtilsPrintersConfiguration [[-Domain] <String>] [[-Server] <String>] [-NoCache] <CommonParameters>

КРАТКОЕ ОПИСАНИЕ Initialize-DomainUtilsPrintersConfiguration

Инициализация конфигурации модуля.

Initialize-DomainUtilsPrintersConfiguration [[-Domain] <String>] [[-DomainUtilsBase] <String>] [[-ContainerClass] <String>] [[-Server] <String>] [-Force] [-WhatIf] [-Confirm] <CommonParameters>

КРАТКОЕ ОПИСАНИЕ Test-DomainUtilsPrintersConfiguration

Проверяем наличие конфигурации модуля для указанного домена.

Test-DomainUtilsPrintersConfiguration [[-Domain] <String>] [[-Server] <String>] <CommonParameters>

Printer

КРАТКОЕ ОПИСАНИЕ Test-Printer

Проверяет наличие одной или нескольких локальных очередей печати.

Test-Printer [-Name] <String> <CommonParameters>

PrinterEnvironment

КРАТКОЕ ОПИСАНИЕ Update-PrinterEnvironment

Проверяет, создаёт / обновляет необходимое окружение для локальных очередей печати.

Update-PrinterEnvironment [-Name] <String> [-PassThru] [-WhatIf] [-Confirm] <CommonParameters>

PrinterGroup

КРАТКОЕ ОПИСАНИЕ Get-PrinterGroup

Возвращает затребованные группы безопасности для указанной локальной очереди печати.

Get-PrinterGroup [-Name] <String> [-GroupType <String[]>] <CommonParameters>

КРАТКОЕ ОПИСАНИЕ New-PrinterGroup

Создаёт локальные группы безопасности для указанного объекта printQueue.

New-PrinterGroup [-Name] <String> [-GroupType <String[]>] [-PassThru] [-WhatIf] [-Confirm] <CommonParameters>

КРАТКОЕ ОПИСАНИЕ Test-PrinterGroup

Проверяет наличие затребованных групп безопасности для указанной локальной очереди печати.

Test-PrinterGroup [-Name] <String> [-GroupType <String[]>] <CommonParameters>

ОПИСАНИЕ

Get-ADPrintQueue

Get-ADPrintQueue возвращает объект printQueue или выполняет поиск для выявления множества объектов ADObject класса printQueue.

Параметр Identity (см. about_ActiveDirectory_Identity) указывает объект Active Directory класса printQueue. Вы можете идентифицировать очередь печати через полное имя (DN), GUID, или printQueue имя (CN). Вы можете указать этот параметр явно или передать его по конвейеру.

Для поиска и возврата нескольких объектов используйте параметры Filter или LDAPFilter. Параметр Filter использует PowerShell Expression Language для записи строки запроса для Active Directory (см. about_ActiveDirectory_Filter). Если Вы уже имеете LDAP запрос, используйте параметр LDAPFilter.

ПСЕВДОНИМЫ

Get-ADPrinter

СИНТАКСИС
Get-ADPrintQueue [-Filter <String>] [-Properties <String[]>] [-ResultPageSize <Int32>] [-ResultSetSize <Int32>] [-SearchBase <String>] [-SearchScope] [-Server <String>] <CommonParameters>

Get-ADPrintQueue [-Identity] <ADObject> [-Properties <String[]>] [-ResultPageSize <Int32>] [-ResultSetSize <Int32>] [-SearchBase <String>] [-SearchScope] [-Server <String>] <CommonParameters>

Get-ADPrintQueue -LDAPFilter <String> [-Properties <String[]>] [-ResultPageSize <Int32>] [-ResultSetSize <Int32>] [-SearchBase <String>] [-SearchScope] [-Server <String>] <CommonParameters>
ВХОДНЫЕ ДАННЫЕ
ВЫХОДНЫЕ ДАННЫЕ
ПАРАМЕТРЫ
  • [String] Filter запрос в синтаксисе PowerShell Expression Language (см. about_ActiveDirectory_Filter)

    • Тип: System.String
    • Требуется? нет
    • Позиция? named
    • Значение по умолчанию *
    • Принимать входные данные конвейера? false
    • Принимать подстановочные знаки? нет
  • [ADObject] Identity идентификация объекта AD (см. about_ActiveDirectory_Identity)

    • Тип: Microsoft.ActiveDirectory.Management.ADObject
    • Требуется? да
    • Позиция? 2
    • Принимать входные данные конвейера? true (ByValue)
    • Принимать подстановочные знаки? нет
  • [String] LDAPFilter Строка запроса в синтаксисе ldap

    • Тип: System.String
    • Требуется? да
    • Позиция? named
    • Принимать входные данные конвейера? false
    • Принимать подстановочные знаки? нет
  • [String[]] Properties Перечень свойств объекта printQueue для запроса из ActiveDirectory

    • Тип: System.String[]
    • Требуется? нет
    • Позиция? named
    • Значение по умолчанию @( 'DistinguishedName' , 'Name' , 'printerName' , 'printShareName' , 'serverName' , 'uNCName' , 'driverName' , 'driverVersion' , 'location' , 'portName' , 'printAttributes' , 'printBinNames' , 'printCollate' , 'printColor' , 'printDuplexSupported' , 'printFormName' , 'printKeepPrintedJobs' , 'printLanguage' , 'printMACAddress' , 'printNetworkAddress' , 'printMaxCopies' , 'printMaxResolutionSupported' , 'printMaxXExtent' , 'printMaxYExtent' , 'printMinXExtent' , 'printMinYExtent' , 'printMediaReady' , 'printMediaSupported' , 'printOrientationsSupported' , 'printPagesPerMinute' , 'printSpooling' , 'printStaplingSupported' , 'ObjectClass' , 'ObjectGUID' )
    • Принимать входные данные конвейера? false
    • Принимать подстановочные знаки? нет
  • [Int32] ResultPageSize Количество объектов, включаемых в одну страницу для ldap ответа

    • Тип: System.Int32
    • Требуется? нет
    • Позиция? named
    • Значение по умолчанию 256
    • Принимать входные данные конвейера? false
    • Принимать подстановочные знаки? нет
  • [Int32] ResultSetSize Максимальное количество возвращаемых объектов AD

    • Тип: System.Int32
    • Требуется? нет
    • Позиция? named
    • Принимать входные данные конвейера? false
    • Принимать подстановочные знаки? нет
  • [String] SearchBase путь к контейнеру AD, в котором требуется осуществить поиск

    • Тип: System.String
    • Требуется? нет
    • Позиция? named
    • Принимать входные данные конвейера? false
    • Принимать подстановочные знаки? нет
  • [ADSearchScope] SearchScope область поиска

    • Тип: Microsoft.ActiveDirectory.Management.ADSearchScope
    • Требуется? нет
    • Позиция? named
    • Значение по умолчанию Subtree
    • Принимать входные данные конвейера? false
    • Принимать подстановочные знаки? нет
  • [String] Server Контроллер домена Active Directory

    • Тип: System.String
    • Требуется? нет
    • Позиция? named
    • Принимать входные данные конвейера? false
    • Принимать подстановочные знаки? нет
  • <CommonParameters> Этот командлет поддерживает общие параметры: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer и OutVariable. Для получения дополнительных сведений см. раздел about_CommonParameters.

ПРИМЕРЫ
  1. Возвращает все очереди печати в контейнере 'OU=Finance,OU=UserAccounts,DC=FABRIKAM,DC=COM'.

     Get-ADPrintQueue -Filter * -SearchBase "OU=Finance,OU=UserAccounts,DC=FABRIKAM,DC=COM"
    
ПРИМЕЧАНИЯ

Этот командлет не работает со снимками Active Directory.

ССЫЛКИ ПО ТЕМЕ

Test-ADPrintQueue

Test-ADPrintQueue выполняет поиск для выявления множества объектов ADObject класса printQueue с указанными характеристиками, и возвращает $true если такие объекты есть, и $false в противном случае.

Параметр Identity (см. about_ActiveDirectory_Identity) указывает объект Active Directory класса printQueue. Вы можете идентифицировать очередь печати через полное имя (DN), GUID, или printQueue имя (CN). Вы можете указать этот параметр явно или передать его по конвейеру.

Для поиска и возврата нескольких объектов используйте параметры Filter или LDAPFilter. Параметр Filter использует PowerShell Expression Language для записи строки запроса для Active Directory (см. about_ActiveDirectory_Filter). Если Вы уже имеете LDAP запрос, используйте параметр LDAPFilter.

ПСЕВДОНИМЫ

Test-ADPrinter

СИНТАКСИС
Test-ADPrintQueue -Filter <String> [-SearchBase <String>] [-SearchScope] [-Server <String>] <CommonParameters>

Test-ADPrintQueue [-Identity] <ADObject> [-SearchBase <String>] [-SearchScope] [-Server <String>] <CommonParameters>

Test-ADPrintQueue -LDAPFilter <String> [-SearchBase <String>] [-SearchScope] [-Server <String>] <CommonParameters>
ВХОДНЫЕ ДАННЫЕ
ВЫХОДНЫЕ ДАННЫЕ
  • bool истина - объекты, соответствующие указанным ограничениям, существуют; ложь - не существуют
ПАРАМЕТРЫ
  • [String] Filter запрос в синтаксисе PowerShell Expression Language (см. about_ActiveDirectory_Filter)

    • Тип: System.String
    • Требуется? да
    • Позиция? named
    • Принимать входные данные конвейера? false
    • Принимать подстановочные знаки? нет
  • [ADObject] Identity идентификация объекта AD (см. about_ActiveDirectory_Identity)

    • Тип: Microsoft.ActiveDirectory.Management.ADObject
    • Требуется? да
    • Позиция? 2
    • Принимать входные данные конвейера? true (ByValue)
    • Принимать подстановочные знаки? нет
  • [String] LDAPFilter Строка запроса в синтаксисе ldap

    • Тип: System.String
    • Требуется? да
    • Позиция? named
    • Принимать входные данные конвейера? false
    • Принимать подстановочные знаки? нет
  • [String] SearchBase путь к контейнеру AD, в котором требуется осуществить поиск

    • Тип: System.String
    • Требуется? нет
    • Позиция? named
    • Принимать входные данные конвейера? false
    • Принимать подстановочные знаки? нет
  • [ADSearchScope] SearchScope область поиска

    • Тип: Microsoft.ActiveDirectory.Management.ADSearchScope
    • Требуется? нет
    • Позиция? named
    • Значение по умолчанию Subtree
    • Принимать входные данные конвейера? false
    • Принимать подстановочные знаки? нет
  • [String] Server Контроллер домена Active Directory

    • Тип: System.String
    • Требуется? нет
    • Позиция? named
    • Принимать входные данные конвейера? false
    • Принимать подстановочные знаки? нет
  • <CommonParameters> Этот командлет поддерживает общие параметры: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer и OutVariable. Для получения дополнительных сведений см. раздел about_CommonParameters.

ПРИМЕРЫ
  1. Пример

     Test-ADPrintQueue -Filter * -SearchBase "OU=Finance,OU=UserAccounts,DC=FABRIKAM,DC=COM"
    
ПРИМЕЧАНИЯ

Этот командлет не работает со снимками Active Directory.

ССЫЛКИ ПО ТЕМЕ

Remove-ADPrintQueueEnvironment

Удаляет группы безопасности и объект GPO для указанной через InputObject очереди печати.

ПСЕВДОНИМЫ

Remove-ADPrinterEnvironment

СИНТАКСИС
Remove-ADPrintQueueEnvironment [-InputObject] <ADObject> [-Domain <String>] [-Server <String>] [-WhatIf] [-Confirm] <CommonParameters>
ВХОДНЫЕ ДАННЫЕ
ПАРАМЕТРЫ
  • [ADObject] InputObject идентификация объекта AD (см. about_ActiveDirectory_Identity)

    • Тип: Microsoft.ActiveDirectory.Management.ADObject
    • Требуется? да
    • Позиция? 1
    • Принимать входные данные конвейера? true (ByValue)
    • Принимать подстановочные знаки? нет
  • [String] Domain домен

    • Тип: System.String
    • Требуется? нет
    • Позиция? named
    • Значение по умолчанию ( ( Get-ADDomain ).DNSRoot )
    • Принимать входные данные конвейера? false
    • Принимать подстановочные знаки? нет
  • [String] Server Контроллер домена Active Directory

    • Тип: System.String
    • Требуется? нет
    • Позиция? named
    • Принимать входные данные конвейера? false
    • Принимать подстановочные знаки? нет
  • [SwitchParameter] WhatIf

    • Псевдонимы: wi
  • [SwitchParameter] Confirm

    • Псевдонимы: cf
  • <CommonParameters> Этот командлет поддерживает общие параметры: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer и OutVariable. Для получения дополнительных сведений см. раздел about_CommonParameters.

ПРИМЕРЫ
  1. Удаляем группы безопасности и объекты GPO для всех очередей печати.

     Get-ADPrintQueue | Remove-ADPrintQueueEnvironment -Verbose
    
ПРИМЕЧАНИЯ

Этот командлет не работает со снимками Active Directory.

ССЫЛКИ ПО ТЕМЕ

Update-ADPrintQueueEnvironment

Создаёт (при отсутствии) группы безопасности и объект GPO для указанной через InputObject очереди печати.

ПСЕВДОНИМЫ

Update-ADPrinterEnvironment

СИНТАКСИС
Update-ADPrintQueueEnvironment [-InputObject] <ADObject> [-Domain <String>] [-Server <String>] [-DefaultPrinterSelectionMode <String>] [-Port <String>] [-AsPersistent] [-WhatIf] [-Confirm] <CommonParameters>
ВХОДНЫЕ ДАННЫЕ
ПАРАМЕТРЫ
  • [ADObject] InputObject идентификация объекта AD (см. about_ActiveDirectory_Identity)

    • Тип: Microsoft.ActiveDirectory.Management.ADObject
    • Требуется? да
    • Позиция? 1
    • Принимать входные данные конвейера? true (ByValue)
    • Принимать подстановочные знаки? нет
  • [String] Domain домен

    • Тип: System.String
    • Требуется? нет
    • Позиция? named
    • Значение по умолчанию ( ( Get-ADDomain ).DNSRoot )
    • Принимать входные данные конвейера? false
    • Принимать подстановочные знаки? нет
  • [String] Server Контроллер домена Active Directory

    • Тип: System.String
    • Требуется? нет
    • Позиция? named
    • Принимать входные данные конвейера? false
    • Принимать подстановочные знаки? нет
  • [String] DefaultPrinterSelectionMode Устанавливать ли принтер как принтер по умолчанию при отсутствии локальных принтеров

    • Тип: System.String
    • Псевдонимы: Default
    • Требуется? нет
    • Позиция? named
    • Значение по умолчанию DefaultPrinterWhenNoLocalPrintersPresent
    • Принимать входные данные конвейера? false
    • Принимать подстановочные знаки? нет
  • [String] Port Ассоцирировать подключенный принтер с указанным портом

    • Тип: System.String
    • Требуется? нет
    • Позиция? named
    • Принимать входные данные конвейера? false
    • Принимать подстановочные знаки? нет
  • [SwitchParameter] AsPersistent Устанавливать ли подключение к принтеру как постоянное. В этом случае даже при невозможности применения групповых политик при загрузке принтер будет доступен пользователям. В противном случае принтер будет подключаться только после применения групповых политик и только в случае возможности применения групповых политик.

  • [SwitchParameter] WhatIf

    • Псевдонимы: wi
  • [SwitchParameter] Confirm

    • Псевдонимы: cf
  • <CommonParameters> Этот командлет поддерживает общие параметры: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer и OutVariable. Для получения дополнительных сведений см. раздел about_CommonParameters.

ПРИМЕРЫ
  1. Создаём (при отсутствии) группы безопасности и объект GPO для всех очередей печати

     Get-ADPrintQueue | Update-ADPrintQueueEnvironment -Verbose
    
ПРИМЕЧАНИЯ

Этот командлет не работает со снимками Active Directory.

ССЫЛКИ ПО ТЕМЕ

Get-ADPrintQueueGPO

Возвращает объект групповой политики, созданный для "подключения" членам группы Пользователи принтера указанной через InputObject очереди печати.

ПСЕВДОНИМЫ

Get-ADPrinterGPO

СИНТАКСИС
Get-ADPrintQueueGPO [-InputObject] <ADObject> [-Domain <String>] [-Server <String>] <CommonParameters>
ВХОДНЫЕ ДАННЫЕ
ВЫХОДНЫЕ ДАННЫЕ
  • Microsoft.GroupPolicy.Gpo Возвращает объект групповой политики для указанной очереди печати либо генерирует ошибку.
ПАРАМЕТРЫ
  • [ADObject] InputObject идентификация объекта AD (см. about_ActiveDirectory_Identity)

    • Тип: Microsoft.ActiveDirectory.Management.ADObject
    • Требуется? да
    • Позиция? 1
    • Принимать входные данные конвейера? true (ByValue)
    • Принимать подстановочные знаки? нет
  • [String] Domain домен

    • Тип: System.String
    • Требуется? нет
    • Позиция? named
    • Значение по умолчанию ( ( Get-ADDomain ).DNSRoot )
    • Принимать входные данные конвейера? false
    • Принимать подстановочные знаки? нет
  • [String] Server Контроллер домена Active Directory

    • Тип: System.String
    • Требуется? нет
    • Позиция? named
    • Принимать входные данные конвейера? false
    • Принимать подстановочные знаки? нет
  • <CommonParameters> Этот командлет поддерживает общие параметры: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer и OutVariable. Для получения дополнительных сведений см. раздел about_CommonParameters.

ПРИМЕРЫ
  1. Возвращает объект групповой политики для очереди печати 'prn001'.

     Get-ADPrintQueue -Filter {name -eq 'prn001'} | Get-ADPrintQueueGPO
    
  2. Удаляем групповые политики для всех обнаруженных очередей печати.

     Get-ADPrintQueue | Get-ADPrintQueueGPO | Remove-GPO -Verbose
    
ПРИМЕЧАНИЯ

Этот командлет не работает со снимками Active Directory.

ССЫЛКИ ПО ТЕМЕ

New-ADPrintQueueGPO

New-ADPrintQueueGPO создаёт объект групповой политики для "подключения" членам группы Пользователи принтера указанной через InputObject очереди печати.

ПСЕВДОНИМЫ

New-ADPrinterGPO

СИНТАКСИС
New-ADPrintQueueGPO [-InputObject] <ADObject> [-Domain <String>] [-Server <String>] [-Force] [-DefaultPrinterSelectionMode <String>] [-Port <String>] [-AsPersistent] [-PassThru] [-WhatIf] [-Confirm] <CommonParameters>
ВХОДНЫЕ ДАННЫЕ
ВЫХОДНЫЕ ДАННЫЕ
  • Microsoft.GroupPolicy.Gpo Возвращает созданную групповую политику при выполнении с ключом PassThru.
ПАРАМЕТРЫ
  • [ADObject] InputObject идентификация объекта AD (см. about_ActiveDirectory_Identity)

    • Тип: Microsoft.ActiveDirectory.Management.ADObject
    • Требуется? да
    • Позиция? 1
    • Принимать входные данные конвейера? true (ByValue)
    • Принимать подстановочные знаки? нет
  • [String] Domain домен

    • Тип: System.String
    • Требуется? нет
    • Позиция? named
    • Значение по умолчанию ( ( Get-ADDomain ).DNSRoot )
    • Принимать входные данные конвейера? false
    • Принимать подстановочные знаки? нет
  • [String] Server Контроллер домена Active Directory

    • Тип: System.String
    • Требуется? нет
    • Позиция? named
    • Принимать входные данные конвейера? false
    • Принимать подстановочные знаки? нет
  • [SwitchParameter] Force Обновлять ли существующие объекты GPO

  • [String] DefaultPrinterSelectionMode Устанавливать ли принтер как принтер по умолчанию при отсутствии локальных принтеров

    • Тип: System.String
    • Псевдонимы: Default
    • Требуется? нет
    • Позиция? named
    • Значение по умолчанию DefaultPrinterWhenNoLocalPrintersPresent
    • Принимать входные данные конвейера? false
    • Принимать подстановочные знаки? нет
  • [String] Port Ассоцирировать подключенный принтер с указанным портом

    • Тип: System.String
    • Требуется? нет
    • Позиция? named
    • Принимать входные данные конвейера? false
    • Принимать подстановочные знаки? нет
  • [SwitchParameter] AsPersistent Устанавливать ли подключение к принтеру как постоянное. В этом случае даже при невозможности применения групповых политик при загрузке принтер будет доступен пользователям. В противном случае принтер будет подключаться только после применения групповых политик и только в случае возможности применения групповых политик.

  • [SwitchParameter] PassThru Передавать ли созданные GPO далее по конвейеру

  • [SwitchParameter] WhatIf

    • Псевдонимы: wi
  • [SwitchParameter] Confirm

    • Псевдонимы: cf
  • <CommonParameters> Этот командлет поддерживает общие параметры: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer и OutVariable. Для получения дополнительных сведений см. раздел about_CommonParameters.

ПРИМЕРЫ
  1. Создаёт объект групповой политики для очереди печати 'prn001'.

     Get-ADPrintQueue -Filter {name -eq 'prn001'} | New-ADPrintQueueGPO
    
  2. Создаёт групповые политики для всех обнаруженных очередей печати либо обновляет их (если GPO существуют).

     Get-ADPrintQueue | New-ADPrintQueueGPO -Force
    
ПРИМЕЧАНИЯ

Этот командлет не работает со снимками Active Directory.

ССЫЛКИ ПО ТЕМЕ

Test-ADPrintQueueGPO

Возвращает $true или $false, указывая наличие либо отсутствие объекта групповой политики для указанной через InputObject очереди печати.

ПСЕВДОНИМЫ

Test-ADPrinterGPO

СИНТАКСИС
Test-ADPrintQueueGPO [-InputObject] <ADObject> [-Domain <String>] [-Server <String>] <CommonParameters>
ВХОДНЫЕ ДАННЫЕ
ВЫХОДНЫЕ ДАННЫЕ
  • Bool Подтверждает или опровергает факт наличия объекта групповой политики для указанной очереди печати.
ПАРАМЕТРЫ
  • [ADObject] InputObject идентификация объекта AD (см. about_ActiveDirectory_Identity)

    • Тип: Microsoft.ActiveDirectory.Management.ADObject
    • Требуется? да
    • Позиция? 1
    • Принимать входные данные конвейера? true (ByValue)
    • Принимать подстановочные знаки? нет
  • [String] Domain домен

    • Тип: System.String
    • Требуется? нет
    • Позиция? named
    • Значение по умолчанию ( ( Get-ADDomain ).DNSRoot )
    • Принимать входные данные конвейера? false
    • Принимать подстановочные знаки? нет
  • [String] Server Контроллер домена Active Directory

    • Тип: System.String
    • Требуется? нет
    • Позиция? named
    • Принимать входные данные конвейера? false
    • Принимать подстановочные знаки? нет
  • <CommonParameters> Этот командлет поддерживает общие параметры: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer и OutVariable. Для получения дополнительных сведений см. раздел about_CommonParameters.

ПРИМЕРЫ
  1. Проверяем наличие GPO для очереди печати 'prn001'.

     Get-ADPrintQueue -Filter {name -eq 'prn001'} | Test-ADPrintQueueGPO
    
  2. Создаём недостающие объекты политик.

     Get-ADPrintQueue | ? { -not ( $_ | Test-ADPrintQueueGPO ) } | New-ADPrintQueueGPO -Verbose
    
ПРИМЕЧАНИЯ

Этот командлет не работает со снимками Active Directory.

ССЫЛКИ ПО ТЕМЕ

Get-ADPrintQueueGroup

Get-ADPrintQueueGroup возвращает группы безопасности (Пользователи принтера, Операторы принтера) для указанного через InputObject объекта printQueue.

ПСЕВДОНИМЫ

Get-ADPrinterGroup

СИНТАКСИС
Get-ADPrintQueueGroup [-InputObject] <ADObject> [-GroupType <String[]>] [-Domain <String>] [-Server <String>] <CommonParameters>
ВХОДНЫЕ ДАННЫЕ
ВЫХОДНЫЕ ДАННЫЕ
ПАРАМЕТРЫ
  • [ADObject] InputObject идентификация объекта AD (см. about_ActiveDirectory_Identity)

    • Тип: Microsoft.ActiveDirectory.Management.ADObject
    • Требуется? да
    • Позиция? 1
    • Принимать входные данные конвейера? true (ByValue)
    • Принимать подстановочные знаки? нет
  • [String[]] GroupType тип группы: Users (группа пользователей), Administrators (группа администраторов). Группа пользователей получит право применения групповой политики для этой очереди печати, и право печати. Группа администраторов не получит право применения GPO, но получит право печати и право управления всеми документами в указанной очереди печати.

    • Тип: System.String[]
    • Требуется? нет
    • Позиция? named
    • Значение по умолчанию Users
    • Принимать входные данные конвейера? false
    • Принимать подстановочные знаки? нет
  • [String] Domain домен

    • Тип: System.String
    • Требуется? нет
    • Позиция? named
    • Значение по умолчанию ( ( Get-ADDomain ).DNSRoot )
    • Принимать входные данные конвейера? false
    • Принимать подстановочные знаки? нет
  • [String] Server Контроллер домена Active Directory

    • Тип: System.String
    • Требуется? нет
    • Позиция? named
    • Принимать входные данные конвейера? false
    • Принимать подстановочные знаки? нет
  • <CommonParameters> Этот командлет поддерживает общие параметры: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer и OutVariable. Для получения дополнительных сведений см. раздел about_CommonParameters.

ПРИМЕРЫ
  1. Возвращает группу безопасности Пользователи принтера для очереди печати 'prn001'.

     Get-ADPrintQueue -Filter {name -eq 'prn001'} | Get-ADPrintQueueGroup -GroupType Users
    
ПРИМЕЧАНИЯ

Этот командлет не работает со снимками Active Directory.

ССЫЛКИ ПО ТЕМЕ

New-ADPrintQueueGroup

New-ADPrintQueueGroup создаёт группы безопасности (Пользователи принтера, Операторы принтера) для указанного через InputObject объекта printQueue.

ПСЕВДОНИМЫ

New-ADPrinterGroup

СИНТАКСИС
New-ADPrintQueueGroup [-InputObject] <ADObject> [-GroupType <String[]>] [-Domain <String>] [-Server <String>] [-PassThru] [-WhatIf] [-Confirm] <CommonParameters>
ВХОДНЫЕ ДАННЫЕ
ВЫХОДНЫЕ ДАННЫЕ
ПАРАМЕТРЫ
  • [ADObject] InputObject идентификация объекта AD (см. about_ActiveDirectory_Identity)

    • Тип: Microsoft.ActiveDirectory.Management.ADObject
    • Требуется? да
    • Позиция? 1
    • Принимать входные данные конвейера? true (ByValue)
    • Принимать подстановочные знаки? нет
  • [String[]] GroupType тип группы: Users (группа пользователей), Administrators (группа администраторов). Группа пользователей получит право применения групповой политики для этой очереди печати, и право печати. Группа администраторов не получит право применения GPO, но получит право печати и право управления всеми документами в указанной очереди печати.

    • Тип: System.String[]
    • Требуется? нет
    • Позиция? named
    • Значение по умолчанию ( 'Users', 'Administrators' )
    • Принимать входные данные конвейера? false
    • Принимать подстановочные знаки? нет
  • [String] Domain домен

    • Тип: System.String
    • Требуется? нет
    • Позиция? named
    • Значение по умолчанию ( ( Get-ADDomain ).DNSRoot )
    • Принимать входные данные конвейера? false
    • Принимать подстановочные знаки? нет
  • [String] Server Контроллер домена Active Directory

    • Тип: System.String
    • Требуется? нет
    • Позиция? named
    • Принимать входные данные конвейера? false
    • Принимать подстановочные знаки? нет
  • [SwitchParameter] PassThru Передавать ли созданные группы далее по конвейеру

  • [SwitchParameter] WhatIf

    • Псевдонимы: wi
  • [SwitchParameter] Confirm

    • Псевдонимы: cf
  • <CommonParameters> Этот командлет поддерживает общие параметры: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer и OutVariable. Для получения дополнительных сведений см. раздел about_CommonParameters.

ПРИМЕРЫ
  1. Создаёт группы безопасности для очереди печати 'prn001'.

     Get-ADPrintQueue -Filter {name -eq 'prn001'} | New-ADPrintQueueGroup
    
  2. Создаёт группы безопасности "Пользователи принтера" для всех обнаруженных очередей печати.

     Get-ADPrintQueue | New-ADPrintQueueGroup -GroupType Users
    
ПРИМЕЧАНИЯ

Этот командлет не работает со снимками Active Directory.

ССЫЛКИ ПО ТЕМЕ

Initialize-ADPrintQueuesEnvironment

Создаёт корневой контейнер для контейнеров объектов printQueue. Данную функцию следует вызывать однократно для создания необходимых контейнеров и объектов.

СИНТАКСИС
Initialize-ADPrintQueuesEnvironment [[-Domain] <String>] [[-Server] <String>] [-PassThru] [-WhatIf] [-Confirm] <CommonParameters>
ВЫХОДНЫЕ ДАННЫЕ
ПАРАМЕТРЫ
  • [String] Domain домен, в котором инициализируем окружение для очередей печати

    • Тип: System.String
    • Требуется? нет
    • Позиция? 1
    • Значение по умолчанию ( ( Get-ADDomain ).DNSRoot )
    • Принимать входные данные конвейера? false
    • Принимать подстановочные знаки? нет
  • [String] Server Контроллер домена Active Directory

    • Тип: System.String
    • Требуется? нет
    • Позиция? 2
    • Принимать входные данные конвейера? false
    • Принимать подстановочные знаки? нет
  • [SwitchParameter] PassThru Передавать ли созданный контейнер далее по конвейеру

  • [SwitchParameter] WhatIf

    • Псевдонимы: wi
  • [SwitchParameter] Confirm

    • Псевдонимы: cf
  • <CommonParameters> Этот командлет поддерживает общие параметры: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer и OutVariable. Для получения дополнительных сведений см. раздел about_CommonParameters.

ПРИМЕРЫ
  1. Создаёт корневой контейнер с параметрами по умолчанию.

     Initialize-ADPrintQueuesEnvironment
    
ПРИМЕЧАНИЯ

Этот командлет не работает со снимками Active Directory.

ССЫЛКИ ПО ТЕМЕ

Get-DomainUtilsPrintersConfiguration

Получаем объект, содержащий конфигурацию модуля для указанного домена.

СИНТАКСИС
Get-DomainUtilsPrintersConfiguration [[-Domain] <String>] [[-Server] <String>] [-NoCache] <CommonParameters>
ПАРАМЕТРЫ
  • [String] Domain домен, для которого запрашиваем конфигурацию модуля

    • Тип: System.String
    • Требуется? нет
    • Позиция? 1
    • Значение по умолчанию ( ( Get-ADDomain ).DNSRoot )
    • Принимать входные данные конвейера? false
    • Принимать подстановочные знаки? нет
  • [String] Server Контроллер домена Active Directory

    • Тип: System.String
    • Требуется? нет
    • Позиция? 2
    • Принимать входные данные конвейера? false
    • Принимать подстановочные знаки? нет
  • [SwitchParameter] NoCache Игнорировать кеш и принудительно перечитать конфигурацию из AD

  • <CommonParameters> Этот командлет поддерживает общие параметры: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer и OutVariable. Для получения дополнительных сведений см. раздел about_CommonParameters.

ПРИМЕРЫ
  1. Определяем класс контейнеров, используемых модулем для домена csm.nov.ru.

     ( Get-DomainUtilsPrintersConfiguration -Domain 'csm.nov.ru' ).ContainerClass
    
ССЫЛКИ ПО ТЕМЕ

Initialize-DomainUtilsPrintersConfiguration

Инициализирует конфигурацию модуля. Конфигурация модуля сохраняется в Active Directory, полный путь для домена csm.nov.ru будет CN=ITG DomainUtils,CN=Optional Features,CN=Directory Service,CN=Windows NT,CN=Services,CN=Configuration,DC=csm,DC=nov,DC=ru.

Конфигурация сохраняется в AD (и загружается из AD) по ряду причин. В частности, модуль поддерживает локализацию и поддерживает различные классы контейнеров. Но с момента начала его применения всеми администраторами домена должна использоваться одна и та же конфигурация модуля, в частности - типы контейнеров, корневой контейнер для размещения создаваемых вспомогательных групп, и так далее.

В случае наличия конфигурации в AD её можно принудительно перезаписать, используя ключ -Force, однако этот шаг не приведёт к фактическому изменению типов контейнеров, их местоположения, аттрибутов созданных групп. Поэтому пользоваться этой возможностью следует с особой осторожностью.

СИНТАКСИС
Initialize-DomainUtilsPrintersConfiguration [[-Domain] <String>] [[-DomainUtilsBase] <String>] [[-ContainerClass] <String>] [[-Server] <String>] [-Force] [-WhatIf] [-Confirm] <CommonParameters>
ПАРАМЕТРЫ
  • [String] Domain Домен, для которого инициализируем конфигурацию модуля. Если не указан - домен пользователя, от имени которого запущен сценарий.

    • Тип: System.String
    • Требуется? нет
    • Позиция? 1
    • Значение по умолчанию ( ( Get-ADDomain ).DNSRoot )
    • Принимать входные данные конвейера? false
    • Принимать подстановочные знаки? нет
  • [String] DomainUtilsBase Путь (DN) к контейнеру AD, в котором расположены все контейнеры, используемые утилитами данного модуля. Указывается без DN домена. Например, для CN=ITG,DC=csm,DC=nov,DC=ru следует указать CN=ITG. По умолчанию в качестве корневого контейнера используется корневой контейнер домена.

    • Тип: System.String
    • Требуется? нет
    • Позиция? 2
    • Принимать входные данные конвейера? false
    • Принимать подстановочные знаки? нет
  • [String] ContainerClass Класс контейнеров, используемых данным модулем

    • Тип: System.String
    • Требуется? нет
    • Позиция? 3
    • Значение по умолчанию container
    • Принимать входные данные конвейера? false
    • Принимать подстановочные знаки? нет
  • [String] Server Контроллер домена Active Directory. Если не указан явно - используется эмулятор роли PDC в указанном домене.

    • Тип: System.String
    • Требуется? нет
    • Позиция? 4
    • Принимать входные данные конвейера? false
    • Принимать подстановочные знаки? нет
  • [SwitchParameter] Force Перезаписывать ли конфигурацию в случае её наличия

  • [SwitchParameter] WhatIf

    • Псевдонимы: wi
  • [SwitchParameter] Confirm

    • Псевдонимы: cf
  • <CommonParameters> Этот командлет поддерживает общие параметры: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer и OutVariable. Для получения дополнительных сведений см. раздел about_CommonParameters.

ПРИМЕРЫ
  1. Инициализируем конфигурацию модуля для домена пользователя, от имени которого выполнен командлет.

     Initialize-DomainUtilsPrintersConfiguration
    
ССЫЛКИ ПО ТЕМЕ

Test-DomainUtilsPrintersConfiguration

Проверяем наличие конфигурации модуля для указанного домена.

СИНТАКСИС
Test-DomainUtilsPrintersConfiguration [[-Domain] <String>] [[-Server] <String>] <CommonParameters>
ПАРАМЕТРЫ
  • [String] Domain домен, для которого проверяем наличие конфигурации модуля

    • Тип: System.String
    • Требуется? нет
    • Позиция? 1
    • Значение по умолчанию ( ( Get-ADDomain ).DNSRoot )
    • Принимать входные данные конвейера? false
    • Принимать подстановочные знаки? нет
  • [String] Server Контроллер домена Active Directory

    • Тип: System.String
    • Требуется? нет
    • Позиция? 2
    • Принимать входные данные конвейера? false
    • Принимать подстановочные знаки? нет
  • <CommonParameters> Этот командлет поддерживает общие параметры: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer и OutVariable. Для получения дополнительных сведений см. раздел about_CommonParameters.

ПРИМЕРЫ
  1. Проверяем существование конфигурации для домена csm.nov.ru.

     Test-DomainUtilsPrintersConfiguration -Domain 'csm.nov.ru'
    
ССЫЛКИ ПО ТЕМЕ

Test-Printer

Проверяет наличие одной или нескольких локальных очередей печати.

ПСЕВДОНИМЫ

Test-PrintQueue

СИНТАКСИС
Test-Printer [-Name] <String> <CommonParameters>
ВХОДНЫЕ ДАННЫЕ
  • System.Printing.PrintQueue Очередь печати.
  • Microsoft.Management.Infrastructure.CimInstance Объект очереди печати, возвращаемый Get-Printer.
ВЫХОДНЫЕ ДАННЫЕ
  • System.Bool Подтверждает наличие либо отсутствие указанной очереди печати на локальном сервере печати.
ПАРАМЕТРЫ
  • [String] Name идентификация объекта PrintQueue - имя "принтера"

    • Тип: System.String
    • Требуется? да
    • Позиция? 2
    • Принимать входные данные конвейера? true (ByPropertyName)
    • Принимать подстановочные знаки? нет
  • <CommonParameters> Этот командлет поддерживает общие параметры: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer и OutVariable. Для получения дополнительных сведений см. раздел about_CommonParameters.

ПРИМЕРЫ
  1. Проверяет наличие на локальном сервере печати очереди печати с именем P00001.

     Test-Printer -Name 'P00001'
    
ССЫЛКИ ПО ТЕМЕ

Update-PrinterEnvironment

Update-PrinterEnvironment проверяет и создаёт (при отсутствии) локальные группы безопасности для указанного принтера, изменяет права доступа к принтеру (предоставляет права печати на данном принтере только локальным группам Пользователи принтера и Администраторы принтера, предоставляет право управления всеми документами в очереди группе Администраторы принтера и локальной группе Администраторы).

Далее, обеспечивает общий доступ к принтеру, публикует его в AD, обновляет для него окружение в AD, и включает доменные группы Пользователей и Администраторов этого принтера в его локальные группы.

ПСЕВДОНИМЫ

Update-PrintQueueEnvironment

СИНТАКСИС
Update-PrinterEnvironment [-Name] <String> [-PassThru] [-WhatIf] [-Confirm] <CommonParameters>
ВХОДНЫЕ ДАННЫЕ
  • System.Printing.PrintQueue Объект очереди печати.
  • Microsoft.Management.Infrastructure.CimInstance Объект очереди печати, возвращаемый Get-Printer.
ВЫХОДНЫЕ ДАННЫЕ
  • System.Printing.PrintQueue Исходный объект принтера при выполнении с ключом PassThru.
  • Microsoft.Management.Infrastructure.CimInstance Исходный объект принтера при выполнении с ключом PassThru.
ПАРАМЕТРЫ
  • [String] Name Имя локальной очереди печати

    • Тип: System.String
    • Требуется? да
    • Позиция? 1
    • Принимать входные данные конвейера? true (ByPropertyName)
    • Принимать подстановочные знаки? нет
  • [SwitchParameter] PassThru Передавать ли объект принтера далее по конвейеру

  • [SwitchParameter] WhatIf

    • Псевдонимы: wi
  • [SwitchParameter] Confirm

    • Псевдонимы: cf
  • <CommonParameters> Этот командлет поддерживает общие параметры: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer и OutVariable. Для получения дополнительных сведений см. раздел about_CommonParameters.

ПРИМЕРЫ
  1. Создаём / обновляем окружение для локальной очереди печати 'P00001'.

     Get-Printer 'P00001' | Update-PrinterEnvironment
    
  2. Создаём / обновляем окружение для всех локальных принтеров.

     Get-Printer | Update-PrinterEnvironment
    
ПРИМЕЧАНИЯ

Командлет разработан исключительно для работы с локальными очередями печати. Его не следует использовать для подключенных сетевых принтеров.

ССЫЛКИ ПО ТЕМЕ

Get-PrinterGroup

Get-PrinterGroup возвращает группы безопасности (Пользователи принтера, Операторы принтера) для указанного (по конвейеру) объекта локальной очереди печати.

ПСЕВДОНИМЫ

Get-PrintQueueGroup

СИНТАКСИС
Get-PrinterGroup [-Name] <String> [-GroupType <String[]>] <CommonParameters>
ВХОДНЫЕ ДАННЫЕ
  • System.Printing.PrintQueue Объект очереди печати.
  • Microsoft.Management.Infrastructure.CimInstance Объект очереди печати, возвращаемый Get-Printer.
ВЫХОДНЫЕ ДАННЫЕ
  • System.DirectoryServices.AccountManagement.GroupPrincipal Возвращает затребованные группы безопасности.
ПАРАМЕТРЫ
  • [String] Name Имя локальной очереди печати

    • Тип: System.String
    • Требуется? да
    • Позиция? 1
    • Принимать входные данные конвейера? true (ByPropertyName)
    • Принимать подстановочные знаки? нет
  • [String[]] GroupType тип группы: Users (группа пользователей), Administrators (группа администраторов). Группа пользователей получит право применения групповой политики для этой очереди печати, и право печати. Группа администраторов не получит право применения GPO, но получит право печати и право управления всеми документами в указанной очереди печати.

    • Тип: System.String[]
    • Требуется? нет
    • Позиция? named
    • Значение по умолчанию Users
    • Принимать входные данные конвейера? false
    • Принимать подстановочные знаки? нет
  • <CommonParameters> Этот командлет поддерживает общие параметры: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer и OutVariable. Для получения дополнительных сведений см. раздел about_CommonParameters.

ПРИМЕРЫ
  1. Возвращает группу безопасности Пользователи принтера для очереди печати 'P00001'.

     Get-Printer -Name 'P00001' | Get-PrinterGroup -GroupType Users
    
ССЫЛКИ ПО ТЕМЕ

New-PrinterGroup

New-PrinterGroup создаёт группы безопасности (Пользователи принтера, Операторы принтера) для указанного через InputObject объекта printQueue на локальном сервере печати.

ПСЕВДОНИМЫ

New-PrintQueueGroup

СИНТАКСИС
New-PrinterGroup [-Name] <String> [-GroupType <String[]>] [-PassThru] [-WhatIf] [-Confirm] <CommonParameters>
ВХОДНЫЕ ДАННЫЕ
  • System.Printing.PrintQueue Объект очереди печати.
  • Microsoft.Management.Infrastructure.CimInstance Объект очереди печати, возвращаемый Get-Printer.
ВЫХОДНЫЕ ДАННЫЕ
  • System.DirectoryServices.AccountManagement.GroupPrincipal Возвращает созданные группы безопасности при выполнении с ключом PassThru.
ПАРАМЕТРЫ
  • [String] Name Имя локальной очереди печати

    • Тип: System.String
    • Требуется? да
    • Позиция? 1
    • Принимать входные данные конвейера? true (ByPropertyName)
    • Принимать подстановочные знаки? нет
  • [String[]] GroupType тип группы: Users (группа пользователей), Administrators (группа администраторов). Группа пользователей получит только права печати и управления собственными документами. Группа администраторов получит и право печати, и права на управление всеми документами в очереди.

    • Тип: System.String[]
    • Требуется? нет
    • Позиция? named
    • Значение по умолчанию ( 'Users', 'Administrators' )
    • Принимать входные данные конвейера? false
    • Принимать подстановочные знаки? нет
  • [SwitchParameter] PassThru Передавать ли созданные группы далее по конвейеру

  • [SwitchParameter] WhatIf

    • Псевдонимы: wi
  • [SwitchParameter] Confirm

    • Псевдонимы: cf
  • <CommonParameters> Этот командлет поддерживает общие параметры: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer и OutVariable. Для получения дополнительных сведений см. раздел about_CommonParameters.

ПРИМЕРЫ
  1. Создаёт группы безопасности для очереди печати 'p00001' на локальном сервере печати.

     Get-Printer 'P00001' | New-PrinterGroup
    
  2. Создаёт локальные группы безопасности "Пользователи принтера" для всех обнаруженных локальных принтеров.

     Get-Printer | New-PrinterGroup -GroupType Users
    
ПРИМЕЧАНИЯ

Командлет разработан исключительно для работы с локальными очередями печати. Следует избегать использовать его для подключенных сетевых принтеров.

ССЫЛКИ ПО ТЕМЕ

Test-PrinterGroup

Проверяет наличие затребованных групп безопасности для указанной локальной очереди печати.

ПСЕВДОНИМЫ

Test-PrintQueueGroup

СИНТАКСИС
Test-PrinterGroup [-Name] <String> [-GroupType <String[]>] <CommonParameters>
ВХОДНЫЕ ДАННЫЕ
  • System.Printing.PrintQueue Объект очереди печати.
  • Microsoft.Management.Infrastructure.CimInstance Объект очереди печати, возвращаемый Get-Printer.
ВЫХОДНЫЕ ДАННЫЕ
  • System.Bool $true если группа существует, $false - если не существует.
ПАРАМЕТРЫ
  • [String] Name Имя локальной очереди печати

    • Тип: System.String
    • Требуется? да
    • Позиция? 1
    • Принимать входные данные конвейера? true (ByPropertyName)
    • Принимать подстановочные знаки? нет
  • [String[]] GroupType тип группы: Users (группа пользователей), Administrators (группа администраторов).

    • Тип: System.String[]
    • Требуется? нет
    • Позиция? named
    • Значение по умолчанию Users
    • Принимать входные данные конвейера? false
    • Принимать подстановочные знаки? нет
  • <CommonParameters> Этот командлет поддерживает общие параметры: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer и OutVariable. Для получения дополнительных сведений см. раздел about_CommonParameters.

ПРИМЕРЫ
  1. Проверяем наличие группы безопасности Пользователи принтера для очереди печати 'P00001'.

     Get-Printer 'P00001' | Test-PrinterGroup -GroupType Users
    
ССЫЛКИ ПО ТЕМЕ

Генератор: ITG.Readme.

About

Модуль PowerShell, предоставляющий командлеты для выполнения типовых операций при обслуживании / публикации принтеров через GPO в домене Windows.

Resources

Stars

Watchers

Forks

Packages

No packages published