Abrufen von Screenshots der NICE DCV-Sitzung

Sie können den dcv get-screenshot Befehl verwenden, um einen Screenshot des Desktops für die laufende Sitzung zu erhalten.

Syntax

dcv get-screenshot --max-width pixels --max-height pixels --format JPEG|PNG --primary --json --output /path_to/destination session_name

Optionen

--max-width

Gibt die maximale Breite des Screenshots in Pixeln an. Wenn Sie keine Breite oder Höhe angeben, verwendet der Screenshot die Anzeigeauflösung der Sitzung. Wenn Sie nur eine Höhe angeben, wird die Breite automatisch skaliert, um das Seitenverhältnis beizubehalten.

Typ: Ganzzahl

Erforderlich: Nein

--max-height

Gibt die maximale Höhe des Screenshots in Pixeln an. Wenn Sie keine Breite oder Höhe angeben, verwendet der Screenshot die Anzeigeauflösung der Sitzung. Wenn Sie nur eine Breite angeben, wird die Höhe automatisch skaliert, um das Seitenverhältnis beizubehalten.

Typ: Ganzzahl

Erforderlich: Nein

--format

Das Dateiformat des Screenshots. Derzeit werden nur die PNG Formate JPEG und unterstützt. Wenn Sie widersprüchliche Dateitypen für die --output Optionen --format und angeben, --format hat der für angegebene Wert Priorität. Wenn Sie beispielsweise --format JPEG und angeben--output myfile.png, erstellt NICE DCV eine JPEG-Bilddatei.

Typ: Zeichenfolge

Zulässige Werte: JPEG | PNG

Erforderlich: Nein

--primary

Gibt an, ob nur ein Screenshot der primären Anzeige abgerufen werden soll. Um nur einen Screenshot der primären Anzeige zu erhalten, geben Sie an--primary. Um einen Screenshot aller Displays zu erhalten, lassen Sie diese Option weg. Wenn Sie einen Screenshot aller Displays abrufen möchten, werden alle Displays zu einem einzigen Screenshot zusammengefasst.

Erforderlich: Nein

--json, -j

Gibt an, ob die Ausgabe im JSON-Format bereitgestellt werden soll, das in base64 codiert ist. Um die JSON-Ausgabe abzurufen, geben Sie an--json. Andernfalls lassen Sie es weg.

Erforderlich: Nein

--output, -o

Gibt den Zielpfad, den Dateinamen und den Dateityp für den Screenshot an. Geben Sie beispielsweise für Windows und c:\directory\filename.formatfür Linux an/directory/filename.format. Das Format muss .png oder sein.jpeg. Wenn Sie widersprüchliche Dateitypen für die --output Optionen --format und angeben, --format hat der für angegebene Wert Priorität. Wenn Sie beispielsweise --format JPEG und angeben--output myfile.png, erstellt NICE DCV eine JPEG-Bilddatei.

Typ: Zeichenfolge

Erforderlich: nein

Beispiele

Beispiel 1

Der folgende Beispielbefehl ruft einen Screenshot einer Sitzung mit dem Namen abmy-session. Der Screenshot verwendet die Auflösung des Servers.

dcv get-screenshot --output myscreenshot.png my-session

Beispiel 2

Der folgende Beispielbefehl erstellt einen Screenshot, der 200 Pixel breit und 100 Pixel hoch ist. Es nimmt es einer Sitzung mit dem Namen my-session. Es speichert den Screenshot im aktuellen Verzeichnis mit dem Dateinamen myscreenshot.png.

dcv get-screenshot --max-width 200 --max-height 100 --output myscreenshot.png my-session

Beispiel 3

Der folgende Beispielbefehl erstellt einen Screenshot einer Sitzung mit dem Namen my-session. Der Screenshot enthält nur die primäre Anzeige. Es speichert die Datei im aktuellen Verzeichnis und benennt den Screenshot myscreenshot.png.

dcv get-screenshot --primary --output myscreenshot.jpeg my-session

Beispiel 4

Der folgende Beispielbefehl ruft einen Screenshot einer Sitzung mit dem Namen abmy-session. Der Befehl gibt die Datei im Base64- und JSON-Format aus.

dcv get-screenshot --json --format png my-session