Compartilhar via

Stop-SCService

  • Referência
Módulo:
VirtualMachineManager

Interrompe um serviço do VMM e todas as máquinas virtuais dentro do serviço.

Sintaxe

Stop-SCService
    [-VMMServer <ServerConnection>]
    [-Service] <Service>
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]
Stop-SCService
    [-VMMServer <ServerConnection>]
    [-Service] <Service>
    [-SaveState]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]
Stop-SCService
    [-VMMServer <ServerConnection>]
    [-Service] <Service>
    [-DiscardSavedState]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]
Stop-SCService
    [-VMMServer <ServerConnection>]
    [-Service] <Service>
    [-Shutdown]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

Description

O cmdlet Stop-SCService interrompe um serviço VMM (Virtual Machine Manager) e todas as máquinas virtuais dentro do serviço. Para iniciar um serviço, use o cmdlet Start-SCService.

Exemplos

Exemplo 1: Parar um serviço específico

PS C:\> $Service = Get-SCService -Name "Service01"
PS C:\> Stop-SCService -Service $Service

O primeiro comando obtém o objeto de serviço chamado Service01 e armazena o objeto na variável $Service.

O segundo comando interrompe o serviço em $Service, que interrompe todas as máquinas virtuais no serviço.

Parâmetros

-DiscardSavedState

Indica que esse cmdlet exclui o estado salvo associado a um serviço.

Tipo:SwitchParameter
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

-OnBehalfOfUser

Especifica um nome de usuário. Esse cmdlet opera em nome do usuário especificado 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

-OnBehalfOfUserRole

Especifica uma função de usuário. Para obter uma função de usuário, use o cmdlet Get-SCUserRole. Esse cmdlet opera em nome da função de usuário especificada por esse parâmetro.

Tipo:UserRole
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

-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

-SaveState

Salva o estado de uma máquina virtual ou serviço.

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

-Service

Especifica um objeto de serviço do VMM.

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

-Shutdown

Indica que uma máquina virtual, um serviço ou um servidor de origem deve ser desligado. No caso de uma máquina virtual ou serviço, o cmdlet associado tenta usar o sistema operacional para desligar a máquina virtual normalmente.

No caso de uma conversão P2V (máquina física para virtual) bem-sucedida, o cmdlet desliga o servidor de origem.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
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

VirtualMachine[]

Esse cmdlet retorna uma matriz de objetos VirtualMachine.