moduł Universal Print programu PowerShell

Moduł programu PowerShell UniversalPrintManagementmoduł jest przeznaczony do zarządzania zasobami usługi Universal Print i administrowania nimi z poziomu wiersza polecenia. Użyj tego modułu, gdy chcesz tworzyć zautomatyzowane narzędzia.

Ten artykuł ułatwia rozpoczęcie pracy z modułem UniversalPrintManagement i uczy podstawowych pojęć związanych z nim.

Instalowanie rozwiązania UniversalPrintManagement

Uruchom następujące polecenie z sesji programu PowerShell:

Install-Module UniversalPrintManagement

Galeria programu PowerShell domyślnie nie jest skonfigurowana jako zaufane repozytorium modułu PowerShellGet. Przy pierwszym użyciu PSGallery zostanie wyświetlony następujący komunikat:

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"):

Odpowiedz Yes lub Yes to All, aby kontynuować instalację.

Note

Aby uzyskać dodatkowe informacje na temat instalowania modułów PSGallery w scenariuszach offline, zapoznaj się z Galeria programu PowerShell.

Odinstalowywanie rozwiązania UniversalPrintManagement

Uruchom następujące polecenie z sesji programu PowerShell:

Uninstall-Module -Name UniversalPrintManagement

Zaloguj się do Universal Print

Zaloguj się interaktywnie za pomocą polecenia cmdlet Connect-UPService.

Connect-UPService

Zostanie wyświetlone okno dialogowe logowania w celu podania nazwy użytkownika i hasła dla konta Azure lub wybrania jednego z poprzednio zapisanych kont.

Note

Głównym celem tego polecenia cmdlet jest umożliwienie logowania nieinterakcyjnego w zautomatyzowanych skryptach. Można to zrobić, na przykład używając składni Connect-UPService -UserPrincipalName username@tenantname.com -Password $variableHoldingSecureString i pobierając hasło z bezpiecznego magazynu.

Po zalogowaniu użyj dostępnych poleceń cmdlet w module, aby uzyskać dostęp do zasobów drukarki i zarządzać nimi.

Polecenia programu cmdlet UniversalPrintManagement

Polecenia cmdlet UniversalPrintManagement są zgodne ze standardową konwencją nazewnictwa stosowaną w programie PowerShell, VERB-NOUN. Czasownik opisuje akcję (przykłady obejmują , , GetSet, Grant) i rzeczownik opisuje typ zasobu (przykłady to RevokeUPPrinter, UPPrintJob, UPAccess). Rzeczowniki w UniversalPrintManagement zawsze zaczynają się prefiksem UP.

Znajomość rzeczowników i czasowników pomaga znajdować polecenia przy użyciu polecenia cmdlet Get-Command. Aby na przykład znaleźć polecenia używające czasownika Get :

Get-Command -Verb Get -Module UniversalPrintManagement

Aby uzyskać szczegóły polecenia cmdlet z przykładami:

Get-Help Get-UPPrinter -Detailed

[UWAGA] Polecenia cmdletu UniversalPrintManagement Get zwracają teraz wyniki wraz z tokenami kontynuacji, aby umożliwić stronicowanie dużych kolekcji i ponawianie nieudanych żądań. Dowiedz się, jak używać tokenów kontynuacji. Ze względu na zmianę modelu wymaganą do uwzględnienia tokenów kontynuacji zaleca się przechowywanie Get wyników poleceń cmdlet w zmiennej i uzyskiwanie do nich dostępu za pośrednictwem metody .results. Zobacz przykłady tutaj.

Sign-in

cmdlet Description
Connect-UPService Nawiązuje połączenie z uwierzytelnionym kontem używanym do żądań cmdletu Universal Print.

Printers

cmdlet Description
Get-UPPrinter Użyj tego polecenia cmdletu, aby uzyskać informacje o pojedynczej drukarce lub liście drukarek.
Remove-UPPrinter Użyj tego polecenia, aby usunąć rejestrację drukarek.

Właściwości drukarki

cmdlet Description
Set-UPPrinterProperty Użyj tego polecenia cmdlet, aby zaktualizować modyfikowalne właściwości drukarki.

Udostępnione drukarki

cmdlet Description
New-UPPrinterShare Użyj tego polecenia cmdlet, aby udostępnić drukarkę.
Get-UPPrinterShare Użyj tego polecenia cmdlet, aby uzyskać informacje o jednej lub liście drukarek udostępnionych.
Remove-UPPrinterShare Użyj tego polecenia cmdlet, aby anulować udostępnianie drukarek, które zostały udostępnione wcześniej.
Set-UPPrinterShare Użyj tego polecenia cmdlet, aby zaktualizować udział drukarki i zastąpić zarejestrowaną drukarkę przeznaczoną do konserwacji sprawną drukarką.

Uprawnienia użytkowników

cmdlet Description
Grant-UPAccess Użyj tego polecenia cmdlet, aby udzielić dostępu do drukowania użytkownikowi lub grupie lub wszystkim użytkownikom w organizacji.
Revoke-UPAccess Użyj tego polecenia cmdlet, aby odwołać dostęp do drukowania od użytkownika lub grupy lub wszystkich użytkowników w organizacji.
Get-UPAllowedMember Użyj tego polecenia cmdlet, aby uzyskać informacje o użytkownikach i grupach mających uprawnienia do drukowania na określonej drukarce.

Łączniki

cmdlet Description
Get-UPConnector Użyj tego polecenia cmdlet, aby uzyskać informacje o jednym łączniku lub liście łączników.
Usuń-UPConnector Użyj tego polecenia cmdlet, aby wyrejestrować łączniki.

Właściwości łącznika

cmdlet Description
Set-UPConnectorProperty (Ustaw właściwość UPConnector) Użyj tego polecenia cmdlet, aby zaktualizować modyfikowalne właściwości łącznika.
cmdlet Description
Get-UPPrintJob Użyj tego polecenia cmdlet, aby uzyskać informacje o zadaniach drukowania, które zostały wysłane do drukarki.
cmdlet Description
Get-UPUsageReport Użyj tego polecenia cmdlet, aby uzyskać różne typy raportów użycia drukowania.
  • Last updated on