Freigeben über

Remove-SCServiceConfiguration

  • Referenz
Modul:
VirtualMachineManager

Löscht ein Dienstkonfigurationsobjekt aus der VMM-Bibliothek.

Syntax

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

Beschreibung

Das Cmdlet Remove-SCServiceConfiguration Cmdlet löscht mindestens ein Dienstkonfigurationsobjekt aus der VMM-Bibliothek (Virtual Machine Manager).

Beispiele

Beispiel 1: Entfernen eines bestimmten Dienstkonfigurationsobjekts aus der Bibliothek

PS C:\> $SvcConfig = Get-SCServiceConfiguration -VMMServer "VMMServer01.Contoso.com" -Name "Service01"
PS C:\> Remove-SCServiceConfiguration -ServiceConfiguration $SvcConfig -Confirm

Der erste Befehl ruft das Dienstkonfigurationsobjekt "Service01" ab und speichert das Objekt in der variablen $SvcConfig.

Der zweite Befehl entfernt das in $SvcConfig gespeicherte Dienstkonfigurationsobjekt aus der VMM-Datenbank und löscht das entsprechende Dienstkonfigurationsobjekt und alle anderen zugeordneten Objekte in der Bibliothek. Eine Bestätigungsaufforderung wird angezeigt, bevor das Dienstkonfigurationsobjekt entfernt wird.

Beispiel 2: Entfernen aller Dienstkonfigurationsobjekte

PS C:\> $SvcConfigs = Get-SCServiceConfiguration -VMMServer "VMMServer01.Contoso.com"
PS C:\> $SvcConfigs | Remove-SCServiceConfiguration -Confirm

Der erste Befehl ruft alle Dienstkonfigurationsobjekte auf VMMServer01 ab und speichert die Objekte in der variablen $SvcConfigs.

Der zweite Befehl entfernt alle in $SvcConfigs gespeicherten Dienstkonfigurationsobjekte und löscht alle anderen zugeordneten Objekte in der Bibliothek. Eine Bestätigungsaufforderung wird angezeigt, bevor die Dienstkonfigurationsobjekte entfernt werden.

Parameter

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-JobVariable

Gibt an, dass der Auftragsfortschritt nachverfolgt und in der Variablen gespeichert wird, die von diesem Parameter benannt wird.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-OnBehalfOfUser

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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.

Typ:UserRole
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PROTipID

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

Typ:Guid
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RunAsynchronously

Gibt an, dass der Auftrag asynchron ausgeführt wird, damit das Steuerelement sofort zur Befehlsshell zurückkehrt.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ServiceConfiguration

Gibt ein Dienstkonfigurationsobjekt an.

Typ:ServiceConfiguration
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-VMMServer

Gibt ein VMM-Serverobjekt an.

Typ:ServerConnection
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-WhatIf

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

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False