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

Objet entrée

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 avec 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 avoir les droits appropriés : ajouter pour une nouvelle entrée, et modifier pour une entrée existante. Pour les sources de données gérant l'âge du mot de passe, il est également possible de modifier cette valeur pour le nouveau mot de passe. Cela peut servir à indiquer quand le mot de passe a été généré au lieu de quand 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éer une nouvelle entrée d'identifiant. Son nom d'utilisateur et son mot de passe sont en train d'être définis. L'appel à Set-RDMEntryPassword modifie l'objet local. L'utilisateur peut effectuer d'autres modifications si désiré. La dernière ligne sauvegarde enfin 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 aura un âge 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. Conserver la modification avec l'appel Set-RDMEntry.

Paramètres

-Confirmer

Vous invite à confirmer 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: ''

-Réponse d'invite forcée

Interrupteur à utiliser avec précaution. Il répondra automatiquement aux invites demandant oui/non, oui/non/annuler, ou ok/annuler. En cas de multiples invites, plusieurs valeurs peuvent être passées à ce paramètre. Voici les valeurs acceptées :

  • Oui : Accepter l'invite. Couvrir la valeur OK et Automatique.

  • Non : Refuser l'invite oui/non/annuler. Annuler est l'option de secours s'il n'y a pas d'option Non.

  • Annuler : Annuler l'invite oui/non/annuler. Non est l'option par défaut s'il n'y a pas d'option Annuler.

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écifier l'ID de la session pour 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écifier la session pour 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: ''

-Restituer

Restituer 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: ''

-MotDePasse

Mot de passe en SecureString. Utilisez soit "Read-Host -AsSecureString" ou "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écifier l'ancienneté du mot de passe en jours. PasswordAge prend la 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: ''

-Date depuis le mot de passe

Spécifier la date/heure (UTC) à laquelle le mot de passe a été créé pour la première fois. PasswordAge prend la 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: ''

-Actualiser

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 la source de données actuelle.

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: ''

-Mode du coffre-fort

Coffre où la commande sera appliquée. Trois choix sont proposés :

  • Défaut : Coffre actuel qui a été défini.

  • Utilisateur : Coffre spécifique à l'utilisateur actuel.

  • Global : Coffre global de la source de données.

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

Montrer ce qui se passerait 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: ''

ParamètresCommuns

Cet applet de commande supporte les paramètres communs : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, et -WarningVariable. Pour plus d'informations, consulter 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, taper "Get-Help Set-RDMEntryPassword -detailed". Pour des informations techniques, taper "Get-Help Set-RDMEntryPassword -full".

Devolutions Forum logo Donnez-nous vos commentaires