Skip to content

Commit 5b72ebf

Browse files
committed
fixed blocking issues
1 parent 00a3ebd commit 5b72ebf

File tree

1 file changed

+22
-22
lines changed

1 file changed

+22
-22
lines changed

articles/automation/automation-runbook-types.md

Lines changed: 22 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -40,7 +40,7 @@ The same Azure sandbox and Hybrid Runbook Worker can execute **PowerShell 5.1**
4040
4141
Ensure that you select the right Runtime Version for modules.
4242

43-
For example : if you are executing a runbook for a SharePoint automation scenario in **Runtime version** *7.1 (preview)*, then import the module in **Runtime version** **7.1 (preview)**; if you are executing a runbook for a SharePoint automation scenario in **Runtime version** **5.1**, then import the module in **Runtime version** *5.1*. In this case, you would see two entries for the module, one for **Runtime Version** **7.1(preview)** and other for **5.1**.
43+
For example: if you're executing a runbook for a SharePoint automation scenario in **Runtime version** *7.1 (preview)*, then import the module in **Runtime version** **7.1 (preview)**; if you're executing a runbook for a SharePoint automation scenario in **Runtime version** **5.1**, then import the module in **Runtime version** *5.1*. In this case, you would see two entries for the module, one for **Runtime Version** **7.1(preview)** and other for **5.1**.
4444

4545
:::image type="content" source="./media/automation-runbook-types/runbook-types.png" alt-text="runbook Types.":::
4646

@@ -65,7 +65,7 @@ The following are the current limitations and known issues with PowerShell runbo
6565
- Runbooks can't use [parallel processing](automation-powershell-workflow.md#use-parallel-processing) to execute multiple actions in parallel.
6666
- Runbooks can't use [checkpoints](automation-powershell-workflow.md#use-checkpoints-in-a-workflow) to resume runbook if there's an error.
6767
- You can include only PowerShell, PowerShell Workflow runbooks, and graphical runbooks as child runbooks by using the [Start-AzAutomationRunbook](/powershell/module/az.automation/start-azautomationrunbook) cmdlet, which creates a new job.
68-
- Runbooks can't use the PowerShell [#Requires](/powershell/module/microsoft.powershell.core/about/about_requires) statement, it is not supported in Azure sandbox or on Hybrid Runbook Workers and might cause the job to fail.
68+
- Runbooks can't use the PowerShell [#Requires](/powershell/module/microsoft.powershell.core/about/about_requires) statement, it isn't supported in Azure sandbox or on Hybrid Runbook Workers and might cause the job to fail.
6969

7070
**Known issues**
7171

@@ -80,19 +80,19 @@ The following are the current limitations and known issues with PowerShell runbo
8080
**Limitations**
8181

