Compartilhar via

Invoke-SCScriptCommand

Módulo:
VirtualMachineManager Module

Executa um comando de script no host especificado.

Sintaxe

VMHost (Padrão) 

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>]

StorageFileServerNode 

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 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.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Executable

Especifica o nome de um programa executável.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-JobVariable

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-LibraryResource

Especifica um recurso armazenado na biblioteca do VMM.

Propriedades do parâmetro

Tipo:CustomResource
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:Guid
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-RunAsAccount

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

Propriedades do parâmetro

Tipo:RunAsAccount
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-RunAsynchronously

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ScriptCommandSetting

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

Propriedades do parâmetro

Tipo:SCScriptCommandSetting
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-StandardInput

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-StorageFileServerNode

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

Propriedades do parâmetro

Tipo:StorageFileServerNode
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

StorageFileServerNode
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-TimeoutSeconds

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

Propriedades do parâmetro

Tipo:Int32
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-VMHost

Especifica um objeto de host de máquina virtual. O VMM oferece 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 .

Propriedades do parâmetro

Tipo:Host
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

VMHost
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-VMMServer

Especifica um objeto de servidor do VMM.

Propriedades do parâmetro

Tipo:ServerConnection
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Saídas

ScriptCommand

Esse cmdlet retorna um objeto ScriptCommand .

Observações

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