Dela via


PowerShell-modul för universell utskrift

PowerShell-modulen UniversalPrintManagement är utformad för att hantera och administrera universella utskriftsresurser från kommandoraden. Använd den här modulen när du vill skapa automatiserade verktyg.

Den här artikeln hjälper dig att komma igång med Modulen UniversalPrintManagement och lär dig de grundläggande begreppen bakom den.

Installera UniversalPrintManagement

Kör följande kommando från en PowerShell-session:

Install-Module UniversalPrintManagement

Som standard konfigureras inte PowerShell-galleriet som en betrodd lagringsplats för PowerShellGet. Första gången du använder PSGallery visas följande fråga:

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

Svara Yes eller Yes to All för att fortsätta med installationen.

Kommentar

Mer information om hur du installerar PSGallery-moduler i offlinescenarier finns i PowerShell-galleriet.

Avinstallera UniversalPrintManagement

Kör följande kommando från en PowerShell-session:

Uninstall-Module -Name UniversalPrintManagement

Logga in på Universell utskrift

Logga in interaktivt med cmdleten Connect-UPService.

Connect-UPService

Du får en inloggningsdialogruta för att ange ett användarnamn och lösenord för ditt Azure-konto eller välja ett av de tidigare sparade kontona.

Kommentar

Huvudsyftet med den här cmdleten är att tillåta icke-interaktiv inloggning för automatiserade skript. Detta kan till exempel göras med hjälp av Connect-UPService -UserPrincipalName username@tenantname.com -Password $variableHoldingSecureString syntax och hämtning av lösenordet från en säker lagringsplats.

När du har loggat in använder du de tillgängliga cmdletarna i modulen för att komma åt och hantera skrivarresurser.

UniversalPrintManagement-cmdletar

UniversalPrintManagement-cmdletar följer en standardnamnkonvention för PowerShell, VERB-NOUN. Verbet beskriver åtgärden (exempel är Get, Set, Grant, Revoke) och substantiv beskriver resurstypen (exempel är UPPrinter, UPPrintJob, UPAccess). Substantiv i UniversalPrintManagement börjar alltid med prefixet UP.

Genom att känna till substantiv och verb kan du hitta kommandon med cmdleten Get-Command . Om du till exempel vill hitta kommandon som använder verbet Get :

Get-Command -Verb Get -Module UniversalPrintManagement

Så här hämtar du cmdlet-information med exempel:

Get-Help Get-UPPrinter -Detailed

[OBS] Cmdletarna UniversalPrintManagement Get returnerar nu resultat med fortsättningstoken för att tillåta växling genom stora samlingar och omstyckning av misslyckade begäranden. Lär dig hur du använder fortsättningstoken. På grund av den modelländring som krävs för att hantera fortsättningstoken rekommenderar vi nu att du lagrar Get cmdlet-resultat i en variabel och kommer åt dem via .results. Se exempel här.

Logga in

Cmdlet beskrivning
Anslut-UPService Anslut med ett autentiserat konto som ska användas för cmdlet-begäranden för universell utskrift.

Skrivare

Cmdlet beskrivning
Get-UPPrinter Använd den här cmdleten för att hämta information om en enskild skrivare eller lista över skrivare.
Remove-UPPrinter Använd den här cmdleten för att avregistrera skrivare.

Skrivaregenskaper

Cmdlet beskrivning
Set-UPPrinterProperty Använd den här cmdleten för att uppdatera föränderliga egenskaper för en skrivare.

Skrivarresurser

Cmdlet beskrivning
New-UPPrinterShare Använd den här cmdleten för att dela en skrivare.
Get-UPPrinterShare Använd den här cmdleten för att få information om en enskild skrivare eller en lista över delade skrivare.
Remove-UPPrinterShare Använd den här cmdleten för att ta bort delning av skrivare som har delats tidigare.
Set-UPPrinterShare Använd den här cmdleten för att uppdatera en skrivarresurs för att byta ut en registrerad skrivare för underhåll med en fungerande skrivare.

Användarbehörigheter

Cmdlet beskrivning
Grant-UPAccess Använd den här cmdleten för att ge utskriftsåtkomst till en användare eller grupp eller alla användare i organisationen.
Återkalla UPAccess Använd den här cmdleten för att återkalla utskriftsåtkomst från en användare eller grupp eller alla användare i organisationen.
Get-UPAllowedMember Använd den här cmdleten för att få information om användare och grupper som har utskriftsåtkomst till en viss skrivare.

Anslutningar

Cmdlet beskrivning
Get-UP Anslut or Använd den här cmdleten för att hämta information om en enda eller lista över anslutningsappar.
Remove-UP Anslut or Använd den här cmdleten för att avregistrera anslutningsappar.

egenskaper för Anslut eller

Cmdlet beskrivning
Set-UP Anslut orProperty Använd den här cmdleten för att uppdatera föränderliga egenskaper för en anslutningsapp.
Cmdlet beskrivning
Get-UPPrintJob Använd den här cmdleten för att få information om utskriftsjobb som skickades till en skrivare.
Cmdlet beskrivning
Get-UPUsageReport Använd den här cmdleten för att hämta olika typer av utskriftsanvändningsrapporter.