Daten aktualisieren (update)

Übersicht

update ändert Passwork-Eintragswerte (Passwort, Name, benutzerdefinierte Felder) gemäß den angegebenen Parametern.

Anwendungsfälle

1. Einzelne Felder aktualisieren — Passwort, Name, Login, URL, Beschreibung, Tags oder benutzerdefinierte Felder separat ändern
2. Feldwerte löschen — Felder durch Übergabe eines leeren Strings leeren
3. Massenaktualisierungen — mehrere Felder mit einem einzigen Befehl ändern
4. Benutzerdefinierte Felder aktualisieren — benutzerdefinierte Felder für Einträge und Shortcuts hinzufügen/ändern

Identifikation des Eintrags

Parameter	Beschreibung
--password-id	Eintrags-ID (Element)
--shortcut-id	Shortcut-ID (Shortcut)

Aktualisierungsparameter

Parameter	Beschreibung
--name	Neuer Eintragsname. Ein leerer Wert gibt einen Fehler zurück
--password	Neuer Passwortwert
--login	Neuer Login-Wert
--url	Neue URL-Adresse
--description	Neuer Notizentwert
--tags	Kommagetrennte Liste von Tags. Leerer String löscht Tags
--custom-{name}	Benutzerdefiniertes Feld nach Name setzen, z. B. --custom-API_KEY "..."

Syntax

shell

passwork-cli update --password-id <id> [field-changes]

Grundlegende Verwendung

Geben Sie entweder --password-id oder --shortcut-id an, um das zu aktualisierende Objekt zu identifizieren.

shell

passwork-cli update \
  --host "https://passwork.example.com" \
  --token "your_access_token" \
  --master-key "your_master_key" \
  --password-id "68793e13dfc88d879e0f2e39" \
  --password "new-password-value"

Verwendung von Umgebungsvariablen

Sie können Passwork-Daten als Umgebungsvariablen exportieren:

shell

export PASSWORK_HOST="https://passwork.example.com"
export PASSWORK_TOKEN="your_access_token"
export PASSWORK_MASTER_KEY="your_master_key"

# Then update without specifying credentials
passwork-cli update \
  --password-id "68793e13dfc88d879e0f2e39" \
  --password "new-password"

Dies ist nützlich für Automatisierungsskripte und CI/CD-Pipelines, bei denen Anmeldedaten sicher als Umgebungsvariablen gespeichert werden können.

Standardfelder aktualisieren

Standardfelder: Name, Passwort, Login, URL, Beschreibung und Tags.

shell

# Update password
passwork-cli update --password-id "68793e13dfc88d879e0f2e39" --password "new-password"

# Update login
passwork-cli update --password-id "68793e13dfc88d879e0f2e39" --login "new-login"

# Update name
passwork-cli update --password-id "68793e13dfc88d879e0f2e39" --name "New Item Name"

# Update URL
passwork-cli update --password-id "68793e13dfc88d879e0f2e39" --url "https://example.com"

# Update description
passwork-cli update --password-id "68793e13dfc88d879e0f2e39" --description "Updated description"

# Update tags (comma-separated)
passwork-cli update --password-id "68793e13dfc88d879e0f2e39" --tags "tag1,tag2,tag3"

# Clear field (set to empty)
passwork-cli update --password-id "68793e13dfc88d879e0f2e39" --description ""

Benutzerdefinierte Felder aktualisieren

Aktualisierung mit der --custom-*-Syntax, wobei * der Name des benutzerdefinierten Feldes ist.

shell

# Update custom field API_KEY
passwork-cli update \
  --password-id "68793e13dfc88d879e0f2e39" \
  --custom-API_KEY "new-api-key-value"

# Clear custom field
passwork-cli update \
  --password-id "68793e13dfc88d879e0f2e39" \
  --custom-API_KEY ""

Massenaktualisierungen

Mehrere Felder mit einem einzigen Befehl aktualisieren.

shell

# Update login and password together
passwork-cli update \
  --password-id "68793e13dfc88d879e0f2e39" \
  --login "new-login" \
  --password "new-password"

# Update multiple fields including custom field
passwork-cli update \
  --password-id "68793e13dfc88d879e0f2e39" \
  --password "new-password" \
  --description "Updated description" \
  --tags "production,database,api" \
  --custom-API_KEY "new-api-key-value"

# Full update with all fields
passwork-cli update \
  --password-id "68793e13dfc88d879e0f2e39" \
  --name "UpdateName" \
  --login "UpdateLogin" \
  --password "UpdatePassword" \
  --description "UpdateDescription" \
  --tags "update,all,tags" \
  --url "https://update.url" \
  --custom-API_KEY "update_api_key"

Arbeiten mit Shortcuts

Ähnliche Parameter funktionieren für Shortcuts über --shortcut-id.

shell

# Update shortcut fields
passwork-cli update \
  --shortcut-id "68d6c94bec3a3fe41209546e" \
  --password "shortcut-password" \
  --login "shortcut-login"

# Update shortcut with multiple fields
passwork-cli update \
  --shortcut-id "68d6c94bec3a3fe41209546e" \
  --name "Update name" \
  --description "Updated shortcut" \
  --tags "shortcut,updated" \
  --custom-API_KEY "shortcut-api-key"

Funktionsweise

1. CLI verbindet sich mit dem Passwork-Server unter Verwendung der bereitgestellten Anmeldedaten
2. Ruft einen Eintrag oder Shortcut per ID ab
3. Entschlüsselt die Daten mit dem Masterschlüssel (bei Verwendung clientseitiger Verschlüsselung)
4. Wendet neue Werte auf die angegebenen Felder an
5. Leere Strings ("") löschen die entsprechenden Felder
6. Benutzerdefinierte Felder werden über die --custom-*-Syntax geändert
7. Tags werden als kommagetrennte Liste akzeptiert und ersetzen die vorhandenen
8. Das aktualisierte Objekt wird in Passwork gespeichert