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 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 posséder les 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. Elle peut servir à indiquer le moment où le mot de passe a été généré plutôt que le moment où le mot de passe 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'identifiants. Son nom d'utilisateur et son mot de passe sont définis. L'appel à Set-RDMEntryPassword modifie l'objet local. L'utilisateur peut apporter d'autres modifications s'il le souhaite. 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 il sera âgé 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écédemment. Persister la modification avec l'appel Set-RDMEntry.

Paramètres

-Confirm

Vous demande une confirmation avant d'exécuter l'applet de commande.

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

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

• Yes : Accepter l'invite. Couvre les valeurs OK et Automatic.
• No : Refuser l'invite oui/non/annuler. « Cancel » est l'option de repli s'il n'y a pas d'option « No ».
• Cancel : Annuler l'invite oui/non/annuler. « No » est l'option de repli s'il n'y a 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 on veut obtenir le mot de passe.

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 pour laquelle définir le mot de passe.

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

Retourner 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 en tant que SecureString. Utiliser 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 et l'heure (UTC) auxquelles 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

Envoyer 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

Enregistrer 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 dans lequel 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

Montre ce qui se produirait si l'applet de commande était exécutée. L'applet de commande 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 applet de commande prend en charge les paramètres communs : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d'information, voir about_CommonParameters.

Entrées

RemoteDesktopManager.PowerShellModule.PSOutputObject.PSConnection

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

Notes

Pour plus d'information, taper « Get-Help Set-RDMEntryPassword -detailed ». Pour de l'information technique, taper « Get-Help Set-RDMEntryPassword -full ».