Skicka från CLI

Bitwarden Send är tillgänglig som en uppsättning kompletta CLI-kommandon. Den här artikeln dokumenterar bredden av bw send-kommandon, men Send är inte ett separat verktyg från Bitwardens kommandoradsgränssnitt (CLI). Därför är många av kommandona, alternativen och koncepten i CLI-dokumentationen relevanta här.



skicka

Sendkommandot är huvudkommandot som används för att komma åt alla Send-relaterade underkommandon:

Bash
bw send [options] [command] <data>

Kommandot skicka kan också användas som en genväg för att snabbt skapa en Skicka, till exempel:

Bash
bw send "Fastest Send in the West."

kommer att skapa en text Skicka med innehållet Snabbast skicka i väst. och skicka ut länken Skicka. Eller till exempel:

Bash
bw send -f <path/to/file.ext>

kommer att skapa en fil Skicka med den angivna filen på den angivna sökvägen och skicka ut länken Skicka.

Alternativ:

Använd -n<name> eller --namn<name> för att ange ett namn för sändningen. Om ingen anges kommer namnet som standard till id för text skickar och filnamn för fil skickar. För namn med flera ord, använd citattecken "<name> ".
Använd -d<days> eller --deleteInDays<days> för att ange ett raderingsdatum för sändningen (standard är sju dagar om det inte anges).
Använd --maxAccessCount eller -a för att ange det maximala antalet åtkomster för sändningen.
Använd --hidden för att ange att en text Skicka kräver att mottagare växlar synlighet.
Använd --notes<notes> för att lägga till privata anteckningar i Skicka. För anteckningar med flera ord, använd citat "<notes> ".
Använd --fullObject för att mata ut hela Send-objektet som JSON snarare än bara Send-länken (para detta alternativ med --pretty-alternativet för formaterad JSON).

Fullständigt exempel:

Bash
bw send -n "My First Send" -d 7 --hidden "The contents of my first Send."



skapa

Skapa kommandot skapar en Skicka. create tillåter mer avancerad konfiguration än att bara använda bw send och tar kodad JSON för sitt argument:

Bash
bw send create [options] <encodedJson>

Ett typiskt arbetsflöde kan se ut ungefär så här:

Använd mallkommandot (se detaljer) för att mata ut lämplig JSON-mall för din sändningstyp.
Använd en kommandorads JSON-processor som jq för att manipulera den utmatade mallen efter behov.
Använd kodningskommandot (se detaljer) för att koda den manipulerade JSON.
Använd kommandot create för att skapa en Send från den kodade JSON.

Till exempel, för att skapa en text Skicka:

Bash
bw send template send.text | jq '.name="My First Send" | .text.text="Secrets I want to share."' | bw encode | bw send create

Till exempel, för att skapa en lösenordsskyddad fil Skicka:

Bash
bw send template send.file | jq '.name="My File Send" | .type=1 | .file.fileName="paperwork.png" | .password="p@ssw0rd"' | bw encode | bw send create

Till exempel för att skapa en lösenordsskyddad fil Skicka med ett explicit raderingsdatum. Det här exemplet är uppdelat efter operativsystem på grund av hur .deletionDate= ska specificeras:

Bash
$delDate = (Get-Date).AddDays(14) | date -UFormat "%Y-%m-%dT%H:%M:%SZ"

