Freigeben über

Set-SCService

  • Referenz
Modul:
VirtualMachineManager

Ändert eine VMM-Dienstinstanz.

Syntax

Set-SCService
   [-Name <String>]
   [-Description <String>]
   [-Owner <String>]
   [-CostCenter <String>]
   [-ServicePriority <ServicePriority>]
   [-VMMServer <ServerConnection>]
   [-Service] <Service>
   [-UserRole <UserRole>]
   [-Cloud <Cloud>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCService
   [-Name <String>]
   [-Description <String>]
   [-Owner <String>]
   [-CostCenter <String>]
   [-ServicePriority <ServicePriority>]
   [-VMMServer <ServerConnection>]
   [-Service] <Service>
   -PendingServiceTemplate <ServiceTemplate>
   [-UserRole <UserRole>]
   [-Cloud <Cloud>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCService
   [-Name <String>]
   [-Description <String>]
   [-Owner <String>]
   [-CostCenter <String>]
   [-ServicePriority <ServicePriority>]
   [-VMMServer <ServerConnection>]
   [-Service] <Service>
   [-DismissPendingServiceTemplate]
   [-WhatIf]
   [-UserRole <UserRole>]
   [-Cloud <Cloud>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCService
   [-Name <String>]
   [-Description <String>]
   [-Owner <String>]
   [-CostCenter <String>]
   [-ServicePriority <ServicePriority>]
   [-VMMServer <ServerConnection>]
   [-Service] <Service>
   [-CommitPendingServiceTemplate]
   [-WhatIf]
   [-UserRole <UserRole>]
   [-Cloud <Cloud>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Beschreibung

Das cmdlet Set-SCService ändert eine VMM-Dienstinstanz (Virtual Machine Manager).

Beispiele

Beispiel 1: Ändern der Beschreibung und Priorität eines Diensts

PS C:\> $Service = Get-SCService -Name "Service01"
PS C:\> Set-SCService -Service $Service -Description "Contoso Custom Service" -ServicePriority Normal

Der erste Befehlsbefehl ruft das Dienstobjekt mit dem Namen Service01 ab und speichert das Objekt in der $Service Variablen.

Der zweite Befehl aktualisiert die Beschreibung und Priorität für den in $Service gespeicherten Dienst.

Beispiel 2: Schließen einer ausstehenden Dienstvorlage

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

Der erste Befehl ruft das Dienstobjekt mit dem Namen Service01 ab und speichert das Objekt in der $Service Variablen.

Der zweite Befehl schließt den ausstehenden Wartungsvorgang.

Parameter

-Cloud

Gibt ein privates Cloudobjekt an.

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

-CommitPendingServiceTemplate

Wendet die ausstehende Dienstvorlage auf die Dienstinstanz an.

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

-CostCenter

Gibt das Kostencenter für einen virtuellen Computer an, sodass Sie Daten über die Zuordnung virtueller Computer (oder Ressourcen, die virtuellen Computern zugeordnet sind) sammeln können, um sie in Ihrem Abrechnungssystem zu nutzen.

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

-Description

Gibt eine Beschreibung für die Dienstinstanz an.

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

-DismissPendingServiceTemplate

Entfernt eine ausstehende Dienstvorlage aus einer Dienstinstanz.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:True
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

-Name

Gibt den Namen eines VMM-Objekts an.

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

-Owner

Gibt den Besitzer eines VMM-Objekts in Form eines gültigen Domänenbenutzerkontos an.

  • Beispielformat: -Owner "Contoso\PattiFuller"
  • Beispielformat: -Owner "PattiFuller@Contoso"
Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PendingServiceTemplate

Gibt ein Dienstvorlagenobjekt an, das aktualisiert, aber nicht auf die Dienstinstanz angewendet wurde.

Typ:ServiceTemplate
Position:Named
Standardwert:None
Erforderlich:True
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

-Service

Gibt ein VMM-Dienstobjekt an.

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

-ServicePriority

Gibt die Priorität für einen Dienst an. Gültige Werte sind: Normal, Niedrig, Hoch. Standardwert: Normal.

Typ:ServicePriority
Zulässige Werte:Normal, Low, High
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-UserRole

Gibt ein Benutzerrollenobjekt an.

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

Ausgaben

Service

Dieses Cmdlet gibt ein Service-Objekt zurück.