Universell utskrift PowerShell-modul

UniversalPrintManagement PowerShell module är utformad för att hantera och administrera Universell utskrift resurser 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.

Installation av 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.

Note

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

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.

Note

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-cmdlets

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 för UniversalPrintManagement Get returnerar nu resultat med fortsättningstoken för att möjliggöra sidindelning i stora samlingar och nya försök med misslyckade begäranden. Lär dig hur du använder fortsättningstokenar. 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.

Sign-in

Cmdlet Description
Connect-UPService Ansluter med ett autentiserat konto som ska användas för Universell utskrift cmdlet-begäranden.

Printers

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

Skrivaregenskaper

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

Skrivarresurser

Cmdlet Description
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 skrivardelning och byta ut en registrerad skrivare som behöver underhåll mot en fungerande skrivare.

Användar behörigheter

Cmdlet Description
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.
Revoke-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 Description
Get-UPConnector Använd den här cmdleten för att hämta information om en enskild anslutning eller en lista över anslutningar.
Remove-UPConnector Använd den här cmdleten för att avregistrera anslutningar.

Egenskaper för anslutning

Cmdlet Description
Set-UPConnectorProperty Använd den här cmdleten för att uppdatera ändringsbara egenskaper för en anslutning.
Cmdlet Description
Get-UPPrintJob Använd den här cmdleten för att få information om utskriftsjobb som skickades till en skrivare.
Cmdlet Description
Get-UPUsageReport Använd den här cmdleten för att hämta olika typer av utskriftsanvändningsrapporter.