azcmagent extension
Local management of Azure Arc extensions installed on the machine. These commands can be run even when a machine is in a disconnected state.
The extension manager must be stopped before running any of these commands. Stopping the extension manager interrupts any in-progress extension installs, upgrades, and removals. To disable the extension manager, run Stop-Service ExtensionService on Windows or systemctl stop extd. When you're done managing extensions locally, start the extension manager again with Start-Service ExtensionService on Windows or systemctl start extd on Linux.
Commands
| Command | Purpose |
|---|---|
| azcmagent extension list | Lists extensions installed on the machine |
| azcmagent extension remove | Uninstalls extensions on the machine |
azcmagent extension list
Lists extensions installed on the machine.
Usage
azcmagent extension list [flags]
Examples
See which extensions are installed on your machine.
azcmagent extension list
Flags
Common flags available for all commands
--config
Takes in a path to a JSON or YAML file containing inputs to the command. The configuration file should contain a series of key-value pairs where the key matches an available command line option. For example, to pass in the --verbose flag, the configuration file would look like:
{
"verbose": true
}
If a command line option is found in both the command invocation and a configuration file, the value specified on the command line will take precedence.
-h, --help
Get help for the current command, including its syntax and command line options.
-j, --json
Output the command result in the JSON format.
--log-stderr
Redirect error and verbose messages to the standard error (stderr) stream. By default, all output is sent to the standard output (stdout) stream.
--no-color
Disable color output for terminals that do not support ANSI colors.
-v, --verbose
Show more detailed logging information while the command executes. Useful for troubleshooting issues when running a command.
azcmagent extension remove
Uninstalls extensions on the machine.
Usage
azcmagent extension remove [flags]
Examples
Remove the "AzureMonitorWindowsAgent" extension from the local machine.
azcmagent extension remove --name AzureMonitorWindowsAgent
Remove all extensions from the local machine.
azcmagent extension remove --all
Flags
--all, -a
Removes all extensions from the machine.
--name, -n
Removes the specified extension from the machine. Use azcmagent extension list to get the name of the extension.
Common flags available for all commands
--config
Takes in a path to a JSON or YAML file containing inputs to the command. The configuration file should contain a series of key-value pairs where the key matches an available command line option. For example, to pass in the --verbose flag, the configuration file would look like:
{
"verbose": true
}
If a command line option is found in both the command invocation and a configuration file, the value specified on the command line will take precedence.
-h, --help
Get help for the current command, including its syntax and command line options.
-j, --json
Output the command result in the JSON format.
--log-stderr
Redirect error and verbose messages to the standard error (stderr) stream. By default, all output is sent to the standard output (stdout) stream.
--no-color
Disable color output for terminals that do not support ANSI colors.
-v, --verbose
Show more detailed logging information while the command executes. Useful for troubleshooting issues when running a command.