For the complete documentation index, see llms.txt. This page is also available as Markdown.

New-DSRDPEntry

Kurzbeschreibung

Erstellen eines neuen RDP-Eintrags.

Syntax

__AllParameterSets

New-DSRDPEntry [-Name] <string> [[-Domain] <string>] [[-Username] <string>] [[-Password] <string>]
 [[-MnemonicPassword] <string>] [[-VaultID] <guid>] [[-Group] <string>] -HostName <string>
 [-PromptCredentials] [-LinkedCredentialValue <string>] [-CredentialMode <CredentialSourceMode>]
 [-Description <string>] [-Tags <string>] [-Expiration <string>] [-WarnIfAlreadyOpened]
 [-CredentialViewedCommentIsRequired] [-TicketNumberIsRequiredOnCredentialViewed]
 [-CredentialViewedPrompt] [-OpenCommentPrompt] [-OpenCommentIsRequired]
 [-TicketNumberIsRequiredOnOpen] [-CloseCommentPrompt] [-CloseCommentIsRequired]
 [-TicketNumberIsRequiredOnClose] [-CheckoutMode <CheckOutMode>] [-AllowOffline <AllowOffline>]
 [-AdminMode] [-Port <string>] [-RDPType <RDPType>] [-RoleName <string>] [-AzureInstanceID <int>]
 [-HyperVInstance <string>] [-UseEnhancedSessionMode] [-UsesClipboard <bool>] [-UsesDevices]
 [-UsesHardDrives <bool>] [-UsesPrinters] [-UsesSerialPorts <bool>] [-UsesSmartDevices]
 [-SoundHook <SoundHook>] [-AudioQualityMode <RDPAudioQualityMode>]
 [-AudioCaptureRedirectionMode <bool>] [-KeyboardHook <string>] [-AlternateShell <string>]
 [-ShellWorkingDirectory <string>] [-AfterLoginProgram <string>] [-AfterLoginDelay <int>]
 [-RemoteApplicationProgram <string>] [-RemoteApplicationCmdLine <string>]
 [-NetworkConnectionType <string>] [-DesktopBackground <bool>] [-FontSmoothing]
 [-DesktopComposition] [-Animations] [-VisualStyles <bool>] [-NetworkAutoDetect]
 [-AutoReconnection <bool>] [-RedirectDirectX] [-RedirectVideoPlayback]
 [-ShowContentWhileDragging <bool>] [-DataCompression <bool>] [-PersistentBitmapCaching <bool>]
 [-BandwidthAutoDetect <bool>] [-LoadAddonsMode <DefaultBoolean>] [-ClientSpec <RDPClientSpec>]
 [-KeepAliveInternal <int>] [-DisplayMode <ConnectionDisplayMode>]
 [-DisplayMonitor <DisplayMonitor>] [-DisplayVirtualDesktop <DisplayVirtualDesktop>]
 [-NewFieldsList <Field[]>] [-AsLegacyResponse] [<CommonParameters>]

Beschreibung

Erstellen eines neuen RDP-Eintrags mit den angegebenen Parametern. Alle Felder haben einen Standardwert, der dem von Remote Desktop Manager entspricht.

Beispiele

Erstellen eines neuen RDP-Eintrags.

Parameter

-AdminMode

Die Administrationskonsole öffnen

-AfterLoginDelay

Verzögerung (in Millisekunden) zum Starten der Anwendung nach der Anmeldung. Standardmäßig 500 ms. Muss zwischen 0 und 60000 liegen.

-AfterLoginProgram

Pfad (einschließlich Dateiname) der Anwendung, die in der alternativen Shell gestartet werden soll

-AllowOffline

Offline-Modus des Eintrags.

-AlternateShell

Pfad (einschließlich Dateiname) der Anwendung, die in der alternativen Shell gestartet werden soll

-Animations

Animationen aktivieren

-AsLegacyResponse

In Versionen vor 2024.2 gaben viele DS-Cmdlets ein ServerResponse-Objekt zurück. Das Aktivieren dieses Schalters für Rückwärtskompatibilität ermöglicht es, dass für frühere Versionen entwickelte Skripte korrekt funktionieren.

-AudioCaptureRedirectionMode

Audio aus der RDP-Sitzung aufzeichnen. Standardmäßig True.

-AudioQualityMode

RDP-Audioqualität. Standardmäßig dynamisch.

-AutoReconnection

Automatische Wiederverbindung aktivieren, wenn die RDP-Verbindung abbricht. Standardmäßig True.

-AzureInstanceID

Instanz-ID des Azure Cloud Service

-BandwidthAutoDetect

Automatische Bandbreitenerkennung aktivieren. Standardmäßig True.

-CheckoutMode

Auschecken-Modus des Eintrags.

-ClientSpec

Cache-Spezifikationen

-CloseCommentIsRequired

Beim Schließen ist ein Kommentar erforderlich

-CloseCommentPrompt

Den Benutzer beim Schließen zur Eingabe eines Kommentars/einer Ticketnummer auffordern

-CredentialMode

Anmeldeinformations-Modus: CredentialEntry => Anmeldeinformations-Eintrag im selben Tresor. Der Parameter 'LinkedCredentialValue' muss verwendet werden, um die Anmeldeinformations-ID anzugeben. PrivilegedAccount => Zu verknüpfendes PAM-Konto. Der Parameter 'LinkedCredentialValue' muss verwendet werden, um die PAM-Konto-ID anzugeben. PrivateVaultSearch => Anmeldeinformationen im Benutzer-Tresor. Der Parameter 'LinkedCredentialValue' muss verwendet werden, um den Namen der Anmeldeinformationen anzugeben.

