New-AzAutomationVariable

モジュール:

Az.Automation

Automation 変数を作成します。

構文

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

説明

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

例

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

New-AzAutomationVariable -AutomationAccountName "Contoso17" -Name "StringVariable22" -Encrypted $False -Value "My String" -ResourceGroupName "ResourceGroup01"

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

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

$VirtualMachine = Get-AzVM -Name "VirtualMachine03"
New-AzAutomationVariable -AutomationAccountName "Contoso17" -Name "ComplexVariable01" -Encrypted $False -Value $VirtualMachine -ResourceGroupName "ResourceGroup01"

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

パラメーター

-AutomationAccountName

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

型:	String
配置:	1
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-DefaultProfile

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

型:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Description

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

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-Encrypted

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

型:	Boolean
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-Name

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

型:	String
配置:	2
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-ResourceGroupName

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

型:	String
配置:	0
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-Value

変数の値を指定します。

型:	Object
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

入力

String

Boolean

Object

出力

Variable

関連リンク

• Get-AzAutomationVariable
• Remove-AzAutomationVariable
• Set-AzAutomationVariable