Compartilhar via

Remove-SCService

  • Referência
Módulo:
VirtualMachineManager

Exclui um serviço do VMM e todas as máquinas virtuais associadas.

Sintaxe

Remove-SCService
      [-VMMServer <ServerConnection>]
      [-Service] <Service>
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [-OnBehalfOfUser <String>]
      [-OnBehalfOfUserRole <UserRole>]
      [<CommonParameters>]

Description

O cmdlet Remove-SCService exclui um serviço do VMM (Virtual Machine Manager) e todas as máquinas virtuais associadas do host no qual ele é implantado. O serviço deve estar em um estado parado antes de excluí-lo. Para interromper um serviço, use o cmdlet Stop-SCService.

Exemplos

Exemplo 1: remover um serviço específico implantado em um host

PS C:\> $Service = Get-SCService -VMMServer "VMMServer01.Contoso.com" -Name "Service01"
PS C:\> Stop-SCService -Service $Service
PS C:\> Remove-SCService -Service $Service -Confirm

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

O segundo comando interrompe o serviço armazenado em $Service.

O último comando remove o serviço armazenado em $Service e exclui os arquivos de máquina virtual correspondentes do sistema de arquivos. Um prompt de confirmação é exibido antes que o serviço seja removido.

Exemplo 2: remover todos os serviços com nomes que incluem uma cadeia de caracteres específica

PS C:\> $Services = Get-SCService -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -Match "Service" }
PS C:\> $Services | Stop-SCService
PS C:\> $Services | Remove-SCService -Confirm

O primeiro comando obtém todos os objetos de serviço que incluem a cadeia de caracteres "Service" em seu nome e armazena os objetos na variável $Services.

O segundo comando interrompe todos os serviços armazenados em $Service.

O terceiro comando remove todos os objetos de serviço contidos em $Services e exclui os arquivos de máquina virtual correspondentes do sistema de arquivos. Um prompt de confirmação é exibido antes que o serviço seja removido.

Parâmetros

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
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

-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

-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

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

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