Bitwarden 帮助中心中文版
⮐ Bitwarden Help Center个人主页联系我
  • 关于
  • 首页
  • 发布记录
  • 账户
    • 创建 Bitwarden 账户
    • 登录 & 解锁
      • 主密码
      • 忘记主密码
      • 新设备登录保护
      • 使用 SSO 登录
      • 使用设备登录
      • 使用通行密钥登录 (Beta)
      • 账户切换
      • 使用 PIN 码解锁
      • 使用生物识别解锁
      • 密码库超时选项
    • 两步登录
      • 两步登录现场指南
      • 两步登录方式
      • 设置指南
        • 两步登录 - 验证器
        • 两步登录 - 电子邮箱
        • 两步登录 - Duo
        • 两步登录 - YubiKey
        • 两步登录 - 通行密钥
      • 恢复代码
      • 丢失了辅助设备
      • 两步登录 FAQ
    • 更多
      • 紧急访问
      • 本地化
      • *异常流量错误
  • Password Manager
    • Password Manager 概述
    • 入门
      • Password Manager 网页 App
      • Password Manager 浏览器扩展
      • Password Manager 移动 App
      • Password Manager 桌面 App
    • 密码库基础
      • 密码库项目
      • 用户名 & 密码生成器
      • 自定义字段
      • 集成的验证器
      • 文件附件
      • 共享
      • 集合
      • 存储通行密钥
      • *通行密钥 FAQ
    • 密码库管理
      • 文件夹
      • 收藏
      • 同步密码库
      • 检索密码库
      • 密码库健康报告
    • 导入 & 导出
      • 导入数据到密码库
      • 导入指南
        • 从 LastPass 导入
        • 从 1Password 导入
        • 从 Keeper 导入
        • 从 Dashlane 导入
        • 从 Google Chrome 导入
        • 从 macOS & Safari 导入
        • 从 Firefox 导入
        • 从 Password Safe 导入
        • 从 Myki 导入
      • 导出密码库数据
      • 加密导出
      • 调整 Bitwarden .csv 或 .json
      • *Bitwarden 导入器工具
      • 导入 & 导出 FAQ
    • 自动填充
      • 自动填充基础
        • 在浏览器扩展中自动填充登录
        • 在 Android 上自动填充登录
        • 在 iOS 上自动填充登录
        • 自动填充支付卡和身份
        • 自动填充自定义字段
      • 使用 URI
      • 屏蔽自动填充
      • 基本验证提示
      • 键盘快捷键
      • 禁用浏览器的内置密码管理器
      • Android 自动填充故障排除
      • 自动填充 FAQ
    • Bitwarden Send
      • 关于 Send
      • 创建 Send
      • 接收 Send
      • Send 生命周期
      • Send 隐私
      • CLI 上的 Send
      • Send 加密
      • Send FAQ
    • 开发者工具
      • Password Manager API
      • Password Manager CLI
      • CLI 身份验证挑战
      • 用于 CLI 验证的个人 API 密钥
      • SSH 代理
    • 更多
      • Password Manager FAQ
      • 更改 App 主题
      • DuckDuckGo macOS 浏览器集成
      • Apple Watch 上的 Bitwarden
      • 在 Firefox 隐私窗口中使用 Bitwarden
      • 离线使用 Bitwarden
      • 排除域名
      • Safari 网页扩展
      • uMatrix 和 NoScript 访问规则
      • 与 Bitwarden 支持排除移动端故障
  • Bitwarden Authenticator
    • Bitwarden Authenticator
    • 导入 & 导出
    • FAQ
  • Secrets Manager
    • Secrets Manager 概述
    • 入门
      • Secrets Manager 快速入门
      • 开发人员快速入门
      • 登录 Secrets Manager
      • 管理您的组织
    • 您的机密
      • 工程
      • 机密
      • 机器账户
      • 访问令牌
      • 机密解密
    • 导入 & 导出
      • 导入数据
      • 导出数据
    • 开发人员工具
      • Secrets Manager CLI
      • Secrets Manager SDK
    • 集成
      • Ansible
      • GitHub Actions
      • GitLab CI/CD
      • Secrets Manager Kubernetes Operator
    • 更多
      • Secrets Manager FAQ
  • 管理控制台
    • 组织快速入门
    • 组织基础
      • 组织
      • 集合
      • 群组
      • 企业策略
      • 集合管理
    • 用户管理
      • 用户管理
      • 成员角色和权限
      • 声明域名
      • 声明账户
      • 账户恢复
      • SCIM
        • 关于 SCIM
        • JumpCloud SCIM 集成
        • Microsoft Entra ID SCIM 集成
        • Okta SCIM 集成
        • OneLogin SCIM 集成
        • Ping Identity SCIM 集成
      • 目录连接器
        • 关于目录连接器
        • 目录连接器桌面 App
        • 目录连接器 CLI
        • 目录连接器文件存储
        • 同步选项和筛选器
        • 清除同步缓存
        • 调度同步
        • 使用 AD 或 LDAP 同步
        • 使用 Microsoft Entra ID 同步
        • 使用 Google Workspace 同步
        • 使用 Okta 同步
        • 使用 OneLogin 同步
      • 入职和继任概述
    • 导入 & 导出
      • 导入数据到组织
      • 导出密码库数据
      • 调整 Bitwarden .csv 或 .json
    • SSO 登录
      • 关于 SSO 登录
      • SAML 2.0 配置
      • OIDC 配置
      • 成员解密选项
      • 声明域名
      • 实施指南
        • ADFS SAML 实施
        • Auth0 SAML 实施
        • AWS SAML 实施
        • Duo SAML 实施
        • Google SAML 实施
        • JumpCloud SAML 实施
        • Keycloak SAML 实施
        • Microsoft Entra ID SAML 实施
        • Okta SAML 实施
        • OneLogin SAML 实施
        • Ping Identity SAML 实施
        • ADFS OIDC 实施
        • Microsoft Entra ID OIDC 实施
        • Okta OIDC 实施
        • Ping Identity OIDC 实施
        • Cloudflare Zero Trust SSO 实施
      • 受信任设备
        • 关于受信任设备
        • 设置受信任设备 SSO
        • 添加受信任设备
        • 批准受信任设备
      • Key Connector
        • 关于 Key Connector
        • 部署 Key Connector
      • *在您的 IdP 上配置 Bitwarden(SAML 2.0)
      • SSO 登录 FAQ
    • 报告
      • 密码库健康报告
      • 事件日志
      • Elastic SIEM
      • Microsoft Sentinel SIEM
      • Panther SIEM
      • Rapid7 SIEM
      • Splunk SIEM
    • 最终用户入职
      • 关于本章节
      • 欢迎电子邮件模板
      • 管理团队入职电子邮件
      • 最终用户采用电子邮件
      • 客户激活套件
      • 入职流程
    • 部署客户端 App
      • 部署浏览器扩展
        • 使用 GPO、Linux 策略和 .plist 文件部署浏览器扩展
        • 使用 Intune 部署浏览器扩展
      • 部署桌面端 App
        • 使用 Intune 部署桌面端 App
      • 部署移动端 App
        • 使用 Intune 部署移动端 App
      • 为您的服务器配置客户端
      • 使用设备管理停用浏览器密码管理器
    • Bitwarden 公共 API
    • 更多
      • 组织 FAQ
      • 链接到项目
      • 企业版 Bitwarden 功能数据表
      • 团队版和企业版迁移指南
      • LastPass 企业版迁移指南
      • 组织所有者离职时的访问权限管理
      • PoC 项目清单
      • 为生产准备试用组织
      • *团队版 Bitwarden 对比指南
  • 提供商门户
    • 提供商门户概览
    • 提供商门户快速入门
    • 提供商用户
    • 添加客户组织
    • *添加现有组织
    • 持续管理
    • 取消链接客户组织
    • 提供商事件日志
    • 提供商计费
    • 提供商 FAQ
    • 业务单元门户
      • 业务单元门户
      • 业务单元门户快速入门
  • 自托管
    • 安装 & 部署指南
      • Docker
        • Linux 标准部署
        • Linux 手动部署
        • Linux 离线部署
        • Windows 标准部署
        • Windows 离线部署
        • Unified 部署 (Beta)
      • Helm
        • 使用 Helm 自托管
        • Azure AKS 部署
        • OpenShift 部署
        • AWS EKS 部署
        • 添加 rawManifest 文件
    • 自托管组织
    • 迁移步骤
    • 证书选项
    • 配置环境变量
    • 数据库选项
    • 连接到外部 MSSQL 数据库
    • Kerberos 集成
    • 更新实例
    • 备份托管数据
    • 付费功能许可证
    • 系统管理员门户
    • 为服务器配置客户端
    • 连接客户端到实例
    • 自托管 SCIM
    • 自托管家庭赞助
    • 自托管 Send
    • 配置推送中继
    • *作为 MSP 部署 Bitwarden
    • 托管 FAQ
  • 安全
    • Bitwarden 安全白皮书
    • 密码库数据
    • 管理数据
    • 加密方式
    • KDF 算法
    • 账户加密密钥
    • 账户指纹短语
    • 数据存储
    • 合规、审计和认证
    • 服务器地理位置
    • 版本控制
    • 使用网站图标时的隐私
    • Bitwarden 软件发布支持
    • Bitwarden 的分包商
    • 来自 Bitwarden 的电子邮件
    • Bitwarden 地址
    • 安全 FAQ
  • 计划和定价
    • Password Manager
      • Password Manager 计划
      • 从个人升级到组织
      • 兑换家庭赞助
      • 高级会员续费
    • Secrets Manager
      • Secrets Manager 计划
      • 注册 Secrets Manager
    • Bitwarden 经销商
    • 开始企业版试用
    • 组织续费
    • 更新计费信息
    • 税费计算
    • 删除账户或组织
    • 取消订阅
    • 计费 FAQ
    • *更新 Bitwarden 计划 (2019-2020)
    • *更新 Password Manager 计划 & 订阅
    • *哪种计划适合我?
  • 学习中心
    • 关于学习中心
    • 使用 Bitwarden 的第一步
    • 了解 Password Manager
    • Password Manager
      • Bitwarden 入门:个人用户
      • Bitwarden 入门:管理员
      • Bitwarden 入门:成员
      • Bitwarden 入门:经销商或 MSP
    • Bitwarden 高级用户
    • 面向企业管理员的 Bitwarden
    • 了解 Secrets Manager
    • 面向 MSP 的 Bitwarden
    • 了解 Passwordless.dev
  • *杂项
    • 11 月弃用通知
    • Bitwarden 术语表
    • 迁移脚本
    • Bitwarden 101 视频系列-入门
    • Secrets Manager Beta 版注册
    • 未分配的密码库项目已移至管理控制台
    • 原生移动 App
  • 附录
    • 翻译约定
    • 资源
