Share via


Universal Print PowerShell-module

De PowerShell-module UniversalPrintManagement is ontworpen voor het beheren en beheren van Universal Print-resources vanaf de opdrachtregel. Gebruik deze module als u geautomatiseerde hulpprogramma's wilt bouwen.

Dit artikel helpt u aan de slag te gaan met de UniversalPrintManagement-module en leert de belangrijkste concepten erachter.

UniversalPrintManagement installeren

Voer de volgende opdracht uit vanuit een PowerShell-sessie:

Install-Module UniversalPrintManagement

PowerShell Gallery is standaard niet geconfigureerd als een vertrouwde opslagplaats voor PowerShellGet. De eerste keer dat u de PSGallery gebruikt, ziet u de volgende prompt:

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

Antwoord Yes of Yes to All om door te gaan met de installatie.

Notitie

Raadpleeg de PowerShell Gallery voor meer informatie over het installeren van PSGallery-modules in offlinescenario's.

UniversalPrintManagement verwijderen

Voer de volgende opdracht uit vanuit een PowerShell-sessie:

Uninstall-Module -Name UniversalPrintManagement

Aanmelden bij Universal Print

Gebruik interactief aanmelden met de cmdlet Connect-UPService.

Connect-UPService

U krijgt een aanmeldingsdialoogvenster om een gebruikersnaam en wachtwoord voor uw Azure-account op te geven of selecteer een van de eerder opgeslagen accounts.

Notitie

Het belangrijkste doel van deze cmdlet is het toestaan van niet-interactieve aanmelding voor geautomatiseerde scripts. U kunt dit bijvoorbeeld doen door syntaxis te gebruiken Connect-UPService -UserPrincipalName username@tenantname.com -Password $variableHoldingSecureString en het wachtwoord op te halen uit een beveiligde opslag.

Zodra u zich hebt aangemeld, gebruikt u de beschikbare cmdlets in de module om printerbronnen te openen en te beheren.

UniversalPrintManagement-cmdlets

UniversalPrintManagement-cmdlets volgen een standaardnaamconventie voor PowerShell, VERB-NOUN. Het werkwoord beschrijft de actie (voorbeelden zijn onder andere Get, SetGrant, ) Revokeen het zelfstandig naamwoord beschrijft het resourcetype (voorbeelden zijn onder andere UPPrinter, UPPrintJob). UPAccess Zelfstandige naamwoorden in UniversalPrintManagement beginnen altijd met het voorvoegsel UP.

Als u de zelfstandige naamwoorden en werkwoorden kent, kunt u opdrachten vinden met de cmdlet Get-Command . Als u bijvoorbeeld opdrachten wilt zoeken die gebruikmaken van het Get werkwoord:

Get-Command -Verb Get -Module UniversalPrintManagement

Ga als volgende te werk om details van cmdlets op te halen met voorbeelden:

Get-Help Get-UPPrinter -Detailed

[OPMERKING] De UniversalPrintManagement-cmdlets Get retourneren nu resultaten met vervolgtokens om paging via grote verzamelingen toe te staan en mislukte aanvragen opnieuw in te voeren. Meer informatie over het gebruik van vervolgtokens. Als gevolg van de modelwijziging die is vereist voor vervolgtokens, wordt het nu aanbevolen om cmdlet-resultaten op te slaan Get in een variabele en deze te openen via .results. Bekijk hier voorbeelden.

Aanmelden

Cmdlet Beschrijving
Verbinding maken-UPService Verbinding maken s met een geverifieerd account dat moet worden gebruikt voor Universal Print-cmdlet-aanvragen.

Printers

Cmdlet Beschrijving
Get-UPPrinter Gebruik deze cmdlet om informatie op te halen over één of een lijst met printers.
Remove-UPPrinter Gebruik deze cmdlet om de registratie van printers ongedaan te maken.

Printereigenschappen

Cmdlet Beschrijving
Set-UPPrinterProperty Gebruik deze cmdlet om veranderlijke eigenschappen van een printer bij te werken.

Printershares

Cmdlet Beschrijving
New-UPPrinterShare Gebruik deze cmdlet om een printer te delen.
Get-UPPrinterShare Gebruik deze cmdlet om informatie op te halen over één of een lijst met gedeelde printers.
Remove-UPPrinterShare Gebruik deze cmdlet om het delen van printers op te heffen die eerder zijn gedeeld.
Set-UPPrinterShare Gebruik deze cmdlet om een printershare bij te werken om een geregistreerde printer te wisselen vanwege onderhoud met een werkende printer.

Gebruikersmachtigingen

Cmdlet Beschrijving
Grant-UPAccess Gebruik deze cmdlet om afdruktoegang te verlenen aan een gebruiker of groep of alle gebruikers in de organisatie.
UPAccess intrekken Gebruik deze cmdlet om de afdruktoegang van een gebruiker of groep of alle gebruikers in de organisatie in te trekken.
Get-UPAllowedMember Gebruik deze cmdlet om informatie op te halen over gebruikers en groepen die afdruktoegang hebben tot een specifieke printer.

Connectors

Cmdlet Beschrijving
Get-UP Verbinding maken or Gebruik deze cmdlet om informatie op te halen over één of een lijst met connectors.
Remove-UP Verbinding maken or Gebruik deze cmdlet om de registratie van connectors ongedaan te maken.

eigenschappen van Verbinding maken or

Cmdlet Beschrijving
Set-UP Verbinding maken orProperty Gebruik deze cmdlet om veranderlijke eigenschappen van een connector bij te werken.
Cmdlet Beschrijving
Get-UPPrintJob Gebruik deze cmdlet om informatie op te halen over afdruktaken die naar een printer zijn verzonden.
Cmdlet Beschrijving
Get-UPUsageReport Gebruik deze cmdlet om verschillende typen afdrukgebruiksrapporten op te halen.