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. |
Druckaufträge
Cmdlet | Beschreibung |
---|---|
Get-UPPrintJob | Verwenden Sie dieses Cmdlet, um Informationen über Druckaufträgen zu erhalten, die an einen Drucker gesendet wurden. |
Druckauftragberichte
Cmdlet | Beschreibung |
---|---|
Get-UPUsageReport | Mit diesem Cmdlet können Sie verschiedene Arten von Druckverwendungsberichten abrufen. |