Freigeben über


PowerShell-Module für Universal Print

Sie haben zwei Möglichkeiten, Universal Print über PowerShell zu verwalten:

  • Verwenden Sie das Modul UniversalPrintManagement, mit dem sich gängige Verwaltungsaufgaben am einfachsten erledigen lassen. Die Befehle sind zwar einfacher zu verwenden, aber es fehlen möglicherweise einige erweiterte Funktionen, die in der Microsoft Graph API verfügbar sind.
  • Verwenden Sie das Microsoft Graph Powershell SDK, mit dem die gesamte Microsoft Graph API in PowerShell skriptgesteuert werden kann. Die Befehle sind auf einer niedrigeren Ebene angesiedelt, so dass sie für einfache Aufgaben möglicherweise nicht so leicht zu verwenden sind.

Die Dokumentation für beide Ansätze finden Sie weiter unten. Wechseln Sie zwischen den Beispielen, um die wichtigsten Unterschiede zu sehen.

Erste Schritte

Voraussetzungen

  • Upgrade auf PowerShell 5.1 oder höher
  • Aktualisieren Sie PowerShellGet auf die neueste Version mit Install-Module PowerShellGet
  • Die Richtlinie für die Ausführung von PowerShell-Skripten muss mithilfe von Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser auf RemoteSigned oder eine niedrigere Einschränkungsebene gesetzt werden. Weitere Informationen zu Einschränkungsebenen.

Schritt 1: Installieren des PowerShell-Moduls

# To install for all users (must be administrator), remove -Scope CurrentUser
Install-Module UniversalPrintManagement -Scope CurrentUser

Dieser Befehl bezieht das angeforderte Modul aus dem PowerShell-Katalog, das nicht standardmäßig als vertrauenswürdiges Repository für PowerShellGet konfiguriert ist. Wenn Sie diesen Befehl zum ersten Mal ausführen, sehen Sie möglicherweise die folgende Eingabeaufforderung:

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.

Schritt 2: Herstellen einer Verbindung mit Universal Print

Nachdem Sie das Modul installiert haben, müssen Sie eine Verbindung zu Universal Print herstellen, bevor Sie irgendwelche Befehle ausführen können.

# To provide authentication details interactively using a system authentication prompt:
Connect-UPService

# To provide authentication details non-interactively:
# Connect-UPService -UserPrincipalName username@tenantname.com -Password $variableHoldingSecureString

Schritt 3: Überprüfen der Konfiguration durch Abrufen einer Liste Ihrer Drucker

Um sicherzugehen, dass alles korrekt eingerichtet ist, versuchen Sie, die Liste der bei Ihrem Mandanten registrierten Drucker zu erhalten. Eine vollständige Liste der verfügbaren Befehle finden Sie in der Befehlsreferenz.

Get-UPPrinter

Aktualisieren oder Deinstallieren

Aktualisieren des PowerShell-Skripts

Update-Module UniversalPrintManagement

Deinstallieren des PowerShell-Moduls

Wenn Sie das Modul später deinstallieren müssen, verwenden Sie diesen Befehl:

Uninstall-Module -Name UniversalPrintManagement