Azure / Azure/azure-powershell
Import-AzAutomationRunbook : More detail for -LogPrgress and -LogVerbose
- Dominant language
- C#
- Stars
- 4.8k
- Forks
- 4.3k
- Avg merge
- 3d 14h
- Merged PRs (30d)
- 54
Description
The descriptions for the -LogPrgress and -LogVerbose switches on the **Import-AzAutomationRunbook** documentation page [here](https://docs.microsoft.com/en-us/powershell/module/az.automation/import-azautomationrunbook?view=azps-3.2.0) provides no detail as to what these values are for. They are not switches to show the progress of the import action. What exactly these switches for??
These properties are also returned by the **get-AzAutomationRunbook** cmdlet so they are persistent settings. The documentation [here](https://docs.microsoft.com/en-us/dotnet/api/microsoft.azure.commands.automation.model.runbook?view=azurerm-ps) isn't any better.
However, I do believe the needed information could be extracted from here:
https://docs.microsoft.com/en-us/azure/automation/automation-runbook-output-and-messages
Contributor guide
Research direction
Start with the Import-AzAutomationRunbook documentation page and the linked Azure Automation runbook output and messages article. Clarify what -LogProgress and -LogVerbose control, noting that they are persistent runbook settings rather than import-progress switches, and check the Get-AzAutomationRunbook and Runbook documentation for consistent wording. Done means both cmdlet descriptions explain the settings accurately.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- azure, powershell
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Activity status
- Quiet
- Clarity
- Mostly clear
- Newbie friendliness
- 63/100