From e9e965effddd613f262bce8e754b56d86786339d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=B0=8F=E5=BC=9F=E8=B0=83=E8=B0=83?=
 <kennyiseeyou@gmail.com>
Date: Sun, 8 Oct 2023 11:58:19 -0500
Subject: [PATCH] doc: Update pkexec.md (#529)

---
 command/pkexec.md | 43 +++++++++++++++++++++++++++++++++++++++----
 1 file changed, 39 insertions(+), 4 deletions(-)

diff --git a/command/pkexec.md b/command/pkexec.md
index a36a150595..ec7ad702fe 100644
--- a/command/pkexec.md
+++ b/command/pkexec.md
@@ -1,6 +1,7 @@
 pkexec
 ===
-以另一个用户身份执行命令
+
+以其他用户身份执行命令
 
 ## 补充说明
 
@@ -12,7 +13,6 @@ PROGRAM，则将运行默认 shell。如果未指定用户名，则程序将以
 
 ```shell
 pkexec [--version] [--disable-internal-agent] [--help]
-
 pkexec [--keep-cwd] [--user username] PROGRAM [ARGUMENTS...]
 ```
 
@@ -33,9 +33,44 @@ ARGUMENTS... 传递给程序的参数
 
 成功完成后，返回值为 PROGRAM 的返回值。
 
-127: 在未获得授权或者身份验证发生错误
+- `127`: 在未获得授权或者身份验证发生错误
+- `126`: 用户关闭身份验证对话框而无法获得授权
 
-126: 用户关闭身份验证对话框而无法获得授权
+### 示例
+
+1. 运行具有管理员权限的命令：
+
+```
+pkexec command
+```
+
+将 `command` 替换为你要以管理员权限运行的命令。例如，`pkexec ls` 将以管理员权限运行 `ls` 命令。
+
+2. 以图形界面运行具有管理员权限的命令：
+
+```
+pkexec env DISPLAY=$DISPLAY XAUTHORITY=$XAUTHORITY command
+```
+
+这个命令用于在图形界面中运行需要管理员权限的命令。将 `command` 替换为你要以管理员权限运行的命令。
+
+3. 运行具有特定身份验证代理的命令：
+
+```
+pkexec --user username command
+```
+
+将 `username` 替换为你要作为哪个用户运行命令的用户名，将 `command` 替换为你要运行的命令。
+
+4. 查看 `pkexec` 的帮助信息：
+
+```
+pkexec --help
+```
+
+这个命令将显示 `pkexec` 的使用说明和选项列表。
+
+请注意，使用 `pkexec` 运行命令时，系统会提示你输入管理员密码进行身份验证。确保只在必要时使用 `pkexec` 来运行需要管理员权限的命令，并小心谨慎地处理管理员权限。
 
 ### 参考资料