Compartilhar 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 de script no host especificado. Esse cmdlet só tem suporte em hosts Hyper-V.

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 em $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
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Executable

Especifica o nome de um programa executável.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-JobVariable

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-LibraryResource

Especifica um recurso armazenado na biblioteca do VMM.

Tipo:CustomResource
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PROTipID

Especifica a ID da dica de Otimização de Recursos e Desempenho (dica PRO) que disparou essa ação. Esse parâmetro permite que você audite dicas pro.

Tipo:Guid
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RunAsAccount

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

Tipo:RunAsAccount
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RunAsynchronously

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

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ScriptCommandSetting

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

Tipo:SCScriptCommandSetting
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-StandardInput

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-StorageFileServerNode

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

Tipo:StorageFileServerNode
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-TimeoutSeconds

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

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-VMHost

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

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

Tipo:Host
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-VMMServer

Especifica um objeto de servidor do VMM.

Tipo:ServerConnection
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Saídas

ScriptCommand

Esse cmdlet retorna um objeto ScriptCommand.

Observações

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