Модуль Универсальной печати PowerShell

  • Статья

Модуль UniversalPrintManagement PowerShell предназначен для управления ресурсами универсальной печати и администрирования из командной строки. Используйте этот модуль, если требуется создать автоматизированные средства.

Эта статья поможет вам приступить к работе с модулем UniversalPrintManagement и преподает основные понятия, лежащие в его основе.

Установка UniversalPrintManagement

Выполните следующую команду из сеанса PowerShell:

Install-Module UniversalPrintManagement

По умолчанию коллекция PowerShell не используется как доверенный репозиторий для PowerShellGet. При первом использовании PSGallery появится следующий запрос:

Untrusted repository

You are installing the modules from an untrusted repository. If you trust this repository, change
its InstallationPolicy value by running the `Set-PSRepository` cmdlet.

Are you sure you want to install the modules from 'PSGallery'?
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"):

Ответьте Yes или Yes to All, чтобы продолжить установку.

Примечание.

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

Удаление UniversalPrintManagement

Выполните следующую команду из сеанса PowerShell:

Uninstall-Module -Name UniversalPrintManagement

Вход в универсальную печать

Войдите в учетную запись в интерактивном режиме с помощью командлета Connect-UPService.

Connect-UPService

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

Примечание.

Основной целью этого командлета является разрешение неинтерактивного входа в автоматизированные скрипты. Это можно сделать, например, с помощью Connect-UPService -UserPrincipalName username@tenantname.com -Password $variableHoldingSecureString синтаксиса и получения пароля из безопасного хранилища.

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

Командлеты UniversalPrintManagement

Командлеты UniversalPrintManagement соответствуют стандартному соглашению об именовании powerShell VERB-NOUN. Команда описывает действие (напримерGet, , SetGrant, Revoke) и существительное описывает тип ресурса (напримерUPPrinter, , ). UPAccessUPPrintJob Существительные в UniversalPrintManagement всегда начинаются с префикса UP.

Знание существительных и глаголов помогает найти команды с помощью командлета Get-Command . Например, чтобы найти команды, использующие Get команду:

Get-Command -Verb Get -Module UniversalPrintManagement

Чтобы получить сведения о командлете с примерами, выполните следующие действия.

Get-Help Get-UPPrinter -Detailed

[ПРИМЕЧАНИЕ] Командлеты UniversalPrintManagement Get теперь возвращают результаты с маркерами продолжения, чтобы разрешить разбиение на страницы через большие коллекции и повторное выполнение неудачных запросов. Узнайте, как использовать маркеры продолжения. Из-за изменения модели, необходимого для размещения маркеров продолжения, теперь рекомендуется хранить Get результаты командлета в переменной и обращаться к ним через .results. Примеры см. здесь.

Вход

Командлет Description
Подключение-UPService Подключение с учетной записью, прошедшей проверку подлинности для запросов командлета универсальной печати.

Printers

Командлет Description
Get-UPPrinter Используйте этот командлет, чтобы получить сведения об одном или списке принтеров.
Remove-UPPrinter Используйте этот командлет для отмены регистрации принтеров.

Свойства принтера

Командлет Description
Set-UPPrinterProperProperty Используйте этот командлет для обновления изменяемых свойств принтера.

Общие папки принтера

Командлет Description
New-UPPrinterShare Используйте этот командлет для совместного использования принтера.
Get-UPPrinterShare Используйте этот командлет, чтобы получить сведения об одном или списке общих принтеров.
Remove-UPPrinterShare Используйте этот командлет для отмены общего доступа к принтерам, которым ранее был предоставлен общий доступ.
Set-UPPrinterShare Используйте этот командлет, чтобы обновить общую папку принтера, чтобы заменить зарегистрированный принтер из-за обслуживания рабочим.

Разрешения пользователя

Командлет Description
Grant-UPAccess Используйте этот командлет для предоставления доступа к печати пользователю или группе или всем пользователям в организации.
Отзыв-UPAccess Используйте этот командлет, чтобы отозвать доступ к печати от пользователя или группы или всех пользователей в организации.
Get-UPAllowedMember Используйте этот командлет, чтобы получить сведения о пользователях и группах с доступом на печать к конкретному принтеру.

Соединители

Командлет Description
Get-UP Подключение or Используйте этот командлет, чтобы получить сведения об одном или списке соединителей.
Remove-UP Подключение or Используйте этот командлет для отмены регистрации соединителей.

Свойства Подключение or

Командлет Description
Настройка Подключение orProperty Используйте этот командлет для обновления изменяемых свойств соединителя.
Командлет Description
Get-UPPrintJob Используйте этот командлет для получения сведений о заданиях печати, отправленных на принтер.
Командлет Description
Get-UPUsageReport Используйте этот командлет, чтобы получить различные типы отчетов об использовании печати.