Update-DSRDPEntry
Synopsis
Einen RDP-Eintrag aktualisieren.
Syntax
__AllParameterSets
Update-DSRDPEntry -EntryID <guid> [-ForceAlternateShellProgram] [-Name <string>] [-Domain <string>]
[-Username <string>] [-Password <string>] [-MnemonicPassword <string>] [-Group <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>]
[-HostName <string>] [-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
Einen RDP-Eintrag mit den angegebenen Parametern aktualisieren.
Beispiele
Aktualisiert einen angegebenen RDP-Eintrag, indem die Warnung bei bereits geöffneter Verbindung aktiviert und beim Öffnen eine Aufforderung mit Ticketnummer angefordert wird.
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 6000 liegen.
-AfterLoginProgram
Pfad (einschließlich Dateiname) der in der alternativen Shell zu startenden Anwendung
-AllowOffline
Offlinemodus des Eintrags.
-AlternateShell
Pfad (einschließlich Dateiname) der in der alternativen Shell zu startenden Anwendung
-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, dass für frühere Versionen entwickelte Skripte korrekt funktionieren.
-AudioCaptureRedirectionMode
udio aus der RDP-Sitzung aufzeichnen. Standardmäßig True.
-AudioQualityMode
RDP-Audioqualität. Standardmäßig Dynamic.
-AutoReconnection
Automatische Wiederverbindung aktivieren, wenn die RDP-Verbindung abbricht. Standardmäßig True.
-AzureInstanceID
Instanz-ID des Azure Cloud Service
-BandwidthAutoDetect
Bandbreitenerkennung aktivieren. Standardmäßig True.
-CheckoutMode
Auscheckmodus 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
Anmeldeinformationsmodus: CredentialEntry => Eintrag mit Anmeldeinformationen 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
Datenkompression aktivieren. Standardmäßig True.
-Description
Beschreibung des Eintrags
-DesktopBackground
Desktophintergrund aktivieren. Standardmäßig True.
-DesktopComposition
Desktopkomposition aktivieren
-DisplayMode
Von RDP verwendeter Anzeigemodus. Standardmäßig Embedded.
-DisplayMonitor
Von RDP verwendeter Anzeigemonitor. Standardmäßig Primary.
-DisplayVirtualDesktop
Von RPD verwendeter virtueller Desktop. Standardmäßig Current
-Domain
Name der Domäne
-EntryID
ID des zu ändernden Eintrags.
-Expiration
Ablaufdatum des Eintrags (ISO-8601-Format (yyyy-mm-ddThh🇲🇲ss.000Z)
-FontSmoothing
Kantenglättung für Schriftarten aktivieren
-ForceAlternateShellProgram
Erzwingt die Verwendung der alternativen Shell anstelle der bevorzugten Methode RemoteApp.
-Group
Speicherort des Eintrags im Tresor (Ordnername, nicht ID)
-HostName
Hostname von RDP (Adresse)
-HyperVInstance
Hyper-V-Instanz
-KeepAliveInternal
Keep-Alive. Standardmäßig 1000.
-KeyboardHook
Legt das Ziel für Windows-Tastenkombinationen fest (z. B. 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
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
Persistentes 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 von Azure Cloud Services
-ShellWorkingDirectory
Pfad für alternatives Shell-Verzeichnis
-ShowContentWhileDragging
Anzeige des Inhalts beim Ziehen über den Bildschirm aktivieren. 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
Hyper-V-Sitzung im erweiterten Modus (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 Anschlüsse. Standardmäßig True.
-UsesSmartDevices
RDP-Zugriff auf Smart-Geräte
-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 durch Eingabe von "Get-Help Update-DSRDPEntry -detailed". Technische Informationen erhalten Sie durch Eingabe von "Get-Help Update-DSRDPEntry -full".
Zuletzt aktualisiert
War das hilfreich?