8282
- You must be familiar with PowerShell scripting.
83-
- The Azure Automation internal PowerShell cmdlets are not supported on a Linux Hybrid Runbook Worker. You must import the `automationassets` module at the beginning of your Python runbook to access the Automation account shared resources (assets) functions.
84-
- For the PowerShell 7 runtime version, the module activities are not extracted for the imported modules.
85-
- *PSCredential* runbook parameter type is not supported in PowerShell 7 runtime version.
86-
- PowerShell 7.x does not support workflows. See [this](/powershell/scripting/whats-new/differences-from-windows-powershell#powershell-workflow) for more details.
87-
- PowerShell 7.x currently does not support signed runbooks.
83+
- The Azure Automation internal PowerShell cmdlets aren't supported on a Linux Hybrid Runbook Worker. You must import the `automationassets` module at the beginning of your Python runbook to access the Automation account shared resources (assets) functions.
84+
- For the PowerShell 7 runtime version, the module activities aren't extracted for the imported modules.
85+
- *PSCredential* runbook parameter type isn't supported in PowerShell 7 runtime version.
86+
- PowerShell 7.x doesn't support workflows. See [this](/powershell/scripting/whats-new/differences-from-windows-powershell#powershell-workflow) for more details.
87+
- PowerShell 7.x currently doesn't support signed runbooks.
8888
- Source control integration doesn't support PowerShell 7.1 (preview) Also, PowerShell 7.1 (preview) runbooks in source control gets created in Automation account as Runtime 5.1.
89-
- PowerShell 7.1 module management is not supported through `Get-AzAutomationModule` cmdlets.
89+
- PowerShell 7.1 module management isn't supported through `Get-AzAutomationModule` cmdlets.
9090
- Runbook will fail with no log trace if the input value contains the character '.
9191

9292

9393
**Known issues**
9494

95-
- Executing child scripts using `.\child-runbook.ps1` is not supported in this preview.
95+
- Executing child scripts using `.\child-runbook.ps1` isn't supported in this preview.
9696
**Workaround**: Use `Start-AutomationRunbook` (internal cmdlet) or `Start-AzAutomationRunbook` (from *Az.Automation* module) to start another runbook from parent runbook.
9797
- Runbook properties defining logging preference is not supported in PowerShell 7 runtime.
9898
**Workaround**: Explicitly set the preference at the start of the runbook as below -
@@ -103,7 +103,7 @@ The following are the current limitations and known issues with PowerShell runbo
103103
```
104104
- Avoid importing `Az.Accounts` module to version 2.4.0 version for PowerShell 7 runtime as there can be an unexpected behavior using this version in Azure Automation.
105105
- You might encounter formatting problems with error output streams for the job running in PowerShell 7 runtime.
106-
- When you import a PowerShell 7.1 module that's dependent on other modules, you may find that the import button is gray even when PowerShell 7.1 version of the dependent module is installed. For example, Az.Compute version 4.20.0, has a dependency on Az.Accounts being >= 2.6.0. This issue occurs when an equivalent dependent module in PowerShell 5.1 doesn't meet the version requirements. For example, 5.1 version of Az.Accounts was < 2.6.0.
106+
- When you import a PowerShell 7.1 module that's dependent on other modules, you may find that the import button is gray even when PowerShell 7.1 version of the dependent module is installed. For example, Az.Compute version 4.20.0, has a dependency on Az.Accounts being >= 2.6.0. This issue occurs when an equivalent dependent module in PowerShell 5.1 doesn't meet the version requirements. For example, 5.1 version of Az.Accounts were < 2.6.0.
107107
- When you start PowerShell 7 runbook using the webhook, it auto-converts the webhook input parameter to an invalid JSON.
108108

109109

@@ -115,14 +115,14 @@ The following are the current limitations and known issues with PowerShell runbo
115115
> Currently, PowerShell 7.2 (preview) runtime version is supported for both Cloud and Hybrid jobs in all Public regions except Australia Central2, Korea South, Sweden South, Jio India Central, Brazil Southeast, Central India, West India, UAE Central, and Gov clouds.
116116
117117
- You must be familiar with PowerShell scripting.
118-
- For the PowerShell 7 runtime version, the module activities are not extracted for the imported modules.
119-
- *PSCredential* runbook parameter type is not supported in PowerShell 7 runtime version.
120-
- PowerShell 7.x does not support workflows. See [this](/powershell/scripting/whats-new/differences-from-windows-powershell#powershell-workflow) for more details.
121-
- PowerShell 7.x currently does not support signed runbooks.
122-
- Source control integration doesn't support PowerShell 7.2 (preview). Also, PowerShell 7.2 (preview) runbooks in source control gets created in Automation account as Runtime 5.1.
118+
- For the PowerShell 7 runtime version, the module activities aren't extracted for the imported modules.
119+
- *PSCredential* runbook parameter type isn't supported in PowerShell 7 runtime version.
120+
- PowerShell 7.x doesn't support workflows. See [this](/powershell/scripting/whats-new/differences-from-windows-powershell#powershell-workflow) for more details.
121+
- PowerShell 7.x currently doesn't support signed runbooks.
122+
- Source control integration doesn't support PowerShell 7.2 (preview). Also, PowerShell 7.2 (preview) runbooks in source control get created in Automation account as Runtime 5.1.
123123
- Logging job operations to the Log Analytics workspace through linked workspace or diagnostics settings are not supported.
124-
- Currently, PowerShell 7.2 (preview) runbooks are only supported from Azure portal. Rest API and PowerShell is not supported.
125-
- Az module 8.3.0 is installed by default and cannot be managed at the automation account level. Use custom modules to override the Az module to the desired version.
124+
- Currently, PowerShell 7.2 (preview) runbooks are only supported from Azure portal. Rest API and PowerShell isn't supported.
125+
- Az module 8.3.0 is installed by default and can't be managed at the automation account level. Use custom modules to override the Az module to the desired version.
126126
- The imported PowerShell 7.2 (preview) module would be validated during job execution. Ensure that all dependencies for the selected module are also imported for successful job execution.
127127
- PowerShell 7.2 module management is not supported through `Get-AzAutomationModule` cmdlets.
128128

@@ -187,7 +187,7 @@ Following are the limitations of Python runbooks
187187
# [Python 2.7](#tab/py27)
188188

189189
- You must be familiar with Python scripting.
190-
- For Python 2.7.12 modules use wheel files cp27-amd6.
190+
- For Python 2.7.12 modules, use wheel files cp27-amd6.
191191
- To use third-party libraries, you must [import the packages](python-packages.md) into the Automation account.
192192
- Azure Automation doesn't support **sys.stderr**.
193193
- The Python **automationassets** package is not available on pypi.org, so it's not available for import onto a Windows machine.
@@ -200,21 +200,21 @@ Following are the limitations of Python runbooks
200200
- To use third-party libraries, you must [import the packages](python-packages.md) into the Automation account.
201201
- Using **Start-AutomationRunbook** cmdlet in PowerShell/PowerShell Workflow to start a Python 3.8 (preview) runbook (preview) doesn't work. You can use **Start-AzAutomationRunbook** cmdlet from Az.Automation module or **Start-AzureRmAutomationRunbook** cmdlet from AzureRm.Automation module to work around this limitation. 
202202
- Azure Automation doesn't support **sys.stderr**.
203-
- The Python **automationassets** package is not available on pypi.org, so it's not available for import onto a Windows machine.
203+
- The Python **automationassets** package isn't available on pypi.org, so it's not available for import onto a Windows machine.
204204

205205
# [Python 3.10 (preview)](#tab/py10)
206206

207207
**Limitations**
208208

209209
- For Python 3.10 (preview) modules, currently, only the wheel files targeting cp310 Linux OS are supported. [Learn more](./python-3-packages.md).
210-
- Custom packages for Python 3.10 (preview) are only validated during job runtime. Job is expected to fail if the package is not compatible in the runtime or if required dependencies of packages are not imported into automation account.
211-
- Currently, Python 3.10 (preview) runbooks are only supported from Azure portal. Rest API and PowerShell is not supported.
210+
- Custom packages for Python 3.10 (preview) are only validated during job runtime. Job is expected to fail if the package is not compatible in the runtime or if necessary dependencies of packages are not imported into automation account.
211+
- Currently, Python 3.10 (preview) runbooks are only supported from Azure portal. Rest API and PowerShell isn't supported.
212212

213213
---
214214

215215
### Multiple Python versions
216216

217-
It is applicable for Windows Hybrid workers. For a Windows Runbook Worker, when running a Python 2 runbook it looks for the environment variable `PYTHON_2_PATH` first and validates whether it points to a valid executable file. For example, if the installation folder is `C:\Python2`, it would check if `C:\Python2\python.exe` is a valid path. If not found, then it looks for the `PATH` environment variable to do a similar check.
217+
It's applicable for Windows Hybrid workers. For a Windows Runbook Worker, when running a Python 2 runbook it looks for the environment variable `PYTHON_2_PATH` first and validates whether it points to a valid executable file. For example, if the installation folder is `C:\Python2`, it would check if `C:\Python2\python.exe` is a valid path. If not found, then it looks for the `PATH` environment variable to do a similar check.
218218

219219
For Python 3, it looks for the `PYTHON_3_PATH` env variable first and then falls back to the `PATH` environment variable.
220220

0 commit comments

Comments
 (0)