-CredentialViewedCommentIsRequired

Zum Anzeigen der Anmeldeinformationen des Eintrags ist ein Kommentar erforderlich

-CredentialViewedPrompt

Den Benutzer zur Eingabe eines Kommentars/einer Ticketnummer auffordern

-DataCompression

Datenkomprimierung aktivieren. Standardmäßig True.

-Description

Beschreibung des Eintrags

-DesktopBackground

Desktop-Hintergrund aktivieren. Standardmäßig True.

-DesktopComposition

Desktopkomposition aktivieren

-DisplayMode

Von RDP verwendeter Anzeigemodus. Standardmäßig eingebettet.

-DisplayMonitor

Von RDP verwendeter Anzeigemonitor. Standardmäßig primär.

-DisplayVirtualDesktop

Von RDP verwendeter virtueller Desktop. Standardmäßig aktuell.

-Domain

Domänenname

-Expiration

Ablaufdatum des Eintrags (ISO-8601-Format (yyyy-mm-ddThh🇲🇲ss.000Z)

-FontSmoothing

Schriftglättung aktivieren

-Group

Speicherort des Eintrags im Tresor (Ordnername, nicht ID)

-HostName

Hostname des RDP (Adresse)

-HyperVInstance

Hyper-V-Instanz

-KeepAliveInternal

Keep-Alive. Standardmäßig 1000.

-KeyboardHook

Legt das Ziel für Windows-Tastenkombinationen fest (zum Beispiel ALT+TAB)

-LinkedCredentialValue

Verknüpfte Anmeldeinformations-ID oder Name der Anmeldeinformationen im Benutzer-Tresor

-LoadAddonsMode

Legt fest, ob Add-ons eingebettet geladen werden oder nicht.

-MnemonicPassword

Ignoriert. Mnemonisches Passwort des Eintrags als Erinnerungshilfe für das Passwort

-Name

Name des Eintrags

-NetworkAutoDetect

Automatische Netzwerkerkennung aktivieren

-NetworkConnectionType

Für RDP zu verwendende Verbindungsgeschwindigkeit

-NewFieldsList

Hinzuzufügende Felder

-OpenCommentIsRequired

Beim Öffnen ist ein Kommentar erforderlich

-OpenCommentPrompt

Den Benutzer beim Öffnen zur Eingabe eines Kommentars/einer Ticketnummer auffordern

-Password

Passwort des Eintrags

-PersistentBitmapCaching

Dauerhaftes Bitmap-Caching aktivieren. Standardmäßig True.

-Port

Von RDP verwendeter Port. Standardmäßig 3389.

-PromptCredentials

Beim Auschecken zur Passworteingabe auffordern

-RDPType

RDP-Typ. Standardmäßig Normal.

-RedirectDirectX

DirectX-Umleitung aktivieren

-RedirectVideoPlayback

Umleitung der Videowiedergabe aktivieren

-RemoteApplicationCmdLine

Parameter für die Remote-Anwendung

-RemoteApplicationProgram

Pfad (einschließlich Dateiname und Erweiterung) der zu startenden Anwendung

-RoleName

Rollenname der Azure Cloud Services

-ShellWorkingDirectory

Pfad für das alternative Shell-Verzeichnis

-ShowContentWhileDragging

Aktiviert die Inhaltsanzeige beim Ziehen über den Bildschirm. Standardmäßig True.

-SoundHook

Ziel für Töne auswählen. Standardmäßig BringToThisComputer.

-Tags

Tags (Schlüsselwörter) des Eintrags. Jedes durch ein Leerzeichen getrennte Wort wird als Schlüsselwort betrachtet.

-TicketNumberIsRequiredOnClose

Beim Schließen ist eine Ticketnummer erforderlich

-TicketNumberIsRequiredOnCredentialViewed

Zum Anzeigen der Anmeldeinformationen des Eintrags ist eine Ticketnummer erforderlich

-TicketNumberIsRequiredOnOpen

Beim Öffnen ist eine Ticketnummer erforderlich

-UseEnhancedSessionMode

Erweiterte Hyper-V-Sitzung (verwendet lokale Ressourcen des Computers, wie USB-Laufwerk oder Drucker)

-Username

Benutzername des Eintrags

-UsesClipboard

RDP-Zugriff auf die Zwischenablage. Standardmäßig True.

-UsesDevices

RDP-Zugriff auf "Geräte" (wie Kameras...)

-UsesHardDrives

RDP-Zugriff auf Festplatten. Standardmäßig True.

-UsesPrinters

RDP-Zugriff auf Drucker

-UsesSerialPorts

RDP-Zugriff auf serielle Ports. Standardmäßig True.

-UsesSmartDevices

RDP-Zugriff auf Smart-Geräte

-VaultID

Tresor-ID des Eintrags.

-VisualStyles

Visuelle Stile aktivieren. Standardmäßig True.

-WarnIfAlreadyOpened

Warnt den Benutzer, wenn die RDP-Sitzung bereits geöffnet ist

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter about_CommonParameters.

Hinweise

Weitere Informationen erhalten Sie mit "Get-Help New-DSRDPEntry -detailed". Technische Informationen erhalten Sie mit "Get-Help New-DSRDPEntry -full".

Zuletzt aktualisiert

War das hilfreich?