Set-RDMEntryPasswordListItem
Synopsis
Modifier un élément d'une entrée Liste de mots de passe
Syntaxe
__AllParameterSets
Set-RDMEntryPasswordListItem -InputObject <PSConnection> -Item <PSPasswordListItem>
[-Name <string>] [-Username <string>] [-Password <PSPassword>] [-Host <string>]
[-Domain <string>] [-Description <string>] [-ExpirationDate <datetime>] [-SortPriority <int>]
[-CustomField <PSPasswordListCustomValue[]>] [-User <IPSUser[]>] [-UserGroup <PSRoleInfo[]>]
[-PassThru] [-Refresh] [-Set] [-VaultMode <VaultMode>] [-ForcePromptAnswer <DialogResult[]>]
[-WhatIf] [-Confirm] [<CommonParameters>]Description
Modifier un élément d'une entrée Liste de mots de passe. Les valeurs actuelles de l'élément fourni sont conservées, donc les changements apportés à l'objet élément sont enregistrés. Tout paramètre spécifié remplace le champ correspondant de l'élément. Un élément doit encore avoir au moins un nom d'utilisateur ou un mot de passe. Utiliser le commutateur Set pour conserver le changement, ou appeler Set-RDMEntry ensuite. Une entrée qui n'est pas une Liste de mots de passe produit une erreur. Les paramètres OTP sont configurés séparément avec Set-RDMEntryOTP au moyen de son paramètre PasswordListItemID.
Exemples
Exemple 1
PS C:\> $entry = Get-RDMEntry -Name 'MyPasswordList';
PS C:\> $item = $entry | Get-RDMEntryPasswordListItem -Name 'prod-db';
PS C:\> $field = New-RDMPasswordListItemCustomField -Name 'Environment' -Value 'Production';
PS C:\> $params = @{
Item = $item
Name = 'prod-db-primary'
Username = 'sa'
Password = 'NewP@ss'
Host = 'db01.corp.local'
Domain = 'corp'
Description = 'Rotated primary database account'
ExpirationDate = (Get-Date).AddMonths(6)
SortPriority = 10
CustomField = $field
User = (Get-RDMUser -Name 'jdoe')
UserGroup = (Get-RDMUserGroup -Name 'DBA')
Set = $true
PassThru = $true
}
PS C:\> $entry = $entry | Set-RDMEntryPasswordListItem @params
PS C:\> $key = ConvertTo-SecureString -AsPlainText -String '12345678'
PS C:\> Set-RDMEntryOTP -InputObject $entry -PasswordListItemID $item.Id -Key $key -TimeStep 60 -SetRemplacer chaque champ de l'élément, les champs généraux, l'utilisateur et le groupe d'utilisateurs autorisés, et un champ personnalisé, puis l'enregistrer et capturer l'entrée retournée avec PassThru. Enfin, configurer l'OTP de l'élément au moyen de Set-RDMEntryOTP, en ciblant l'élément avec son PasswordListItemID.
Paramètres
-Confirm
Demande une confirmation avant d'exécuter l'applet de commande.
-CustomField
Champs personnalisés de l'élément. Remplace les champs personnalisés existants. Les construire avec New-RDMPasswordListItemCustomField.
-Description
Nouvelle description de l'élément.
-Domain
Nouveau domaine de l'élément.
-ExpirationDate
Nouvelle date d'expiration de l'élément. La définir marque l'élément comme expirant ; passer $null pour effacer l'expiration. Seule la date est utilisée ; l'heure est ignorée.
-ForcePromptAnswer
Commutateur à utiliser avec prudence. Il répondra automatiquement aux invites posant des questions oui/non, oui/non/annuler ou ok/annuler. En cas d'invites multiples, plusieurs valeurs peuvent être passées à 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 ».
-Host
Nouvel hôte de l'élément.
-InputObject
Spécifie l'entrée Liste de mots de passe qui contient l'élément à modifier.
-Item
L'élément à modifier. Obtenu de Get-RDMEntryPasswordListItem.
-Name
Nouveau nom de l'élément.
-PassThru
Retourner l'entrée.
-Password
Nouveau mot de passe de l'élément. Un élément doit avoir au moins un nom d'utilisateur ou un mot de passe.
-Refresh
Envoyer une notification d'actualisation à l'application Remote Desktop Manager. Nécessite le commutateur Set pour conserver le changement.
-Set
Enregistrer l'entrée dans l'espace de travail actuel. Sans cela, le changement n'est appliqué qu'à l'objet entrée en mémoire.
-SortPriority
Nouvelle priorité de tri de l'élément. Les éléments sont ordonnés selon cette valeur dans la Liste de mots de passe.
-User
Utilisateurs autorisés à voir l'élément. Obtenus de Get-RDMUser. Remplace les utilisateurs et les groupes d'utilisateurs existants ; passer un tableau vide pour rendre l'élément visible de tous. Pris en charge uniquement sur les sources de données qui permettent des rôles par élément (SQL Server).
-UserGroup
Groupes d'utilisateurs autorisés à voir l'élément. Obtenus de Get-RDMUserGroup. Remplace les utilisateurs et les groupes d'utilisateurs existants ; passer un tableau vide pour rendre l'élément visible de tous. Pris en charge uniquement sur les sources de données qui permettent des rôles par élément (SQL Server).
-Username
Nouveau nom d'utilisateur de l'élément. Un élément doit avoir au moins un nom d'utilisateur ou un mot de passe.
-VaultMode
Coffre dans lequel la commande sera appliquée. Trois choix sont offerts : - Default : Coffre actuel qui a été défini. - User : Coffre spécifique à l'utilisateur actuel. - Global : Coffre global de l'espace de travail.
-WhatIf
Montre ce qui se passerait si l'applet de commande était exécutée. L'applet de commande n'est pas exécutée.
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'informations, consultez about_CommonParameters.
Entrées
RemoteDesktopManager.PowerShellModule.PSOutputObject.PSConnection
Entrée Liste de mots de passe qui contient l'élément à modifier. Peut être obtenue de Get-RDMEntry.
Sorties
RemoteDesktopManager.PowerShellModule.PSOutputObject.PSConnection
L'entrée, retournée avec le paramètre PassThru.
Notes
Pour plus d'information, tapez « Get-Help Set-RDMEntryPasswordListItem -detailed ». Pour de l'information technique, tapez « Get-Help Set-RDMEntryPasswordListItem -full ».
Mis à jour
Ce contenu vous a-t-il été utile ?