bw send template send.text | jq ".name=\`"My Send\`" | .text.text=\`"Secrets I want to share.\`" | .password=\`"password\`" | .deletionDate=\`"$delDate\`"" | bw encode | bw send create

Lägg märke till i det här exemplet att jq-anropet måste lindas med dubbla citattecken (" ") och använda escapes (\) för varje filter på grund av en kapslad datevariabel som konfigurerar ett .deletionDate i send.

Bash
bw send template send.text | jq ".name=\"My Send\" | .text.text=\"Secrets I want to share.\" | .password=\"mypassword\" | .deletionDate=\"$(date -uv+14d +"%Y-%m-%dT%H:%M:%SZ")\"" | bw encode | bw send create

Bash
bw send template send.text | jq ".name=\"My Send\" | .text.text=\"Secrets I want to share.\" | .password=\"mypassword\" | .deletionDate=\"$(date "+%Y-%m-%dT%H:%M:%SZ" -d "+14 days")\"" | bw encode | bw send create

Alternativ:

Använd --file<path> för att ange filen som ska skickas (detta kan också anges i kodad JSON).
Använd --text<text> för att ange texten som ska skickas (detta kan också anges i kodad JSON).
Använd --hidden för att ange att en text Skicka kräver att mottagare växlar synlighet.
Använd --lösenord<password> för att ange lösenordet som behövs för att komma åt lösenordsskyddat.
Använd --fullObject för att mata ut hela Send-objektet som JSON snarare än bara Send-länken (para detta alternativ med --pretty-alternativet för formaterad JSON).



få

Kommandot get kommer att hämta en Send som ägs av dig och mata ut den som ett JSON-objekt. get tar ett exakt id-värde eller valfri sträng för sitt argument. Om du använder en sträng kommer get att söka i dina skickar efter en med ett värde som matchar:

Bash
bw send get [options] <id / string>

Om du skapar en Skicka i en annan Bitwarden-app medan den här sessionen fortfarande är aktiv, använd kommandot bw sync för att hämta de senaste sändningarna. För mer information, se vår CLI-dokumentation.

Alternativ:

Använd --text för att bara mata ut textinnehållet i en text Skicka.
Använd --file för att endast skriva ut filen för en fil Skicka. Para --file med --output för att specificera en katalog, eller med --raw för att mata ut till stdout.
Använd --output<output> för att ange utdatakatalogen för alternativet --file.



redigera

Redigera kommandot redigerar en befintlig Send. edit tar kodad JSON för sitt argument:

Bash
bw send edit <encodedJson>

Ett typiskt arbetsflöde kan se ut ungefär så här:

Använd kommandot get (se detaljer) för att hämta önskad Skicka enligt dess<id> .
Använd en kommandorads JSON-processor som jq för att manipulera den hämtade Send efter behov.
Använd kodningskommandot (se detaljer) för att koda den manipulerade JSON.
Använd kommandot edit för att skriva ändringarna till sändningen.

Till exempel:

Bash
bw send get <id> | jq '.name="New Name" | .password=null' | bw encode | bw send edit

Alternativ:

Använd --itemid<itemid> för att skriva över id-värdet för Send med ett nytt.



note

Du kan inte redigera en fil Skickas fil. För att göra detta måste du ta bort Skicka och återskapa den med lämplig fil.



lista

Listkommandot listar alla sändningar som ägs av dig och matar ut dem som JSON:

Bash
bw send list [options]

Alternativ:

Använd --pretty för att formatera JSON-utgången.

Pipe stdout till en fil med > operatorn, till exempel:

Bash
bw send list --pretty  > /Users/myaccount/Documents/pretty_list_of_sends.json



radera

Kommandot delete kommer att ta bort en Send som ägs av dig. delete tar bara ett exakt id-värde för sitt argument.

Bash
bw send delete <id>



tip

Om du inte känner till det exakta ID:t för den sändning du vill ta bort, använd bw send get<search term> att hitta den.



mall

Mallkommandot returnerar den förväntade JSON-formateringen för ett Send-objekt. mall tar en<object> specifikation för dess argument, antingen send.text eller send.file.

Bash
bw send template <object>

Även om du kan använda mallen för att mata ut formatet till din skärm, är det vanligaste användningsfallet att skicka utdata till en bw send create-operation, med hjälp av en kommandorads JSON-processor som jq och bw encode för att manipulera värdena som hämtas från mallen, till exempel:

Bash
bw send template send.text | jq '.name="My First Send" | .text.text="Secrets I want to share."' | bw encode | bw send create



få

Mottagningskommandot ger åtkomst till en Skicka. ta emot tar en Skicka<url> för sitt argument:

Bash
bw send receive [options] <url>

För textsändningar kommer motta att returnera textinnehållet i sändningen.
För fil skickar, motta kommer att ladda ner filen till den aktuella arbetskatalogen.

Alternativ:

Använd --lösenord<password> för att ange lösenordet som behövs för att komma åt lösenordsskyddade sändningar som en sträng.
Använd --passwordenv<passwordenv> för att ange lösenordet som behövs för att komma åt lösenordsskyddade sändningar som en lagrad miljövariabel.
Använd --passwordfile<passwordfile> för att ange lösenordet som behövs för att komma åt lösenordsskyddade Skickar som en fil med lösenordet som första rad.
Använd --obj för att mata ut hela Send-objektet som JSON istället för bara Send-länken (para detta alternativ med --pretty-alternativet för formaterad JSON).
Använd --output<output> för att ange utdatakatalogen för innehållet i en fil Skicka.

Skicka från CLI

skicka

skapa

få

redigera

note

lista

radera

tip

mall

få

Suggest changes to this page

Molnstatus