Universal Print PowerShell-module

De UniversalPrintManagement PowerShell module 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"):

Beantwoord Yes of Yes to All ga door met de installatie.

Note

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

Meld u aan bij Universal Print

Meld u interactief aan met de Connect-UPService cmdlet.

Connect-UPService

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

Note

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.

Sign-in

Cmdlet Description
Connect-UPService Maakt verbinding met een geverifieerd account dat moet worden gebruikt voor Universal Print cmdlet-aanvragen.

Printers

Cmdlet Description
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 Description
Set-UPPrinterProperty Gebruik deze cmdlet om veranderlijke eigenschappen van een printer bij te werken.

Printershares

Cmdlet Description
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 gedeelde printer bij te werken en een geregistreerde printer die aan onderhoud toe is te vervangen door een werkende printer.

Gebruikerstoestemmingen

Cmdlet Description
Grant-UPAccess Gebruik deze cmdlet om afdruktoegang te verlenen aan een gebruiker of groep of alle gebruikers in de organisatie.
Revoke-UPAccess 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.

Connectoren

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

Connectoreigenschappen

Cmdlet Description
Stel-UPConnectorEigenschapIn Gebruik deze cmdlet om veranderlijke eigenschappen van een connector bij te werken.
Cmdlet Description
Get-UPPrintJob Gebruik deze cmdlet om informatie op te halen over afdruktaken die naar een printer zijn verzonden.
Cmdlet Description
Get-UPUsageReport Gebruik deze cmdlet om verschillende typen afdrukgebruiksrapporten op te halen.