Add-RDMEntryPasswordListItem
Übersicht
Ein Element zu einem Passwortlisten-Eintrag hinzufügen.
Syntax
__AllParameterSets
Add-RDMEntryPasswordListItem -InputObject <PSConnection> [-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 zu einem Passwortlisten-Eintrag hinzufügen und die bereits in der Liste vorhandenen Elemente behalten. Der zu ändernde Eintrag kann von Get-RDMEntry abgerufen werden. Ein Element muss mindestens einen Benutzernamen oder ein Passwort haben. Den Schalter Set verwenden, um die Änderung zu speichern, oder anschließend Set-RDMEntry aufrufen. Um ein Element hinzuzufügen, muss der Benutzer Bearbeitungsrechte für den Eintrag haben. OTP-Einstellungen werden separat mit Set-RDMEntryOTP über dessen Parameter PasswordListItemID konfiguriert.
Beispiele
Beispiel 1
PS C:\> $entry = Get-RDMEntry -Name 'MyPasswordList';
PS C:\> $field = New-RDMPasswordListItemCustomField -Name 'Environment' -Value 'Production';
PS C:\> $params = @{
Name = 'prod-db'
Username = 'sa'
Password = 'P@ssw0rd'
Host = 'db01.corp.local'
Domain = 'corp'
Description = 'Primary database account'
ExpirationDate = (Get-Date).AddMonths(6)
SortPriority = 10
User = (Get-RDMUser -Name 'jdoe')
UserGroup = (Get-RDMUserGroup -Name 'DBA')
CustomField = $field
Set = $true
}
PS C:\> $entry | Add-RDMEntryPasswordListItem @paramsEin vollständig ausgefülltes Element, allgemeine Felder, einen zulässigen Benutzer und eine zulässige Benutzergruppe sowie ein benutzerdefiniertes Feld hinzufügen und anschließend den Eintrag speichern.
Parameter
-Confirm
Fordert vor der Ausführung des Cmdlets eine Bestätigung an.
-CustomField
Benutzerdefinierte Felder, die dem Element hinzugefügt werden. Mit New-RDMPasswordListItemCustomField erstellen.
-Description
Beschreibung des Elements.
-Domain
Domäne des Elements.
-ExpirationDate
Ablaufdatum des Elements. Wenn es gesetzt wird, wird das Element als ablaufend markiert. 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
Host des Elements.
-InputObject
Gibt den Passwortlisten-Eintrag an, dem das Element hinzugefügt wird.
-Name
Name des Elements.
-PassThru
Den Eintrag zurückgeben.
-Password
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 das Element nur dem Eintragsobjekt im Arbeitsspeicher hinzugefügt.
-SortPriority
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. Wenn kein Benutzer und keine Benutzergruppe angegeben ist, ist das Element für alle sichtbar. Nur auf Datenquellen unterstützt, die Rollen pro Element zulassen (SQL Server).
-UserGroup
Benutzergruppen, die das Element sehen dürfen. Abgerufen von Get-RDMUserGroup. Wenn kein Benutzer und keine Benutzergruppe angegeben ist, ist das Element für alle sichtbar. Nur auf Datenquellen unterstützt, die Rollen pro Element zulassen (SQL Server).
-Username
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, dem das Element hinzugefügt wird. Kann von Get-RDMEntry bezogen werden.
Hinweise
Weitere Informationen erhalten Sie mit "Get-Help Add-RDMEntryPasswordListItem -detailed". Technische Informationen erhalten Sie mit "Get-Help Add-RDMEntryPasswordListItem -full".
Zuletzt aktualisiert
War das hilfreich?