Set-RDMEntryPasswordListItem
Sinopsis
Modificar un elemento de una entrada de lista de contraseñas
Sintaxis
__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>]Descripción
Modificar un elemento de una entrada de lista de contraseñas. Se conservan los valores actuales del elemento proporcionado, por lo que se guardan los cambios realizados en el objeto de elemento. Cualquier parámetro que se especifique reemplaza el campo correspondiente del elemento. Un elemento debe seguir teniendo al menos un nombre de usuario o una contraseña. Use el modificador Set para conservar el cambio, o llame a Set-RDMEntry después. Una entrada que no es una lista de contraseñas produce un error. La configuración de OTP se configura por separado con Set-RDMEntryOTP mediante su parámetro PasswordListItemID.
Ejemplos
Ejemplo 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 -SetReemplazar cada campo del elemento, los campos generales, el usuario y el grupo de usuarios permitidos y un campo personalizado, guardarlo y capturar la entrada devuelta con PassThru. Por último, configurar el OTP del elemento mediante Set-RDMEntryOTP, dirigiéndose al elemento con su PasswordListItemID.
Parámetros
-Confirm
Solicita confirmación antes de ejecutar el cmdlet.
-CustomField
Campos personalizados del elemento. Reemplaza los campos personalizados existentes. Créelos con New-RDMPasswordListItemCustomField.
-Description
Nueva descripción del elemento.
-Domain
Nuevo dominio del elemento.
-ExpirationDate
Nueva fecha de expiración del elemento. Al establecerla, el elemento se marca como que expira; pase $null para borrar la expiración. Solo se usa la fecha; se ignora la hora del día.
-ForcePromptAnswer
Modificador que debe usarse con precaución. Responderá automáticamente a los mensajes que planteen preguntas de sí/no, sí/no/cancelar u ok/cancelar. En caso de varios mensajes, se pueden pasar varios valores a este parámetro. Estos son los valores aceptados:
Yes: acepta el mensaje. Cubre los valores OK y Automatic.
No: rechaza el mensaje sí/no/cancelar. "Cancel" es la opción alternativa si no existe la opción "No".
Cancel: cancela el mensaje sí/no/cancelar. "No" es la opción alternativa si no existe la opción "Cancel".
-Host
Nuevo host del elemento.
-InputObject
Especifica la entrada de lista de contraseñas que contiene el elemento que modificar.
-Item
El elemento que modificar. Obtenido de Get-RDMEntryPasswordListItem.
-Name
Nuevo nombre del elemento.
-PassThru
Devolver la entrada.
-Password
Nueva contraseña del elemento. Un elemento debe tener al menos un nombre de usuario o una contraseña.
-Refresh
Enviar una notificación de actualización a la aplicación Remote Desktop Manager. Requiere el modificador Set para conservar el cambio.
-Set
Guardar la entrada en el espacio de trabajo actual. Sin ello, el cambio solo se aplica al objeto de entrada en memoria.
-SortPriority
Nueva prioridad de ordenación del elemento. Los elementos se ordenan por este valor en la lista de contraseñas.
-User
Usuarios autorizados a ver el elemento. Obtenidos de Get-RDMUser. Reemplaza los usuarios y grupos de usuarios existentes; pase una matriz vacía para que el elemento sea visible para todos. Solo se admite en orígenes de datos que permiten roles por elemento (SQL Server).
-UserGroup
Grupos de usuarios autorizados a ver el elemento. Obtenidos de Get-RDMUserGroup. Reemplaza los usuarios y grupos de usuarios existentes; pase una matriz vacía para que el elemento sea visible para todos. Solo se admite en orígenes de datos que permiten roles por elemento (SQL Server).
-Username
Nuevo nombre de usuario del elemento. Un elemento debe tener al menos un nombre de usuario o una contraseña.
-VaultMode
Bóveda en la que se aplicará el comando. Se ofrecen tres opciones: - Default: bóveda actual que se ha establecido. - User: bóveda específica del usuario actual. - Global: bóveda global del espacio de trabajo.
-WhatIf
Muestra lo que ocurriría si se ejecutara el cmdlet. El cmdlet no se ejecuta.
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.
Entradas
RemoteDesktopManager.PowerShellModule.PSOutputObject.PSConnection
Entrada de lista de contraseñas que contiene el elemento que modificar. Se puede obtener de Get-RDMEntry.
Salidas
RemoteDesktopManager.PowerShellModule.PSOutputObject.PSConnection
La entrada, devuelta con el parámetro PassThru.
Notas
Para más información, escriba "Get-Help Set-RDMEntryPasswordListItem -detailed". Para obtener información técnica, escriba "Get-Help Set-RDMEntryPasswordListItem -full".
Última actualización
¿Te fue útil?