Share via

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 Virtual Machine Manager (VMM)-Dienstinstanz.

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 Befehl ruft das Dienstobjekt namens 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 namens Service01 ab und speichert das Objekt in der $Service Variable.

Der zweite Befehl schließt den ausstehenden Wartungsvorgang.

Parameter

-Cloud

Gibt ein privates Cloudobjekt an.

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

-CommitPendingServiceTemplate

Wendet die ausstehende Dienstvorlage auf die Dienstinstanz an.

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

-CostCenter

Gibt die Kostenstelle für eine virtuelle Maschine an, sodass Sie Daten zur Zuordnung virtueller Maschinen (oder zu den den virtuellen Maschinen zugeordneten Ressourcen) sammeln können, um sie im Rechnungssystem zu verwenden.

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

-Description

Gibt eine Beschreibung für die Dienstinstanz an.

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

-DismissPendingServiceTemplate

Entfernt eine ausstehende Dienstvorlage aus einer Dienstinstanz.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
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

-Name

Gibt den Namen eines VMM-Objekts an.

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

-Owner

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

  • Beispielformat: -Owner "Contoso\PattiFuller"
  • Beispielformat: -Owner "PattiFuller@Contoso"
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PendingServiceTemplate

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

Type:ServiceTemplate
Position:Named
Default value:None
Required:True
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

-ServicePriority

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

Type:ServicePriority
Accepted values:Normal, Low, High
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UserRole

Gibt ein Benutzerrollenobjekt an.

Type:UserRole
Position:Named
Default value:None
Required:False
Accept pipeline input:False
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
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Ausgaben

Service

Dieses Cmdlet gibt ein Dienstobjekt zurück.