Set-AzVMRunCommand

run コマンドを作成または更新する操作。

構文

Set-AzVMRunCommand
   -ResourceGroupName <String>
   -RunCommandName <String>
   -VMName <String>
   -Location <String>
   [-SubscriptionId <String>]
   [-AsyncExecution]
   [-ErrorBlobUri <String>]
   [-OutputBlobUri <String>]
   [-Parameter <IRunCommandInputParameter[]>]
   [-ProtectedParameter <IRunCommandInputParameter[]>]
   [-RunAsPassword <String>]
   [-RunAsUser <String>]
   [-SourceCommandId <String>]
   [-SourceScript <String>]
   [-SourceScriptUri <String>]
   [-Tag <Hashtable>]
   [-TimeoutInSecond <Int32>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-Confirm]
   [-WhatIf]
   [<CommonParameters>]

説明

run コマンドを作成または更新する操作。

例 1: 簡単な例

Set-AzVMRunCommand -ResourceGroupName $rgname -VMName $vmname -RunCommandName 'firstruncommand'

Location Name             Type
-------- ----             ----
eastus   firstruncommand2 Microsoft.Compute/virtualMachines/runCommands

Set-AzVMRunCommand コマンドレットは、既存の実行コマンドのプロパティを更新するか、仮想マシンに新しい実行コマンドを追加します。

パラメーター

-AsJob

コマンドをジョブとして実行する

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-AsyncExecution

省略可能。 true に設定すると、スクリプトが開始されるとすぐにプロビジョニングが完了し、スクリプトが完了するまで待機しません。

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DefaultProfile

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

Type:PSObject
Aliases:AzureRMContext, AzureCredential
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ErrorBlobUri

スクリプト エラー ストリームをアップロードする Azure ストレージ BLOB を指定します。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Location

リソースの場所

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-NoWait

コマンドを非同期的に実行する

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-OutputBlobUri

スクリプト出力ストリームをアップロードする Azure Storage BLOB を指定します。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Parameter

スクリプトで使用されるパラメーター。 構築するには、PARAMETER プロパティの「NOTES」セクションを参照し、ハッシュ テーブルを作成します。

Type:IRunCommandInputParameter[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ProtectedParameter

スクリプトで使用されるパラメーター。 構築するには、PROTECTEDPARAMETER プロパティの NOTES セクションを参照し、ハッシュ テーブルを作成します。

Type:IRunCommandInputParameter[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ResourceGroupName

リソース グループの名前。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-RunAsPassword

実行コマンドの実行時に VM のユーザー アカウント パスワードを指定します。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-RunAsUser

実行コマンドの実行時に VM 上のユーザー アカウントを指定します。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-RunCommandName

仮想マシンの実行コマンドの名前。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SourceCommandId

定義済みの組み込みスクリプトの commandId を指定します。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SourceScript

VM で実行するスクリプトコンテンツを指定します。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SourceScriptUri

スクリプトのダウンロード場所を指定します。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SubscriptionId

Microsoft Azure サブスクリプションを一意に識別するサブスクリプション資格情報。 サブスクリプション ID は、全ての修理依頼についてURI の一部を生じさせます。

Type:String
Position:Named
Default value:(Get-AzContext).Subscription.Id
Accept pipeline input:False
Accept wildcard characters:False
-Tag

リソース タグ

Type:Hashtable
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-TimeoutInSecond

run コマンドを実行するためのタイムアウト (秒単位)。

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-VMName

実行コマンドを作成または更新する必要がある仮想マシンの名前。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

出力

IVirtualMachineRunCommand

メモ

別名

複合パラメーターのプロパティ

以下で説明するパラメーターを作成するには、適切なプロパティを含むハッシュ テーブルを作成します。 ハッシュ テーブルの詳細については、Get-Help about_Hash_Tablesを実行します。

PARAMETER <IRunCommandInputParameter[]>: スクリプトで使用されるパラメーター。

  • Name <String>: run コマンド パラメーター名。
  • Value <String>: run コマンド パラメーターの値。

PROTECTEDPARAMETER <IRunCommandInputParameter[]>: スクリプトで使用されるパラメーター。

  • Name <String>: run コマンド パラメーター名。
  • Value <String>: run コマンド パラメーターの値。