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?