Set-RDMEntryPasswordListItem
Sinossi
Modificare un elemento di una voce Elenco di password
Sintassi
__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>]Descrizione
Modificare un elemento di una voce Elenco di password. I valori correnti dell'elemento fornito vengono resi persistenti, quindi le modifiche apportate all'oggetto elemento vengono salvate. Qualsiasi parametro specificato sostituisce il campo corrispondente dell'elemento. Un elemento deve comunque avere almeno un nome utente o una password. Usare l'opzione Set per rendere persistente la modifica, oppure chiamare Set-RDMEntry in seguito. Una voce che non è un Elenco di password produce un errore. Le impostazioni OTP sono configurate separatamente con Set-RDMEntryOTP usando il parametro PasswordListItemID.
Esempi
Esempio 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 -SetSostituire ogni campo dell'elemento, i campi generali, l'utente e il gruppo di utenti consentiti e un campo personalizzato, quindi salvarlo e acquisire la voce restituita con PassThru. Infine, configurare l'OTP dell'elemento tramite Set-RDMEntryOTP, indirizzando l'elemento con il suo PasswordListItemID.
Parametri
-Confirm
Richiede una conferma prima di eseguire il cmdlet.
-CustomField
Campi personalizzati dell'elemento. Sostituisce i campi personalizzati esistenti. Crearli con New-RDMPasswordListItemCustomField.
-Description
Nuova descrizione dell'elemento.
-Domain
Nuovo dominio dell'elemento.
-ExpirationDate
Nuova data di scadenza dell'elemento. Impostarla contrassegna l'elemento come in scadenza; passare $null per cancellare la scadenza. Viene usata solo la data; l'ora del giorno viene ignorata.
-ForcePromptAnswer
Opzione da usare con cautela. Risponderà automaticamente ai prompt che pongono domande sì/no, sì/no/annulla oppure ok/annulla. In caso di più prompt, è possibile passare più valori a questo parametro. Ecco i valori accettati:
Yes: accetta il prompt. Copre i valori OK e Automatic.
No: rifiuta il prompt sì/no/annulla. "Cancel" è l'opzione di ripiego se non è presente l'opzione "No".
Cancel: annulla il prompt sì/no/annulla. "No" è l'opzione di ripiego se non è presente l'opzione "Cancel".
-Host
Nuovo host dell'elemento.
-InputObject
Specifica la voce Elenco di password che contiene l'elemento da modificare.
-Item
L'elemento da modificare. Ottenuto da Get-RDMEntryPasswordListItem.
-Name
Nuovo nome dell'elemento.
-PassThru
Restituire la voce.
-Password
Nuova password dell'elemento. Un elemento deve avere almeno un nome utente o una password.
-Refresh
Inviare una notifica di aggiornamento all'applicazione Remote Desktop Manager. Richiede l'opzione Set per rendere persistente la modifica.
-Set
Salvare la voce nello spazio di lavoro corrente. Senza di esso, la modifica viene applicata solo all'oggetto voce in memoria.
-SortPriority
Nuova priorità di ordinamento dell'elemento. Gli elementi sono ordinati in base a questo valore nell'Elenco di password.
-User
Utenti autorizzati a vedere l'elemento. Ottenuti da Get-RDMUser. Sostituisce gli utenti e i gruppi di utenti esistenti; passare una matrice vuota per rendere l'elemento visibile a tutti. Supportato solo sulle origini dati che consentono ruoli per elemento (SQL Server).
-UserGroup
Gruppi di utenti autorizzati a vedere l'elemento. Ottenuti da Get-RDMUserGroup. Sostituisce gli utenti e i gruppi di utenti esistenti; passare una matrice vuota per rendere l'elemento visibile a tutti. Supportato solo sulle origini dati che consentono ruoli per elemento (SQL Server).
-Username
Nuovo nome utente dell'elemento. Un elemento deve avere almeno un nome utente o una password.
-VaultMode
Cassaforte in cui verrà applicato il comando. Sono offerte tre scelte: - Default: cassaforte corrente impostata. - User: cassaforte specifica dell'utente corrente. - Global: cassaforte globale dello spazio di lavoro.
-WhatIf
Mostra cosa accadrebbe se il cmdlet venisse eseguito. Il cmdlet non viene eseguito.
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per maggiori informazioni, veda about_CommonParameters.
Input
RemoteDesktopManager.PowerShellModule.PSOutputObject.PSConnection
Voce Elenco di password che contiene l'elemento da modificare. Può essere ottenuta da Get-RDMEntry.
Output
RemoteDesktopManager.PowerShellModule.PSOutputObject.PSConnection
La voce, restituita con il parametro PassThru.
Note
Per maggiori informazioni, digiti "Get-Help Set-RDMEntryPasswordListItem -detailed". Per informazioni tecniche, digiti "Get-Help Set-RDMEntryPasswordListItem -full".
Ultimo aggiornamento
È stato utile?