由 GitBook 提供支持
在本页
  • send
  • create
  • get
  • edit
  • list
  • delete
  • template
  • receive
  1. Password Manager
  2. Bitwarden Send

CLI 上的 Send

上一页Send 隐私下一页Send 加密

最后更新于1个月前

对应的

[译者注]:

  • stdout:标准输出

  • stdin:标准输入

  • stderr:标准错误输出

stdout 和 stderr 默认都是输出到终端(屏幕)。

Bitwarden Send 是一套功能齐全的 CLI 命令。本文介绍了 bw send 命令的范围,但是 Send 并不是一个独立于 Bitwarden 命令行界面 (CLI) b的工具。因此,中的许多命令、选项和概念与这里的都是相关联的。

send

send 命令是用于访问所有与 Send 相关的子命令的主命令:

bw send [options] [command] <data>

send 命令还可以作为快速 create 一个 Send 的快捷方式,例如:

bw send "Fastest Send in the West."

将创建一个内容为 Fastest Send in the West 的文本 Send 对象并输出 Send 链接。或者,例如:

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

将创建一个具有在指定 path 下的文件的文件 Send 对象并输出 Send 链接。

选项:

  • -n <name> 或 --name <name> 用于指定 Send 的名称。如果没有指定名称,对于文本 Send,名称默认为 id,对于文件 Send,默认为文件名。对于多个字的名称,使用引号 "<name>"。

  • -d <days> 或 --deleteInDays <days> 用于指定 Send 的删除日期(如果没有指定,默认为 7 天)。

  • --notes <notes> 用于添加私密备注到 Send 中。对于多个字的备注,使用引号 "<notes>"。

  • --fullObject 用于将完整的 Send 对象输出为 JSON,而不是只输出 Send 链接(将此选项与 --pretty 选项配对使用,以获得格式化的 JSON)。

