Freigeben über

Remove-SCService

  • Referenz
Modul:
VirtualMachineManager

Löscht einen VMM-Dienst und alle zugeordneten virtuellen Computer.

Syntax

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

Beschreibung

Das Cmdlet Remove-SCService löscht einen Virtual Machine Manager (VMM)-Dienst und alle zugeordneten virtuellen Computer aus dem Host, auf dem sie bereitgestellt wird. Der Dienst muss sich vor dem Löschen in einem beendeten Zustand befinden. Um einen Dienst zu beenden, verwenden Sie das Cmdlet Stop-SCService.

Beispiele

Beispiel 1: Entfernen eines bestimmten Diensts, der auf einem Host bereitgestellt wird

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

Der erste Befehl ruft das Dienstobjekt namens Service01 auf VMMServer01 ab und speichert das Objekt in der $Service Variablen.

Der zweite Befehl beendet den in $Service gespeicherten Dienst.

Der letzte Befehl entfernt den in $Service gespeicherten Dienst und löscht die entsprechenden virtuellen Computerdateien aus dem Dateisystem. Eine Bestätigungsaufforderung wird angezeigt, bevor der Dienst entfernt wird.

Beispiel 2: Entfernen aller Dienste mit Namen, die eine bestimmte Zeichenfolge enthalten

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

Der erste Befehl ruft alle Dienstobjekte ab, die die Zeichenfolge "Dienst" in ihrem Namen enthalten, und speichert dann die Objekte in der $Services Variable.

Der zweite Befehl beendet alle in $Service gespeicherten Dienste.

Der dritte Befehl entfernt alle in $Services enthaltenen Dienstobjekte und löscht die entsprechenden virtuellen Computerdateien aus dem Dateisystem. Eine Bestätigungsaufforderung wird angezeigt, bevor der Dienst entfernt wird.

Parameter

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JobVariable

Gibt an, dass der Status des Auftrags überwacht und in der von diesem Parameter benannten Variablen gespeichert wird.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUser

Gibt einen Benutzernamen an. Dieses Cmdlet wird im Auftrag des Benutzers ausgeführt, den dieser Parameter angibt.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUserRole

Gibt eine Benutzerrolle an. Verwenden Sie zum Abrufen einer Benutzerrolle das Cmdlet Get-SCUserRole . Dieses Cmdlet wird im Auftrag der Benutzerrolle ausgeführt, die dieser Parameter angibt.

Type:UserRole
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PROTipID

Gibt die ID der Leistungs- und Ressourcenoptimierungs-Tipp (PRO-Tipp) an, die diese Aktion ausgelöst hat. Mit diesem Parameter können Sie PRO-Tipps überwachen.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAsynchronously

Gibt an, dass der Auftrag asynchron ausgeführt wird, sodass das Steuerelement sofort an die Befehlsshell zurückgibt.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Service

Gibt ein VMM-Dienstobjekt an.

Type:Service
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VMMServer

Gibt ein VMM-Serverobjekt an.

Type:ServerConnection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False