azcmagent 配置

配置 Azure Connected Machine 代理的设置。 配置存储在本地,对每台计算机是唯一的。 可用的配置属性根据代理版本而异。 使用 azcmagent config info 查看当前安装的代理的所有可用配置属性和支持的值。

命令

Command 目的
azcmagent config clear 清除配置属性的值
azcmagent config get 获取配置属性的值
azcmagent config info 描述所有可用配置属性和支持的值
azcmagent config list 列出所有配置属性和值
azcmagent config set 设置配置属性的值

azcmagent config clear

清除配置属性的值并将其重置为默认状态。

使用情况

azcmagent config clear [property] [flags]

示例

清除代理服务器 URL 属性。

azcmagent config clear proxy.url

Flags

适用于所有命令的通用标志

--config

接受包含命令输入的 JSON 或 YAML 文件的路径。 配置文件应包含一系列键值对,其中键与可用的命令行选项匹配。 例如,若要传入 --verbose 标志,配置文件将如下所示:

{
    "verbose": true
}

如果在命令调用和配置文件中找到命令行选项,则命令行中指定的值优先。

-h--help

获取有关当前命令的帮助,包括其语法和命令行选项。

-j--json

以 JSON 格式输出命令结果。

--log-stderr

将错误和详细消息重定向到标准错误 (stderr) 流。 默认情况下,所有输出都发送到标准输出 (stdout) 流。

--no-color

禁用不支持 ANSI 颜色的终端的颜色输出。

-v--verbose

在执行命令时显示更详细的日志记录信息。 用于排查运行命令时出现的问题。

azcmagent config get

获取配置属性的值。

使用情况

azcmagent config get [property] [flags]

示例

获取代理模式。

azcmagent config get config.mode

Flags

适用于所有命令的通用标志

--config

接受包含命令输入的 JSON 或 YAML 文件的路径。 配置文件应包含一系列键值对,其中键与可用的命令行选项匹配。 例如,若要传入 --verbose 标志,配置文件将如下所示:

{
    "verbose": true
}

如果在命令调用和配置文件中找到命令行选项,则命令行中指定的值优先。

-h--help

获取有关当前命令的帮助,包括其语法和命令行选项。

-j--json

以 JSON 格式输出命令结果。

--log-stderr

将错误和详细消息重定向到标准错误 (stderr) 流。 默认情况下,所有输出都发送到标准输出 (stdout) 流。

--no-color

禁用不支持 ANSI 颜色的终端的颜色输出。

-v--verbose

在执行命令时显示更详细的日志记录信息。 用于排查运行命令时出现的问题。

azcmagent config info

描述可用配置属性和支持的值。 如果在不指定特定属性的情况下运行,该命令将描述所有可用属性及其支持的值。

使用情况

azcmagent config info [property] [flags]

示例

描述所有可用配置属性和支持的值。

azcmagent config info

详细了解扩展允许列表属性及其支持的值。

azcmagent config info extensions.allowlist

Flags

适用于所有命令的通用标志

--config

接受包含命令输入的 JSON 或 YAML 文件的路径。 配置文件应包含一系列键值对,其中键与可用的命令行选项匹配。 例如,若要传入 --verbose 标志,配置文件将如下所示:

{
    "verbose": true
}

如果在命令调用和配置文件中找到命令行选项,则命令行中指定的值优先。

-h--help

获取有关当前命令的帮助,包括其语法和命令行选项。

-j--json

以 JSON 格式输出命令结果。

--log-stderr

将错误和详细消息重定向到标准错误 (stderr) 流。 默认情况下,所有输出都发送到标准输出 (stdout) 流。

--no-color

禁用不支持 ANSI 颜色的终端的颜色输出。

-v--verbose

在执行命令时显示更详细的日志记录信息。 用于排查运行命令时出现的问题。

azcmagent config list

列出所有配置属性及其当前值

使用情况

azcmagent config list [flags]

示例

列出当前代理配置。

azcmagent config list

Flags

适用于所有命令的通用标志

--config

接受包含命令输入的 JSON 或 YAML 文件的路径。 配置文件应包含一系列键值对,其中键与可用的命令行选项匹配。 例如,若要传入 --verbose 标志,配置文件将如下所示:

{
    "verbose": true
}

如果在命令调用和配置文件中找到命令行选项,则命令行中指定的值优先。

-h--help

获取有关当前命令的帮助,包括其语法和命令行选项。

-j--json

以 JSON 格式输出命令结果。

--log-stderr

将错误和详细消息重定向到标准错误 (stderr) 流。 默认情况下,所有输出都发送到标准输出 (stdout) 流。

--no-color

禁用不支持 ANSI 颜色的终端的颜色输出。

-v--verbose

在执行命令时显示更详细的日志记录信息。 用于排查运行命令时出现的问题。

azcmagent config set

设置配置属性的值。

使用情况

azcmagent config set [property] [value] [flags]

示例

将代理配置为使用代理服务器。

azcmagent config set proxy.url "http://proxy.contoso.corp:8080"

将扩展追加到扩展允许列表。

azcmagent config set extensions.allowlist "Microsoft.Azure.Monitor/AzureMonitorWindowsAgent" --add

Flags

-a--add

将值追加到现有值列表。 如果未指定,则默认行为是替换现有值的列表。 只有支持多个值的配置属性才支持此标志。 不能与 --remove 标志一起使用。

-r--remove

从列表中删除指定的值,并保留所有其他值。 如果未指定,则默认行为是替换现有值的列表。 只有支持多个值的配置属性才支持此标志。 不能与 --add 标志结合使用。

适用于所有命令的通用标志

--config

接受包含命令输入的 JSON 或 YAML 文件的路径。 配置文件应包含一系列键值对,其中键与可用的命令行选项匹配。 例如,若要传入 --verbose 标志,配置文件将如下所示:

{
    "verbose": true
}

如果在命令调用和配置文件中找到命令行选项,则命令行中指定的值优先。

-h--help

获取有关当前命令的帮助,包括其语法和命令行选项。

-j--json

以 JSON 格式输出命令结果。

--log-stderr

将错误和详细消息重定向到标准错误 (stderr) 流。 默认情况下,所有输出都发送到标准输出 (stdout) 流。

--no-color

禁用不支持 ANSI 颜色的终端的颜色输出。

-v--verbose

在执行命令时显示更详细的日志记录信息。 用于排查运行命令时出现的问题。