Set-RDMEntryPassword

Synopsis

Définir le mot de passe d'une entrée

Syntaxe

Id

Set-RDMEntryPassword [-ID] <guid> [-Password] <securestring> [-PasswordAge <int>]
 [-PasswordSinceDate <datetime>] [-PassThru] [-Refresh] [-Set] [-VaultMode <VaultMode>]
 [-ForcePromptAnswer <DialogResult[]>] [-WhatIf] [-Confirm] [<CommonParameters>]

InputObject

Set-RDMEntryPassword [-InputObject] <PSConnection> [-Password] <securestring> [-PasswordAge <int>]
 [-PasswordSinceDate <datetime>] [-PassThru] [-Refresh] [-Set] [-VaultMode <VaultMode>]
 [-ForcePromptAnswer <DialogResult[]>] [-WhatIf] [-Confirm] [<CommonParameters>]

Description

Définir le mot de passe d'une entrée. L'entrée à modifier peut être récupérée par son ID ou par un objet PSConnection obtenu à partir de Get-RDMEntry, New-RDMEntry, Get-RDMPersonalCredentials ou Get-RDMPrivilegedAccount. Dans ce dernier cas, l'objet local sera modifié. Pour modifier le mot de passe, l'utilisateur doit disposer des droits appropriés : ajout pour une nouvelle entrée et modification pour une entrée existante. Pour les espaces de travail prenant en charge l'âge du mot de passe, il est également possible de modifier cette valeur pour le nouveau mot de passe. Cette valeur peut être utilisée pour indiquer la date de génération du mot de passe plutôt que la date à laquelle il a été défini dans l'entrée.

Exemples

Exemple 1

PS C:\> $entry = New-RDMEntry -Type Credential -Name 'NewCredEntry';
    $entry.Credentials.UserName = 'MyUserName';
    Set-RDMEntryPassword -InputObject $entry -Password (Read-Host -AsSecureString -Prompt 'Password')
    Set-RDMEntry -InputObject $entry

L'utilisateur crée une nouvelle entrée d'informations d'identification. Son nom d'utilisateur et son mot de passe sont définis. L'appel à Set-RDMEntryPassword modifie l'objet local. L'utilisateur peut effectuer d'autres modifications si désiré. La dernière ligne enregistre finalement la nouvelle entrée.

Exemple 2

PS C:\> $pwd = ConvertTo-SecureString -AsPlainText -String 'passwordFr0mSomewhereElse';
    Get-RDMEntry -Name 'EntryToModify' | Set-RDMEntryPassword -Password $pwd -PasswordAge 14 -Set -Refresh

L'entrée nommée 'EntryToModify' aura un mot de passe mis à jour, celui stocké dans $pwd, et son âge sera de 14 jours.

Exemple 3

PS C:\> Get-RDMEntry -Name 'UniqueName' |
                    Set-RDMEntryDomain -Domain 'MyOtherDomain.com' -PassThru |
                    Set-RDMEntryPassword -Password $securePassword -PassThru |
                    Set-RDMEntryUsername -UserName 'NewUserName' -PassThru |
                    Set-RDMEntry

Modifier le domaine, le mot de passe et le nom d'utilisateur de l'entrée nommée 'UniqueName'. La variable $securePassword est une chaîne sécurisée définie préalablement. Les modifications sont conservées grâce à l'appel à Set-RDMEntry.

Paramètres

-Confirm

Vous demande une confirmation avant d'exécuter la cmdlet.

Type: System.Management.Automation.SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases:
- cf
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ForcePromptAnswer

Paramètre à utiliser avec prudence. Il répondra automatiquement aux invites posant des questions de type oui/non, oui/non/annuler ou OK/annuler. En cas de plusieurs invites, plusieurs valeurs peuvent être transmises à ce paramètre. Voici les valeurs acceptées :

• Yes : Accepte l'invite. Couvre les valeurs OK et Automatic.
• No : Refuse l'invite oui/non/annuler. « Cancel » est l'option de secours s'il n'existe pas d'option « No ».
• Cancel : Annule l'invite oui/non/annuler. « No » est l'option de secours s'il n'existe pas d'option « Cancel ».

Type: System.Windows.Forms.DialogResult[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ID

Spécifie l'ID de la session dont le mot de passe doit être récupéré.

Doit être un GUID valide, sous la forme {00000000-0000-0000-0000-000000000000}.

Type: System.Guid
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: Id
  Position: 0
  IsRequired: true
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-InputObject

Spécifie la session à laquelle le mot de passe doit être défini.

Type: RemoteDesktopManager.PowerShellModule.PSOutputObject.PSConnection
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: InputObject
  Position: 0
  IsRequired: true
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-PassThru

Retourne l'entrée modifiée.

Type: System.Management.Automation.SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Password

Mot de passe sous forme de SecureString. Utilisez soit « Read-Host -AsSecureString » soit « ConvertTo-SecureString ».

Type: System.Security.SecureString
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 1
  IsRequired: true
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-PasswordAge

Spécifie l'âge du mot de passe en jours. PasswordAge a priorité sur PasswordSinceDate.

Type: System.Int32
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-PasswordSinceDate

Spécifie la date/heure (UTC) à laquelle le mot de passe a été créé pour la première fois. PasswordAge a priorité sur PasswordSinceDate.

Type: System.DateTime
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Refresh

Envoie une notification d'actualisation à l'application Remote Desktop Manager.

Type: System.Management.Automation.SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Set

Enregistre la session dans l'espace de travail actuel.

Type: System.Management.Automation.SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-VaultMode

Coffre auquel la commande sera appliquée. Trois choix sont offerts :

• Default : Coffre actuel qui a été défini.
• User : Coffre propre à l'utilisateur actuel.
• Global : Coffre global de l'espace de travail.

Type: Devolutions.RemoteDesktopManager.VaultMode
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-WhatIf

Affiche ce qui se passerait si la cmdlet s'exécutait. La cmdlet n'est pas exécutée.

Type: System.Management.Automation.SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases:
- wi
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

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.

Entrées

RemoteDesktopManager.PowerShellModule.PSOutputObject.PSConnection

Entrée dont le mot de passe sera modifié. Peut être obtenue à partir de Get-RDMEntry, New-RDMEntry, Get-RDMPersonalCredentials ou Get-RDMPrivilegedAccount.

Notes

Pour plus d'informations, tapez « Get-Help Set-RDMEntryPassword -detailed ». Pour des informations techniques, tapez « Get-Help Set-RDMEntryPassword -full ».