Universelles Drucken PowerShell-Modul

Das UniversalPrintManagement PowerShell module dient zum Verwalten und Verwalten von Universelles Drucken Ressourcen über die Befehlszeile. Verwenden Sie dieses Modul, wenn Sie automatisierte Tools erstellen möchten.

Dieser Artikel hilft Ihnen bei den ersten Schritten mit dem UniversalPrintManagement-Modul und lehrt die kernen Konzepte dahinter.

Installieren von UniversalPrintManagement

Führen Sie den folgenden Befehl aus einer PowerShell-Sitzung aus:

Install-Module UniversalPrintManagement

Standardmäßig ist der PowerShell-Katalog nicht als vertrauenswürdiges Repository für PowerShellGet konfiguriert. Wenn Sie die PSGallery zum ersten Mal verwenden, wird die folgende Eingabeaufforderung angezeigt:

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

Antworten Sie mit Yes oder Yes to All, um mit der Installation fortzufahren.

Hinweis

Weitere Informationen zum Installieren von PSGallery-Modulen in Offlineszenarien finden Sie unter PowerShell-Katalog.

Deinstallieren von UniversalPrintManagement

Führen Sie den folgenden Befehl aus einer PowerShell-Sitzung aus:

Uninstall-Module -Name UniversalPrintManagement

Anmelden bei Universelles Drucken

Melden Sie sich interaktiv mit dem Connect-UPService Cmdlet an.

Connect-UPService

Sie erhalten ein Anmeldedialogfeld, um einen Benutzernamen und ein Kennwort für Ihr Azure Konto anzugeben oder eines der zuvor gespeicherten Konten auszuwählen.

Hinweis

Der Hauptzweck dieses Cmdlets besteht darin, die nicht interaktive Anmeldung für automatisierte Skripts zuzulassen. Dies kann z. B. mithilfe von Connect-UPService -UserPrincipalName username@tenantname.com -Password $variableHoldingSecureString Syntax und Abrufen des Kennworts aus einem sicheren Speicher erfolgen.

Verwenden Sie nach der Anmeldung die verfügbaren Cmdlets im Modul, um auf Druckerressourcen zuzugreifen und sie zu verwalten.

UniversalPrintManagement Cmdlets

UniversalPrintManagement-Cmdlets folgen einer standardbenennungskonvention für PowerShell, VERB-NOUN. Das Verb beschreibt die Aktion (Beispiele: Get, , Set, Grant, Revoke) und das Substantiv beschreibt den Ressourcentyp (Beispiele sind UPPrinter, , UPPrintJob). UPAccess Substantive in UniversalPrintManagement beginnen immer mit dem Präfix UP.

Die Kenntnis der Substantive und Verben hilft Ihnen dabei, mit dem Cmdlet Get-Command Befehle zu finden. So suchen Sie z. B. Befehle, die das Get Verb verwenden:

Get-Command -Verb Get -Module UniversalPrintManagement

So rufen Sie Cmdlet-Details mit Beispielen ab:

Get-Help Get-UPPrinter -Detailed

[HINWEIS] Die UniversalPrintManagement-Cmdlets Get geben jetzt Ergebnisse mit Fortsetzungstokens zurück, um die Seitennavigation in großen Sammlungen und das Wiederholen fehlgeschlagener Anfragen zu ermöglichen. Erfahren Sie, wie Sie Fortsetzungstoken verwenden. Aufgrund der zur Unterstützung von Fortsetzungstoken erforderlichen Modelländerung wird nun empfohlen, Get Cmdlet-Ergebnisse in einer Variablen zu speichern und über .results darauf zuzugreifen. Beispiele finden Sie hier.

Anmelden

Cmdlet	Description
Connect-UPService	Stellt eine Verbindung mit einem authentifizierten Konto her, das für Universelles Drucken-Cmdlet-Anfragen verwendet wird.

Printers

Cmdlet	Description
Get-UPPrinter	Verwenden Sie dieses Cmdlet, um Informationen zu einer einzelnen Oder Liste von Druckern abzurufen.
Remove-UPPrinter	Verwenden Sie dieses Cmdlet, um die Registrierung von Druckern aufzuheben.

Druckereigenschaften

Cmdlet	Description
Set-UPPrinterProperty	Verwenden Sie dieses Cmdlet, um veränderbare Eigenschaften eines Druckers zu aktualisieren.

Druckerfreigaben

Cmdlet	Description
New-UPPrinterShare	Verwenden Sie dieses Cmdlet, um einen Drucker zu teilen.
Get-UPPrinterShare	Verwenden Sie dieses Cmdlet, um Informationen zu einem einzelnen oder einer Liste freigegebener Drucker abzurufen.
Remove-UPPrinterShare	Verwenden Sie dieses Cmdlet, um die Freigabe von Druckern aufzuheben, die zuvor freigegeben wurden.
Set-UPPrinterShare	Verwenden Sie dieses Cmdlet, um eine Druckerfreigabe zu aktualisieren, indem ein zur Wartung anstehender registrierter Drucker durch einen funktionsfähigen Drucker ersetzt wird.

Benutzerberechtigungen

Cmdlet	Description
Grant-UPAccess	Verwenden Sie dieses Cmdlet, um druckzugriff auf einen Benutzer oder eine Gruppe oder alle Benutzer in der Organisation zu gewähren.
Revoke-UPAccess	Verwenden Sie dieses Cmdlet, um den Druckzugriff von einem Benutzer oder einer Gruppe oder allen Benutzern in der Organisation zu widerrufen.
Get-UPAllowedMember	Verwenden Sie dieses Cmdlet, um Informationen zu Benutzern und Gruppen abzurufen, die Druckzugriff auf einen bestimmten Drucker haben.

Verbinder

Cmdlet	Description
Get-UPConnector	Verwenden Sie dieses Cmdlet, um Informationen über einen einzelnen Connector oder eine Liste von Connectors abzurufen.
Remove-UPConnector	Verwenden Sie dieses Cmdlet, um die Registrierung von Connectors aufzuheben.

Connectoreigenschaften

Cmdlet	Description
Set-UPConnectorProperty	Verwenden Sie dieses Cmdlet, um veränderbare Eigenschaften eines Connectors zu aktualisieren.

Druckaufträge

Cmdlet	Description
Get-UPPrintJob	Verwenden Sie dieses Cmdlet, um Informationen zu Druckaufträgen abzurufen, die an einen Drucker gesendet wurden.

Druckauftragsberichte

Cmdlet	Description
Get-UPUsageReport	Verwenden Sie dieses Cmdlet, um verschiedene Arten von Druckverwendungsberichten abzurufen.