Devolutions 2026.2 est disponible. Moins de friction, plus d'efficacité.
En savoir plus
Ctrlk
Réserver une démoLab à la demandeAcademyCentre de téléchargement
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Update-DSRDPEntry

Synopsis

Mettre à jour une entrée RDP.

Syntaxe

__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>]

Description

Mettre à jour une entrée RDP avec les paramètres fournis.

Exemples

Mettre à jour une entrée RDP spécifiée en activant l'avertissement si déjà ouverte et en demandant une invite avec un numéro de ticket lors de son ouverture.

Paramètres

-AdminMode

Ouvrir la console d'administration

-AfterLoginDelay

Délai (en millisecondes) avant de lancer l'application après la connexion. 500 ms par défaut. Doit être compris entre 0 et 6000.

-AfterLoginProgram

Chemin (incluant le nom de fichier) de l'application à lancer dans l'interpréteur de commandes alternatif

-AllowOffline

Mode hors connexion de l'entrée.

-AlternateShell

Chemin (incluant le nom de fichier) de l'application à lancer dans l'interpréteur de commandes alternatif

-Animations

Activer les animations

-AsLegacyResponse

Dans les versions antérieures à 2024.2, de nombreuses cmdlets DS retournaient un objet ServerResponse. L'activation de ce commutateur de compatibilité ascendante permet aux scripts développés pour les versions antérieures de fonctionner correctement.

-AudioCaptureRedirectionMode

Enregistrer le son de la session RDP. Vrai par défaut.

-AudioQualityMode

Qualité audio RDP. Dynamique par défaut.

-AutoReconnection

Activer la reconnexion automatique en cas de déconnexion RDP. Vrai par défaut.

-AzureInstanceID

ID d'instance du service cloud Azure

-BandwidthAutoDetect

Activer la détection automatique de la bande passante. Vrai par défaut.

-CheckoutMode

Mode d'extraction de l'entrée.

-ClientSpec

Spécifications du cache

-CloseCommentIsRequired

Un commentaire est requis à la fermeture

-CloseCommentPrompt

Demander à l'utilisateur un commentaire/numéro de ticket à la fermeture

-CredentialMode

Mode d'identification : CredentialEntry => Entrée d'identification dans le même coffre. Vous devez utiliser le paramètre 'LinkedCredentialValue' pour spécifier l'ID de l'identification. PrivilegedAccount => Compte PAM à lier. Vous devez utiliser le paramètre 'LinkedCredentialValue' pour spécifier l'ID du compte PAM. PrivateVaultSearch => Identification dans le coffre de l'utilisateur. Vous devez utiliser le paramètre 'LinkedCredentialValue' pour spécifier le nom de l'identification.

-CredentialViewedCommentIsRequired

Un commentaire est requis pour consulter les informations d'identification de l'entrée

-CredentialViewedPrompt

Demander à l'utilisateur un commentaire/numéro de ticket

-DataCompression

Activer la compression des données. Vrai par défaut.

-Description

Description de l'entrée

-DesktopBackground

Activer l'arrière-plan du bureau. Vrai par défaut.

-DesktopComposition

Activer la composition du bureau

-DisplayMode

Mode d'affichage utilisé par RDP. Incorporé par défaut.

-DisplayMonitor

Moniteur d'affichage utilisé par RDP. Principal par défaut.

-DisplayVirtualDesktop

Bureau virtuel utilisé par RDP. Actuel par défaut.

-Domain

Nom du domaine

-EntryID

ID de l'entrée à modifier.

-Expiration

Date d'expiration de l'entrée (format ISO-8601 (yyyy-mm-ddThh:mm:ss.000Z)

-FontSmoothing

Activer le lissage des polices

-ForceAlternateShellProgram

Forcer l'utilisation de l'interpréteur de commandes alternatif plutôt que la méthode privilégiée RemoteApp.

-Group

Emplacement de l'entrée dans le coffre (nom du dossier, non l'ID)

-HostName

Nom d'hôte RDP (adresse)

-HyperVInstance

Instance Hyper-V

-KeepAliveInternal

Maintien de la connexion active. 1000 par défaut.

-KeyboardHook

Définit la destination des combinaisons de touches Windows (ALT+TAB, par exemple)

-LinkedCredentialValue

ID de l'identification liée ou nom de l'identification dans le coffre de l'utilisateur

-LoadAddonsMode

Définit si les modules complémentaires se chargent en mode incorporé ou non.

-MnemonicPassword

Ignoré. Mot de passe mnémotechnique de l'entrée pour aider à mémoriser le mot de passe

-Name

Nom de l'entrée

-NetworkAutoDetect

Activer la détection automatique du réseau

-NetworkConnectionType

Vitesse de connexion à utiliser pour RDP

-NewFieldsList

Champs à ajouter

-OpenCommentIsRequired

Un commentaire est requis à l'ouverture

-OpenCommentPrompt

Demander à l'utilisateur un commentaire/numéro de ticket à l'ouverture

-Password

Mot de passe de l'entrée

-PersistentBitmapCaching

Activer la mise en cache persistante des bitmaps. Vrai par défaut.

-Port

Port utilisé par RDP. 3389 par défaut.

-PromptCredentials

Demander le mot de passe lors de l'extraction

-RDPType

Type RDP. Normal par défaut.

-RedirectDirectX

Activer la redirection DirectX

-RedirectVideoPlayback

Activer la redirection de la lecture vidéo

-RemoteApplicationCmdLine

Paramètres de l'application distante

-RemoteApplicationProgram

Chemin (incluant le nom de fichier et l'extension) de l'application à lancer

-RoleName

Nom du rôle Azure Cloud Services

-ShellWorkingDirectory

Chemin du répertoire de l'interpréteur de commandes alternatif

-ShowContentWhileDragging

Activer l'affichage du contenu lors du déplacement sur l'écran. Vrai par défaut.

-SoundHook

Choisir la destination des sons. BringToThisComputer par défaut.

-Tags

Étiquettes de l'entrée (mots-clés). Chaque mot séparé par un espace est considéré comme un mot-clé.

-TicketNumberIsRequiredOnClose

Un numéro de ticket est requis à la fermeture

-TicketNumberIsRequiredOnCredentialViewed

Un numéro de ticket est requis pour consulter les informations d'identification de l'entrée

-TicketNumberIsRequiredOnOpen

Un numéro de ticket est requis à l'ouverture

-UseEnhancedSessionMode

Session améliorée Hyper-V (utilise les ressources locales de la machine, telles qu'un lecteur USB ou une imprimante)

-Username

Nom d'utilisateur de l'entrée

-UsesClipboard

Accès RDP au presse-papiers. Vrai par défaut.

-UsesDevices

Accès RDP aux « appareils » (tels que les caméras...)

-UsesHardDrives

Accès RDP aux disques durs. Vrai par défaut.

-UsesPrinters

Accès RDP aux imprimantes

-UsesSerialPorts

Accès RDP aux ports série. Vrai par défaut.

-UsesSmartDevices

Accès RDP aux appareils intelligents

-VisualStyles

Activer les styles visuels. Vrai par défaut.

-WarnIfAlreadyOpened

Avertit l'utilisateur si la session RDP est déjà ouverte

CommonParameters

Cette cmdlet prend en charge les paramètres communs : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d'informations, consultez about_CommonParameters.

Notes

Pour plus d'informations, tapez "Get-Help Update-DSRDPEntry -detailed". Pour des informations techniques, tapez "Get-Help Update-DSRDPEntry -full".

PrécédentUpdate-DSPamVaultSuivantUpdate-DSRole

Mis à jour

Ce contenu vous a-t-il été utile ?