Invoke-AzVMRunCommand

VM'de bir komut çalıştırın.

Sözdizimi

Invoke-AzVMRunCommand
      [-ResourceGroupName] <String>
      [-VMName] <String>
      -CommandId <String>
      [-ScriptPath <String>]
      [-ScriptString <String>]
      [-Parameter <Hashtable>]
      [-AsJob]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Invoke-AzVMRunCommand
      -CommandId <String>
      [-ScriptPath <String>]
      [-ScriptString <String>]
      [-Parameter <Hashtable>]
      [-ResourceId] <String>
      [-AsJob]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Invoke-AzVMRunCommand
      -CommandId <String>
      [-ScriptPath <String>]
      [-ScriptString <String>]
      [-Parameter <Hashtable>]
      [-VM] <PSVirtualMachine>
      [-AsJob]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

VM'de bir çalıştırma komutu çağırın.

Örnekler

Örnek 1: Windows'da komut çağırma - Betik uzak Windows VM'sinde bulunduğunda ScriptPath parametresini kullanma

Invoke-AzVMRunCommand -ResourceGroupName 'rgname' -VMName 'vmname' -CommandId 'RunPowerShellScript' -ScriptPath 'sample.ps1' -Parameter @{param1 = "var1"; param2 = "var2"}

'rgname' kaynak grubundaki 'vmname' adlı bir Windows VM'sinde 'sample.ps1' betiğini geçersiz kılarak 'RunPowerShellScript' çalıştırma komutunu çağırın. Var1 ve var2, sample.ps1 dosyasında parametre olarak tanımlanır. Parametre değeri yalnızca dize türü olabilir ve gerekirse bunları diğer türlere dönüştürmek betik tarafından sorumludur.

Örnek 2: Windows'da komut çağırma - Windows VM'de cmdlet yürütmek için ScriptString parametresini kullanma

Invoke-AzVMRunCommand -ResourceGroupName 'rgname' -VMName 'vmname' -CommandId 'RunPowerShellScript' -ScriptString "Set-TimeZone -Name 'Coordinated Universal Time' -PassThru"

Bu komut, ilişkili parametreleriyle Set-TimeZone cmdlet'ini yürütecek bir 'RunShellScript' çalıştırma komutu çağırır. Bu örnek, Windows VM'de kısa komutlar yürütmek istediğinizde kullanışlıdır.

Örnek 3: Windows'da komut çağırma - Windows VM'de betik bloklarını çalıştırmak için ScriptString parametresini kullanma

$ScriptBlock = {
    param(
        [string] $NewTimeZone,
        [string] $NewDate
        )
    Set-TimeZone -Id $NewTimeZone
    Set-Date -Date [DateTime]$NewDate
}

$Script = [scriptblock]::create($ScriptBlock)

Invoke-AzVMRunCommand -ResourceGroupName 'rgname' -VMName 'vmname' -CommandId 'RunPowerShellScript' -ScriptString $Script -Parameter @{'NewTimeZone' = "UTC"; 'NewDate' = "Dec-8"}

Bu komut, 'vmname' adlı uzak bir Windows VM'sinde betik bloğu yürüten bir 'RunShellScript' çalıştırma komutu çağırır. Betik bloğu yolu, tek bir çağrıda parametrelerle birden çok cmdlet yürütmenizi sağlar ve ayrıca farklı cmdlet'ler için birden çok çalıştırma komutu çağırmada zaman kazandırır. Parametre değerleri yalnızca dize türünde olabilir.

Örnek 4: Linux'ta komut çağırma

export param1=var1 param2=var2
set -- var1 var2 var3

Invoke-AzVMRunCommand -ResourceGroupName 'rgname' -Name 'vmname' -CommandId 'RunShellScript' -ScriptPath 'sample.bash' -Parameter @{"param1" = "var1";"param2" = "var2"}
echo This is a sample bash script
echo Usage 1: Ordered parameters: $0 $1
echo Usage 2: Named exports: $var1 $var2

Bu komut, 'vmname' adlı bir Linux VM'sinde 'sample.bash' betiğini geçersiz kılarak 'RunShellScript' çalıştırma komutunu çağırır. Var1 ve var2, sample.bash dosyasında parametre olarak tanımlanır.

Parametreler

-AsJob

Cmdlet'i arka planda çalıştırın ve ilerleme durumunu izlemek için bir iş nesnesi döndürin.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-CommandId

Çalıştırma komut kimliği.

Tür:String
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Tür:SwitchParameter
Diğer adlar:cf
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-DefaultProfile

Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik.

Tür:IAzureContextContainer
Diğer adlar:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Parameter

Komut parametrelerini çalıştırın. Betik yürütme sırasında geçirilecek anahtar/değer çiftleri olarak parametreleri belirtin.

Tür:Hashtable
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ResourceGroupName

Kaynak grubunun adı.

Tür:String
Position:0
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-ResourceId

VM'nin kaynak kimliği.

Tür:String
Position:0
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-ScriptPath

Yürütülecek betiğin yolu. Bu değer verildiğinde, verilen betik komutun varsayılan betiğini geçersiz kılar. Yol, yerel dosya sisteminden bir dosyaya işaret etmelidir. komutu onu yükler ve yürütme için gönderir.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ScriptString

Dize olarak yürütülecek betik.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-VM

PS sanal makine nesnesi.

Tür:PSVirtualMachine
Diğer adlar:VMProfile
Position:0
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-VMName

Sanal makinenin adı.

Tür:String
Diğer adlar:Name
Position:1
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-WhatIf

Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

Tür:SwitchParameter
Diğer adlar:wi
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

Girişler

String

PSVirtualMachine

Çıkışlar

PSRunCommandResult