完整的示例:

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

create

create 命令用于创建一个 Send。与仅使用 bw send 相比,create 允许进行更高级的配置,接受已编码的 JSON 作为其参数:

bw send create [options] <encodedJson>

一个典型的工作流程大致像这样:

  1. 使用 create 命令从编码后的 JSON 创建一个 Send。

例如,要创建一个文本 Send:

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

例如,要创建一个文件 Send:

bw send template send.file | jq '.name="My File Send" | .type=1 | .file.fileName="paperwork.png" | .password="p@ssw0rd"' | bw encode | bw send create
$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

注意在此示例中,于在 Send 中配置了 .deletionDate 嵌套的 date 变量,因此 jq 调用必须使用双引号(" ")进行包裹,并对每个筛选器使用转义符(\)。

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

注意在此示例中,于在 Send 中配置了 .deletionDate 嵌套的 date 变量,因此 jq 调用必须使用双引号(" ")进行包裹,并对每个筛选器使用转义符(\)。

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

注意在此示例中,于在 Send 中配置了 .deletionDate 嵌套的 date 变量,因此 jq 调用必须使用双引号(" ")进行包裹,并对每个筛选器使用转义符(\)。

选项:

  • --file <path> 用于指定 Send 的文件(也可以在已编码的 JSON 中指定)。

  • --text <text> 用于指定 Send 的文本(也可以在已编码的 JSON 中指定)。

  • --fullObject 用于将完整的 Send 对象输出为 JSON,而不是只输出 Send 链接(将此选项与 --pretty 选项配对使用,以获得格式化的 JSON)。

