Invoke-AzVMRunCommand

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

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

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

Roep een run-opdracht aan op de VIRTUELE machine.

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

Roep een run-opdracht 'RunPowerShellScript' aan met het script 'sample.ps1' op een Windows-VM met de naam 'vmname' in de resourcegroep 'rgname'. Var1 en var2 worden gedefinieerd als parameters in de sample.ps1. Parameterwaarde kan alleen tekenreekstype zijn en het script is indien nodig verantwoordelijk voor het converteren ervan naar andere typen.

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

Met deze opdracht wordt een run-opdracht 'RunShellScript' aangeroepen waarmee de cmdlet wordt uitgevoerd Set-TimeZone met de bijbehorende parameters. Dit voorbeeld is handig als u korte opdrachten wilt uitvoeren op een Virtuele Windows-machine.

$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"}

Met deze opdracht wordt een run-opdracht 'RunShellScript' aangeroepen waarmee een scriptblok wordt uitgevoerd op een externe Windows-VM met de naam 'vmname'. Met het scriptblok kunt u meerdere cmdlets uitvoeren met parameters in één aanroep en bespaart u ook tijd bij het aanroepen van meerdere uitvoeringsopdrachten voor verschillende cmdlets. Parameterwaarde(s) kan alleen van het tekenreekstype zijn.

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

Met deze opdracht wordt een run-opdracht 'RunShellScript' aangeroepen, waarbij het script sample.bash wordt overschreven op een Virtuele Linux-machine met de naam 'vmname'. Var1 en var2 worden gedefinieerd als parameters in de sample.bash.

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.