Partilhar via

Invoke-SCScriptCommand

  • Referência
Módulo:
VirtualMachineManager

Executa um comando de script no host especificado.

Sintaxe

Invoke-SCScriptCommand
      -VMHost <Host>
      -Executable <String>
      [-CommandParameters <String>]
      [-ScriptCommandSetting <SCScriptCommandSetting>]
      [-TimeoutSeconds <Int32>]
      [-StandardInput <String>]
      [-LibraryResource <CustomResource>]
      [-RunAsAccount <RunAsAccount>]
      [-VMMServer <ServerConnection>]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [<CommonParameters>]
Invoke-SCScriptCommand
      -StorageFileServerNode <StorageFileServerNode>
      -Executable <String>
      [-CommandParameters <String>]
      [-ScriptCommandSetting <SCScriptCommandSetting>]
      [-TimeoutSeconds <Int32>]
      [-StandardInput <String>]
      [-LibraryResource <CustomResource>]
      [-RunAsAccount <RunAsAccount>]
      [-VMMServer <ServerConnection>]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [<CommonParameters>]

Description

O cmdlet Invoke-SCScriptCommand executa um comando script no host especificado. Este cmdlet só é suportado em Hyper-V anfitriões.

Exemplos

Exemplo 1: Executar um comando de script

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01"
PS C:\> Invoke-SCScriptCommand -VMHost $VMHost -Executable "cmd.exe" -CommandParameters "/C rd C:\test" -TimeoutSeconds 60

O primeiro comando obtém o objeto host chamado VMHost01 e armazena o objeto na variável $VMHost.

O segundo comando executa o programa executável chamado cmd.exe com os parâmetros especificados no host armazenado no $VMHost. Nesse caso, Invoke-SCScriptCommand remove o diretório de teste da unidade c: no VMHost01.

Parâmetros

-CommandParameters

Especifica os parâmetros para um script ou programa executável.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Executable

Especifica o nome de um programa executável.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-JobVariable

Especifica que o progresso do trabalho é controlado e armazenado na variável nomeada por esse parâmetro.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-LibraryResource

Especifica um recurso armazenado na biblioteca do VMM.

Tipo:CustomResource
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PROTipID

Especifica a ID da dica de Otimização de Desempenho e Recursos (dica PRO) que disparou essa ação. Este parâmetro permite auditar dicas PRO.

Tipo:Guid
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-RunAsAccount

Especifica uma conta Run As que contém credenciais com permissão para executar essa ação.

Tipo:RunAsAccount
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-RunAsynchronously

Indica que o trabalho é executado de forma assíncrona para que o controle retorne ao shell de comando imediatamente.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ScriptCommandSetting

Especifica um objeto de configuração de comando de script.

Tipo:SCScriptCommandSetting
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-StandardInput

Especifica um caminho para um arquivo que contém informações de entrada padrão para usar com o comando script.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-StorageFileServerNode

Especifica um nó em um cluster de servidor de arquivos.

Tipo:StorageFileServerNode
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-TimeoutSeconds

Especifica a quantidade de tempo, em segundos, que um processo aguarda antes do tempo limite.

Tipo:Int32
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-VMHost

Especifica um objeto de host de máquina virtual. O VMM suporta hosts Hyper-V, VMware ESX e Citrix XenServer.

Para obter mais informações sobre cada tipo de host, consulte o cmdlet Add-SCVMHost.

Tipo:Host
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-VMMServer

Especifica um objeto de servidor VMM.

Tipo:ServerConnection
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

Saídas

ScriptCommand

Este cmdlet retorna um objeto ScriptCommand.

Notas

  • Requer um objeto VMHost , que pode ser recuperado usando o cmdlet Get-SCVMHost.