Set-RDMEntryPasswordListItem
Übersicht
Ein Element eines Passwortlisten-Eintrags ändern
Syntax
__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>]Beschreibung
Ein Element eines Passwortlisten-Eintrags ändern. Die aktuellen Werte des angegebenen Elements werden gespeichert, sodass Änderungen am Elementobjekt gesichert werden. Jeder angegebene Parameter überschreibt das entsprechende Feld des Elements. Ein Element muss weiterhin mindestens einen Benutzernamen oder ein Passwort haben. Den Schalter Set verwenden, um die Änderung zu speichern, oder anschließend Set-RDMEntry aufrufen. Ein Eintrag, der keine Passwortliste ist, erzeugt einen Fehler. OTP-Einstellungen werden separat mit Set-RDMEntryOTP über dessen Parameter PasswordListItemID konfiguriert.
Beispiele
Beispiel 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 -SetJedes Feld des Elements, die allgemeinen Felder, den zulässigen Benutzer und die zulässige Benutzergruppe sowie ein benutzerdefiniertes Feld überschreiben, es anschließend speichern und den zurückgegebenen Eintrag mit PassThru erfassen. Zum Schluss das OTP des Elements über Set-RDMEntryOTP konfigurieren und das Element mit seiner PasswordListItemID angeben.
Parameter
-Confirm
Fordert vor der Ausführung des Cmdlets eine Bestätigung an.
-CustomField
Benutzerdefinierte Felder des Elements. Ersetzt die vorhandenen benutzerdefinierten Felder. Mit New-RDMPasswordListItemCustomField erstellen.
-Description
Neue Beschreibung des Elements.
-Domain
Neue Domäne des Elements.
-ExpirationDate
Neues Ablaufdatum des Elements. Wenn es gesetzt wird, wird das Element als ablaufend markiert; $null übergeben, um den Ablauf zu löschen. Nur das Datum wird verwendet; die Uhrzeit wird ignoriert.
-ForcePromptAnswer
Mit Vorsicht zu verwendender Schalter. Er beantwortet automatisch Eingabeaufforderungen mit Ja/Nein-, Ja/Nein/Abbrechen- oder OK/Abbrechen-Fragen. Bei mehreren Eingabeaufforderungen können mehrere Werte an diesen Parameter übergeben werden. Hier sind die zulässigen Werte:
Yes: Die Eingabeaufforderung annehmen. Deckt die Werte OK und Automatic ab.
No: Die Ja/Nein/Abbrechen-Eingabeaufforderung ablehnen. "Cancel" ist die Ausweichoption, wenn keine "No"-Option vorhanden ist.
Cancel: Die Ja/Nein/Abbrechen-Eingabeaufforderung abbrechen. "No" ist die Ausweichoption, wenn keine "Cancel"-Option vorhanden ist.
-Host
Neuer Host des Elements.
-InputObject
Gibt den Passwortlisten-Eintrag an, der das zu ändernde Element enthält.
-Item
Das zu ändernde Element. Abgerufen von Get-RDMEntryPasswordListItem.
-Name
Neuer Name des Elements.
-PassThru
Den Eintrag zurückgeben.
-Password
Neues Passwort des Elements. Ein Element muss mindestens einen Benutzernamen oder ein Passwort haben.
-Refresh
Eine Aktualisierungsbenachrichtigung an die Remote Desktop Manager-Anwendung senden. Erfordert den Schalter Set, um die Änderung zu speichern.
-Set
Den Eintrag in der aktuellen Datenquelle speichern. Ohne diesen Schalter wird die Änderung nur auf das Eintragsobjekt im Arbeitsspeicher angewendet.
-SortPriority
Neue Sortierpriorität des Elements. Die Elemente werden in der Passwortliste nach diesem Wert geordnet.
-User
Benutzer, die das Element sehen dürfen. Abgerufen von Get-RDMUser. Ersetzt die vorhandenen Benutzer und Benutzergruppen; ein leeres Array übergeben, um das Element für alle sichtbar zu machen. Nur auf Datenquellen unterstützt, die Rollen pro Element zulassen (SQL Server).
-UserGroup
Benutzergruppen, die das Element sehen dürfen. Abgerufen von Get-RDMUserGroup. Ersetzt die vorhandenen Benutzer und Benutzergruppen; ein leeres Array übergeben, um das Element für alle sichtbar zu machen. Nur auf Datenquellen unterstützt, die Rollen pro Element zulassen (SQL Server).
-Username
Neuer Benutzername des Elements. Ein Element muss mindestens einen Benutzernamen oder ein Passwort haben.
-VaultMode
Tresor, auf den der Befehl angewendet wird. Es werden drei Optionen angeboten: - Default: Aktuell festgelegter Tresor. - User: Tresor, der für den aktuellen Benutzer spezifisch ist. - Global: Globaler Tresor der Datenquelle.
-WhatIf
Zeigt, was passieren würde, wenn das Cmdlet ausgeführt würde. Das Cmdlet wird nicht ausgeführt.
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter about_CommonParameters.
Eingaben
RemoteDesktopManager.PowerShellModule.PSOutputObject.PSConnection
Passwortlisten-Eintrag, der das zu ändernde Element enthält. Kann von Get-RDMEntry abgerufen werden.
Ausgaben
RemoteDesktopManager.PowerShellModule.PSOutputObject.PSConnection
Der Eintrag, zurückgegeben mit dem Parameter PassThru.
Hinweise
Weitere Informationen erhalten Sie mit "Get-Help Set-RDMEntryPasswordListItem -detailed". Technische Informationen erhalten Sie mit "Get-Help Set-RDMEntryPasswordListItem -full".
Zuletzt aktualisiert
War das hilfreich?