get

get 命令用于检索您拥有的 Send 并将其作为 JSON 对象输出。get 接受一个确切的 id 值或任何字符串作为其参数。如果使用字符串,get 将会在您的 Send 中搜索一个与之匹配的值:

bw send get [options] <id / string>

选项:

  • --text 用于只输出文本 Send 的文本内容。

  • --file 用于只输出文件 Send 的文件内容。将 --file 与 --output 搭配使用,用于指定一个目录,或者与 --raw 搭配使用,用于输出到 stdout。

  • --output <output> 用于为 --file 选项指定输出目录。

edit

edit 命令用于编辑一个现有的 Send 对象。edit 接受已编码的 JSON 作为其参数:

bw send edit <encodedJson>

一个典型的工作流程大致像这样:

  1. 使用 create 命令从编码后的 JSON 创建一个 Send。

示例:

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

选项:

  • --itemid <itemid> 用一个新的 id 值覆盖 Send 提供的 id 值。

您不能 edit 一个文件 Send 的文件。要这样做,您需要删除此 Send 然后使用适当的文件重新创建它。

list

list 命令用于列出您拥有的所有 Send 并将其作为 JSON 输出:

bw send list [options]

选项:

  • --pretty 用于格式化输出的 JSON。

  • > 运算符用于使用管道将 stdout 传输到文件,例如:

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

delete

delete 命令用于删除您所拥有的一个 Send。delete 命令接受一个精确的 id 值作为其参数:

bw send delete <id>

如果您不知道要删除的 Send 的确切 id,请使用 bw send get <search term> 进行查找。

template

template 命令用于返回一个 Send 对象的预期 JSON 格式,template 接受一个 <object> 规格作为其参数,可以是 send.text 或 send.file:

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

receive

receive 命令用于访问 Send。receive 接受 Send <url> 作为其参数:

bw send receive [options] <url>
  • 对于文本 Send,receive 将返回 Send 的文本内容到 stdout。

  • 对于文件 Send,receive 将文件下载到当前工作目录。

选项:

  • --password <password> 用于提供一个字符串作为访问受密码保护的 Send 所需的密码。

  • --passwordenv <passwordenv> 用于指定一个已存储的环境变量作为访问受密码保护的 Send 所需的密码。

  • --passwordfile <passwordfile> 用于指定文件的第一行作为访问受密码保护的 Send 所需的密码。

  • --obj 用于将完整的 Send 对象输出为 JSON,而不是只输出 Send 链接(将此选项与 --pretty 选项配对使用,以获得格式化的 JSON)。

  • --ouput <output> 用于指定文件 Send 内容的输出目录。

--hidden 用于指定文本 Send 要求接收者。

使用 template 命令(参阅)为您的 Send 类型输出合适的 JSON 模板。

使用,根据需要处理输出的模板。

使用 encode 命令(参阅)对处理后的 JSON 进行编码。

例如,要创建一个有密码保护的文件 Send,并带有明确的。不同的操作系统,对于指定 .deletionDate= 的方式不一样:

--hidden 用于指定文本 Send 要求接收者。

--password <password> 用于指定访问的密码。

如果你在另一个 Bitwarden 应用程序中创建了一个 Send,而这个会话仍然处于活动状态,使用 bw sync 命令将提取最近的 Send。有关更多信息,请参阅我们的 。

使用 get 命令(参阅)来根据 <id> 检索所需的 Send。

使用,来根据需要处理检索到的 Send。

使用 encode 命令(参阅)对处理后的 JSON 进行编码。

如果你在另一个 Bitwarden 应用程序中创建了一个 Send,而这个会话仍然处于活动状态,使用 bw sync 命令将提取最近的 Send。有关更多信息,请参阅我们的 。

虽然你可以使用 template 将格式输出到你的屏幕上,但最常见的使用范例是将输出的内容用管道输送到 bw send create 操作中,使用和 bw encode 来操作从模板中检索的值,例如:

像 jq 这样的命令行 JSON 处理器
CLI 文档
像 jq 这样的命令行JSON处理器
CLI 文档
像 jq 这样的命令行 JSON 处理器
详情
详情
官方文档地址
参考链接
CLI 文档
删除日期
详情
详情
切换可见性
切换可见性
密码保护