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 |