title: "wp post update" post_status: publish comment_status: open taxonomy: category: - wp-cli-handbook post_tag: - Post - Commands - Repos

wp post update

更新一个或多个现有文章。

选项

有关所用语法约定的详细说明，请参阅参数语法参考。

<id>... : 要更新的一个或多个文章 ID。

[--post_author=<post_author>] : 添加文章的用户 ID。默认为当前用户 ID。

[--post_date=<post_date>] : 文章发布日期。默认为当前时间。

[--post_date_gmt=<post_date_gmt>] : 文章在 GMT 时区的发布日期。默认为 $post_date 的值。

[--post_content=<post_content>] : 文章内容。默认为空。

[--post_content_filtered=<post_content_filtered>] : 过滤后的文章内容。默认为空。

[--post_title=<post_title>] : 文章标题。默认为空。

[--post_excerpt=<post_excerpt>] : 文章摘要。默认为空。

[--post_status=<post_status>] : 文章状态。默认为 'draft'。

[--post_type=<post_type>] : 文章类型。默认为 'post'。

[--comment_status=<comment_status>] : 文章是否允许评论。接受 'open' 或 'closed'。默认为 'default_comment_status' 选项的值。

[--ping_status=<ping_status>] : 文章是否允许 ping。接受 'open' 或 'closed'。默认为 'default_ping_status' 选项的值。

[--post_password=<post_password>] : 访问文章的密码。默认为空。

[--post_name=<post_name>] : 文章名称。创建新文章时默认为经过清理的文章标题。

[--to_ping=<to_ping>] : 要 ping 的 URL 列表，以空格或回车分隔。默认为空。

[--pinged=<pinged>] : 已 ping 过的 URL 列表，以空格或回车分隔。默认为空。

[--post_modified=<post_modified>] : 文章最后修改日期。默认为当前时间。

[--post_modified_gmt=<post_modified_gmt>] : 文章在 GMT 时区的最后修改日期。默认为当前时间。

[--post_parent=<post_parent>] : 设置文章所属的父文章 ID（如果有）。默认为 0。

[--menu_order=<menu_order>] : 文章的显示顺序。默认为 0。

[--post_mime_type=<post_mime_type>] : 文章的 MIME 类型。默认为空。

[--guid=<guid>] : 引用文章的全局唯一 ID。默认为空。

[--post_category=<post_category>] : 分类名称、别名或 ID 的数组。默认为 'default_category' 选项的值。

[--tags_input=<tags_input>] : 标签名称、别名或 ID 的数组。默认为空。

[--tax_input=<tax_input>] : 按分类法名称键控的分类法术语数组。默认为空。

[--meta_input=<meta_input>] : 按文章元键键控的文章元值的 JSON 格式数组。默认为空。

[<file>] : 从 <file> 读取文章内容。如果提供了此值，将忽略 --post_content 参数。

将 - 作为文件名传递将使文章内容从 STDIN 读取。

--<field>=<value> : 要更新的一个或多个字段。参见 wp_insert_post()。

[--defer-term-counting] : 批量重新计算分类项数量，以提高性能。

示例

$ wp post update 123 --post_name=something --post_status=draft
成功：已更新文章 123。

# 更新一个包含多个元值的文章。
$ wp post update 123 --meta_input='{"key1":"value1","key2":"value2"}'
成功：已更新文章 123。

# 同时更新多篇文章。
$ wp post update 123 456 --post_author=789
成功：已更新文章 123。
成功：已更新文章 456。

# 同时更新给定文章类型的所有文章。
$ wp post update $(wp post list --post_type=page --format=ids) --post_author=123
成功：已更新文章 123。
成功：已更新文章 456。

GLOBAL PARAMETERS

These global parameters have the same behavior across all commands and affect how WP-CLI interacts with WordPress.