New-AzureRMAutomationVariable

リファレンス

モジュール:: AzureRM.Automation

Automation 変数を作成します。

警告

AzureRM PowerShell モジュールは、2024 年 2 月 29 日の時点で正式に非推奨になりました。引き続きサポートを受け、更新を受け取れるようにするために、AzureRM から Az PowerShell モジュールに移行することをお勧めします。

AzureRM モジュールは引き続き機能する可能性がありますが、メインが維持またはサポートされなくなり、ユーザーの判断とリスクで引き続き使用できます。 Az モジュールへの移行に関するガイダンスについては、移行リソースを参照してください。

構文

New-AzureRMAutomationVariable
   [-Name] <String>
   -Encrypted <Boolean>
   [-Description <String>]
   [-Value <Object>]
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

説明

New-AzureRmAutomationVariable コマンドレットは、Azure Automation で変数を作成します。変数を暗号化するには、Encrypted パラメーターを指定します。作成後に変数の暗号化された状態を変更することはできません。

例

例 1: 単純な値を使用して変数を作成する

PS C:\>New-AzureRmAutomationVariable -AutomationAccountName "Contoso17" -Name "StringVariable22" -Encrypted $False -Value "My String" -ResourceGroupName "ResourceGroup01"

このコマンドは、Contoso17 という名前の Automation アカウントに文字列値を持つ StringVariable22 という名前の変数を作成します。

例 2: 複合値を持つ変数を作成する

PS C:\>$VirtualMachine = Get-AzureVM -ServiceName "VirtualMachine" -Name "VirtualMachine03"
PS C:\> New-AzureRmAutomationVariable -AutomationAccountName "Contoso17" -Name "ComplexVariable01" -Encrypted $False -Value $VirtualMachine -ResourceGroupName "ResourceGroup01"

最初のコマンドは、Get-AzureVM コマンドレットを使用して仮想マシンを取得します。このコマンドは、$VirtualMachine変数に格納します。 2 番目のコマンドは、Contoso17 という名前の Automation アカウントに ComplexVariable01 という名前の変数を作成します。このコマンドでは、$VirtualMachine内の仮想マシンの値に複合オブジェクトを使用します。

パラメーター

-AutomationAccountName

変数を格納する Automation アカウントの名前を指定します。

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-DefaultProfile

Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション

Type:	IAzureContextContainer
Aliases:	AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Description

変数の説明を指定します。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Encrypted

このコマンドレットがストレージの変数の値を暗号化するかどうかを指定します。

Type:	Boolean
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

変数の名前を指定します。

Type:	String
Position:	2
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ResourceGroupName

このコマンドレットで変数を作成するリソースグループを指定します。

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Value

変数の値を指定します。

Type:	Object
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

入力

String

Boolean

Object

出力

Variable