Aracılığıyla paylaş

Invoke-AzVMRunCommand

Modül:
Az.Compute Module

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

Syntax

DefaultParameter (Varsayılan) 

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

ResourceIdParameter 

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

VMParameter 

Invoke-AzVMRunCommand
    [-VM] <PSVirtualMachine>
    -CommandId <String>
    [-ScriptPath <String>]
    [-ScriptString <String>]
    [-Parameter <Hashtable>]
    [-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.ps1parametre 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.

Parametre özellikleri

Tür:SwitchParameter
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-CommandId

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

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-Confirm

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

Parametre özellikleri

Tür:SwitchParameter
Default value:None
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:Cf

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-DefaultProfile

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

Parametre özellikleri

Tür:IAzureContextContainer
Default value:None
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:AzContext, AzureRmContext, AzureCredential

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-Parameter

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

Parametre özellikleri

Tür:Hashtable
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-ResourceGroupName

Kaynak grubunun adı.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

DefaultParameter
Position:0
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-ResourceId

VM'nin kaynak kimliği.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

ResourceIdParameter
Position:0
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer: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.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-ScriptString

Dize olarak yürütülecek betik.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-VM

PS sanal makine nesnesi.

Parametre özellikleri

Tür:PSVirtualMachine
Default value:None
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:VMProfile

Parametre kümeleri

VMParameter
Position:0
Zorunlu:True
İşlem hattından gelen değer:True
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-VMName

Sanal makinenin adı.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:İsim

Parametre kümeleri

DefaultParameter
Position:1
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-WhatIf

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

Parametre özellikleri

Tür:SwitchParameter
Default value:None
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:Wi

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

Girişler

String

PSVirtualMachine

Çıkışlar

PSRunCommandResult