Description requires more clarification

[basimolimajeed]

Type of issue

Other (describe below)

Feedback

The description of the New-AzConnectedMachineExtension command states : The operation to create or update the extension. This is not clear and makes the command seem exactly like the Update and Set versions (I have raised an issue also on the Update command). The New-AzConnectedMachineExtension should be used only to install the extension if it does not exist or to install a different version of the extension. For example if I try to use it to "update" the "EnableAutomaticUpgrade" of the AMA extension then it will not do that (and even worse it will not raise an error to indicate that) see screenshot below:

So the description of the command should be clarified so that users do not attempt to change a property like the "EnableAutomaticUpgrade" while keeping the same version of the extension.

Page URL

https://learn.microsoft.com/en-us/powershell/module/az.connectedmachine/new-azconnectedmachineextension?view=azps-11.1.0

Content source URL

https://github.com/Azure/azure-powershell/blob/main/src/ConnectedMachine/ConnectedMachine/help/New-AzConnectedMachineExtension.md

Author

@mikefrobbins

Document Id

ad0e9468-3ca2-daa8-561e-6bfd3368c44b

[wyunchi-ms]

@Alex-wdy please help to loop to service team

[microsoft-github-policy-service[bot]]

Thanks for the feedback! We are routing this to the appropriate team for follow-up. cc @rpsqrd, @edyoung.

[yaotongms]

Description of this command will get fixed in the next release.

[yaotongms]

I updated the command description so now it only suggests user to create a new extension via New-AzConnectedMachineExtension