Freigeben über


PowerShell-Modul für Universelles Drucken

Das PowerShell-Modul UniversalPrintManagement ist für die Verwaltung und Administration von Ressourcen von Universellen Drucken über die Befehlszeile konzipiert. Verwenden Sie dieses Modul, wenn Sie automatisierte Tools erstellen möchten.

Dieser Artikel hilft Ihnen beim Einstieg in das UniversalPrintManagement-Modul und vermittelt die zugrunde liegenden Kernkonzepte.

Installieren von UniversalPrintManagement

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

Install-Module UniversalPrintManagement

Standardmäßig ist der PowerShell-Katalog nicht als vertrauenswürdiges Repository für PowerShellGet konfiguriert. Bei der ersten Verwendung des PowerShell-Katalogs wird die folgende Meldung 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 die Installation fortzusetzen.

Hinweis

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

Deinstallieren von UniversalPrintManagement

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

Uninstall-Module -Name UniversalPrintManagement

Anmelden bei Universelles Drucken

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

Connect-UPService

Es wird ein Anmeldedialog angezeigt, in dem Sie einen Benutzernamen und ein Kennwort für Ihr Azure-Konto eingeben oder eines der zuvor gespeicherten Konten auswählen können.

Hinweis

Der Hauptzweck dieses Cmdlets besteht darin, eine nicht interaktive Anmeldung für automatisierte Skripts zu ermöglichen. 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 Standardnamenskonvention für PowerShell, VERB-NOUN. Das Verb beschreibt die Aktion (beispielsweise Get, Set, Grant und Revoke), und das Nomen beschreibt den Ressourcentyp (beispielsweise UPPrinter, UPPrintJob, und UPAccess). Nomen in UniversalPrintManagement beginnen immer mit dem Präfix UP.

Wenn Ihnen die verfügbaren Nomen und Verben bekannt sind, können Sie mühelos mit dem Cmdlet Get-Command nach Befehlen suchen. Für die Suche nach Befehlen mit dem Verb Get geben Sie beispielsweise Folgendes ein:

Get-Command -Verb Get -Module UniversalPrintManagement

So rufen Sie Cmdlet-Details mit Beispielen ab:

Get-Help Get-UPPrinter -Detailed

[HINWEIS] Die UniversalPrintManagement Get-Cmdlets geben jetzt Ergebnisse mit Fortsetzungstoken zurück, um das Blättern durch große Sammlungen und das Wiederholen fehlgeschlagener Anforderungen zu ermöglichen. Erfahren Sie, wie Sie Fortsetzungstoken verwenden. Aufgrund der Modelländerung, die erforderlich ist, um Fortsetzungstoken zu berücksichtigen, wird nun empfohlen, Get Cmdlet-Ergebnisse in einer Variablen zu speichern und über .results auf sie zuzugreifen. Beispiele finden Sie hier.

Anmeldung

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

Drucker

Cmdlet Beschreibung
Get-UPPrinter Mithilfe dieses Cmdlets können Sie Informationen über einen einzelnen oder eine Liste von Druckern abrufen.
Remove-UPPrinter Verwenden Sie dieses Cmdlet, um die Registrierung von Druckern aufzuheben.

Druckereigenschaften

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

Druckerfreigaben

Cmdlet Beschreibung
New-UPPrinterShare Verwenden Sie dieses Cmdlet, um einen Drucker freizugeben.
Get-UPPrinterShare Verwenden Sie dieses Cmdlet, um Informationen über einen einzelnen oder eine Liste von freigegebenen Druckern abzurufen.
Remove-UPPrinterShare Verwenden Sie dieses Cmdlet, um die Freigabe von bereits freigegebenen Druckern aufzuheben.
Set-UPPrinterShare Mit diesem Cmdlet können Sie eine Druckerfreigabe aktualisieren, um einen registrierten Drucker, der zur Wartung ansteht, durch einen funktionierenden Drucker zu ersetzen.

Benutzerberechtigungen

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

Connectors

Cmdlet Beschreibung
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.

Konnektoreigenschaften

Cmdlet Beschreibung
Set-UPConnectorProperty Verwenden Sie dieses Cmdlet, um veränderbare Eigenschaften eines Konnektors zu aktualisieren.
Cmdlet Beschreibung
Get-UPPrintJob Verwenden Sie dieses Cmdlet, um Informationen über Druckaufträgen zu erhalten, die an einen Drucker gesendet wurden.
Cmdlet Beschreibung
Get-UPUsageReport Mit diesem Cmdlet können Sie verschiedene Arten von Druckverwendungsberichten abrufen.