Udostępnij za pośrednictwem

Moduł Universal Print programu PowerShell

  • Artykuł

Moduł UniversalPrintManagement programu PowerShell 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 galerii PSGallery zostanie wyświetlony następujący monit:

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

Wybierz odpowiedź Yes lub Yes to All, aby kontynuować instalację.

Uwaga

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

Logowanie do usługi Universal Print

Zaloguj się interakcyjnie przy użyciu polecenia cmdlet Connect-UPService.

Connect-UPService

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

Uwaga

Głównym celem tego polecenia cmdlet jest zezwolenie na logowanie nieinterakcyjne dla skryptów automatycznych. Można to zrobić, na przykład przy użyciu Connect-UPService -UserPrincipalName username@tenantname.com -Password $variableHoldingSecureString składni i pobierania hasła 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 cmdlet universalPrintManagement

Polecenia cmdlet universalPrintManagement są zgodne ze standardową konwencją nazewnictwa dla programu PowerShell, VERB-NOUN. Czasownik opisuje akcję (przykłady obejmują , , SetGrant, Revoke) i rzeczownik opisuje typ zasobu (przykłady to GetUPPrinter, UPPrintJob, UPAccess). Nouns in UniversalPrintManagement zawsze zaczyna się od prefiksu UP.

Znajomość czasowników i czasowników ułatwia znajdowanie poleceń za pomocą 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 cmdlet UniversalPrintManagement Get zwracają teraz wyniki z tokenami kontynuacji, aby umożliwić stronicowanie za pośrednictwem dużych kolekcji i ponowne żądania niepomyślne. 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.

Logowanie

Polecenia cmdlet opis
Połączenie-UPService Połączenie z uwierzytelnionymi kontami do użycia na potrzeby żądań poleceń cmdlet usługi Universal Print.

Drukarki

Polecenia cmdlet opis
Get-UPPrinter Użyj tego polecenia cmdlet, aby uzyskać informacje o jednej lub liście drukarek.
Remove-UPPrinter Użyj tego polecenia cmdlet, aby wyrejestrować drukarki.

Właściwości drukarki

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

Udziały drukarek

Polecenia cmdlet opis
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, aby zamienić zarejestrowaną drukarkę z powodu konserwacji z działającym.

Uprawnienia użytkowników

Polecenia cmdlet opis
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, które mają dostęp do wydruku do określonej drukarki.

Łączniki

Polecenia cmdlet opis
Get-UP Połączenie or Użyj tego polecenia cmdlet, aby uzyskać informacje o jednym łączniku lub liście łączników.
Remove-UP Połączenie or Użyj tego polecenia cmdlet, aby wyrejestrować łączniki.

właściwości Połączenie or

Polecenia cmdlet opis
Set-UP Połączenie orProperty Użyj tego polecenia cmdlet, aby zaktualizować modyfikowalne właściwości łącznika.
Polecenia cmdlet opis
Get-UPPrintJob Użyj tego polecenia cmdlet, aby uzyskać informacje o zadaniach drukowania, które zostały wysłane do drukarki.
Polecenia cmdlet opis
Get-UPUsageReport Użyj tego polecenia cmdlet, aby uzyskać różne typy raportów użycia wydruku.