Skip to content

Commit 4b904a2

Browse files
Merge pull request #111975 from BethWilke/branch128
Fixing task 1704208
2 parents a80e0a4 + f978f83 commit 4b904a2

File tree

8 files changed

+117
-35
lines changed

8 files changed

+117
-35
lines changed

articles/automation/TOC.yml

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -68,8 +68,6 @@
6868
items:
6969
- name: Manage modules in Azure Automation
7070
href: shared-resources/modules.md
71-
- name: Az module support in Azure Automation
72-
href: az-modules.md
7371
- name: Update Azure PowerShell modules
7472
href: automation-update-azure-modules.md
7573
- name: Schedules

articles/automation/automation-solution-vm-management.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -114,7 +114,7 @@ All parent runbooks include the `WhatIf` parameter. When set to True, the parame
114114
The following table lists the variables created in your Automation account. Only modify variables prefixed with `External`. Modifying variables prefixed with `Internal` causes undesirable effects.
115115

116116
> [!NOTE]
117-
> Limitations on VM name and resource group are largely a result of variable size.
117+
> Limitations on VM name and resource group are largely a result of variable size. See [Variable assets in Azure Automation](https://docs.microsoft.com/azure/automation/shared-resources/variables).
118118
119119
|Variable | Description|
120120
|---------|------------|
@@ -153,8 +153,8 @@ Don't enable all schedules, because doing so might create overlapping schedule a
153153
|Schedule_AutoStop_CreateAlert_Parent | Every 8 hours | Runs the **AutoStop_CreateAlert_Parent** runbook every 8 hours, which in turn stops the VM-based values in `External_Start_ResourceGroupNames`, `External_Stop_ResourceGroupNames`, and `External_ExcludeVMNames` variables. Alternatively, you can specify a comma-separated list of VMs by using the `VMList` parameter.|
154154
|Scheduled_StopVM | User-defined, daily | Runs the **ScheduledStopStart_Parent** runbook with a parameter of `Stop` every day at the specified time. Automatically stops all VMs that meet the rules defined by variable assets. Enable the related schedule **Scheduled-StartVM**.|
155155
|Scheduled_StartVM | User-defined, daily | Runs the **ScheduledStopStart_Parent** runbook with a parameter value of `Start` every day at the specified time. Automatically starts all VMs that meet the rules defined by variable assets. Enable the related schedule **Scheduled-StopVM**.|
156-
|Sequenced-StopVM | 1:00 AM (UTC), every Friday | Runs the Sequenced_Parent runbook with a parameter value of `Stop` every Friday at the specified time. Sequentially (ascending) stops all VMs with a tag of **SequenceStop** defined by the appropriate variables. For more information on tag values and asset variables, see the Runbooks section. Enable the related schedule, **Sequenced-StartVM**.|
157-
|Sequenced-StartVM | 1:00 PM (UTC), every Monday | Runs the **SequencedStopStart_Parent** runbook with a parameter value of `Start` every Monday at the specified time. Sequentially (descending) starts all VMs with a tag of **SequenceStart** defined by the appropriate variables. For more information on tag values and variable assets, see the [Runbooks](#runbooks). Enable the related schedule, **Sequenced-StopVM**.
156+
|Sequenced-StopVM | 1:00 AM (UTC), every Friday | Runs the **Sequenced_StopStop_Parent** runbook with a parameter value of `Stop` every Friday at the specified time. Sequentially (ascending) stops all VMs with a tag of **SequenceStop** defined by the appropriate variables. For more information on tag values and asset variables, see [Runbooks](#runbooks). Enable the related schedule, **Sequenced-StartVM**.|
157+
|Sequenced-StartVM | 1:00 PM (UTC), every Monday | Runs the **SequencedStopStart_Parent** runbook with a parameter value of `Start` every Monday at the specified time. Sequentially (descending) starts all VMs with a tag of **SequenceStart** defined by the appropriate variables. For more information on tag values and variable assets, see [Runbooks](#runbooks). Enable the related schedule, **Sequenced-StopVM**.
158158

159159
## Use of the solution with classic VMs
160160

45.5 KB
Loading
37.7 KB
Loading

articles/automation/shared-resources/credentials.md

Lines changed: 10 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Credential assets in Azure Automation
2+
title: Manage credential assets in Azure Automation
33
description: Credential assets in Azure Automation contain security credentials that can be used to authenticate to resources accessed by the runbook or DSC configuration. This article describes how to create credential assets and use them in a runbook or DSC configuration.
44
services: automation
55
ms.service: automation
@@ -10,11 +10,10 @@ ms.date: 01/31/2020
1010
ms.topic: conceptual
1111
manager: carmonm
1212
---
13-
# Credential assets in Azure Automation
1413

15-
An Automation credential asset holds an object that contains security credentials, such as a user name and a password. Runbooks and DSC configurations use cmdlets that accept a [PSCredential](https://docs.microsoft.com/dotnet/api/system.management.automation.pscredential?view=pscore-6.2.0) object for authentication. Alternatively, they can extract the user name and password of the `PSCredential` object to provide to some application or service requiring authentication.
14+
# Manage credential assets in Azure Automation
1615

17-
Azure Automation securely stores the properties of a credential. Access to the properties through a runbook or DSC configuration uses the [Get-AutomationPSCredential](#activities-used-to-access-credentials) activity.
16+
An Automation credential asset holds an object that contains security credentials, such as a user name and a password. Runbooks and DSC configurations use cmdlets that accept a [PSCredential](https://docs.microsoft.com/dotnet/api/system.management.automation.pscredential?view=pscore-6.2.0) object for authentication. Alternatively, they can extract the user name and password of the `PSCredential` object to provide to some application or service requiring authentication.
1817

1918
> [!NOTE]
2019
> Secure assets in Azure Automation include credentials, certificates, connections, and encrypted variables. These assets are encrypted and stored in Azure Automation using a unique key that is generated for each Automation account. This key is stored in Key Vault. Before storing a secure asset, the key is loaded from Key Vault and then used to encrypt the asset.
@@ -41,13 +40,11 @@ The activities in the following table are used to access credentials in runbooks
4140

4241
| Activity | Description |
4342
|:--- |:--- |
44-
| `Get-AutomationPSCredential` |Gets a credential to use in a runbook or DSC configuration. The credential is in the form of a `PSCredential` object. |
43+
| `Get-AutomationPSCredential` |Gets a credential to use in a runbook or DSC configuration. The credential is in the form of a `PSCredential` object. For more about the cmdlet corresponding to this activity, see [Module assets in Azure Automation](modules.md). |
4544
| [Get-Credential](https://docs.microsoft.com/powershell/module/microsoft.powershell.security/get-credential?view=powershell-7) |Gets a credential with a prompt for user name and password. |
4645
| [New-AzureAutomationCredential](https://docs.microsoft.com/powershell/module/servicemanagement/azure/new-azureautomationcredential?view=azuresmps-4.0.0) | Creates a credential asset. |
4746

48-
For local development using the Azure Automation Authoring Toolkit, the `Get-AutomationPSCredential` cmdlet is part of assembly [AzureAutomationAuthoringToolkit](https://www.powershellgallery.com/packages/AzureAutomationAuthoringToolkit/0.2.3.9). For Azure working with the Automation context, the cmdlet is in `Orchestrator.AssetManagement.Cmdlets`. See [Manage modules in Azure Automation](modules.md).
49-
50-
To retrieve `PSCredential` objects in your code, you can install the [Microsoft Azure Automation ISE add-on for the PowerShell ISE](https://github.com/azureautomation/azure-automation-ise-addon).
47+
To retrieve `PSCredential` objects in your code, you can install the Microsoft Azure Automation ISE add-on for the PowerShell ISE. For more information, see [Module assets in Azure Automation](modules.md).
5148

5249
```azurepowershell
5350
Install-Module AzureAutomationAuthoringToolkit -Scope CurrentUser -Force
@@ -62,9 +59,9 @@ Import-Module Orchestrator.AssetManagement.Cmdlets -ErrorAction SilentlyContinue
6259
> [!NOTE]
6360
> You should avoid using variables in the `Name` parameter of `Get-AutomationPSCredential`. Their use can complicate discovery of dependencies between runbooks or DSC configurations and credential assets at design time.
6461
65-
## Python2 functions that access credentials
62+
## Python 2 functions that access credentials
6663

67-
The function in the following table is used to access credentials in a Python2 runbook.
64+
The function in the following table is used to access credentials in a Python 2 runbook.
6865

6966
| Function | Description |
7067
|:---|:---|
@@ -151,9 +148,9 @@ The following image shows an example of using a credential in a graphical runboo
151148

152149
While DSC configurations in Azure Automation can work with credential assets using `Get-AutomationPSCredential`, they can also pass credential assets via parameters. For more information, see [Compiling configurations in Azure Automation DSC](../automation-dsc-compile.md#credential-assets).
153150

154-
## Using credentials in Python2
151+
## Using credentials in Python 2
155152

156-
The following example shows an example of accessing credentials in Python2 runbooks.
153+
The following example shows an example of accessing credentials in Python 2 runbooks.
157154

158155

159156
```python
@@ -172,4 +169,4 @@ print cred["password"]
172169
* To understand the different authentication methods for Automation, see [Azure Automation Security](../automation-security-overview.md).
173170
* To get started with graphical runbooks, see [My first graphical runbook](../automation-first-runbook-graphical.md).
174171
* To get started with PowerShell workflow runbooks, see [My first PowerShell workflow runbook](../automation-first-runbook-textual.md).
175-
* To get started with Python2 runbooks, see [My first Python2 runbook](../automation-first-runbook-textual-python2.md).
172+
* To get started with Python 2 runbooks, see [My first Python 2 runbook](../automation-first-runbook-textual-python2.md).

0 commit comments

Comments
 (0)