Freigeben über


New-SCServiceConfiguration

Erstellt eine Dienstkonfiguration aus einer Dienstvorlage.

Syntax

New-SCServiceConfiguration
   [-Name] <String>
   [-Description <String>]
   [-VMMServer <ServerConnection>]
   -ServiceTemplate <ServiceTemplate>
   [-ServicePriority <String>]
   -VMHostGroup <HostGroup>
   [-Tag <String>]
   [-CostCenter <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
New-SCServiceConfiguration
   [-Name] <String>
   [-Description <String>]
   [-VMMServer <ServerConnection>]
   -ServiceTemplate <ServiceTemplate>
   [-ServicePriority <String>]
   -Cloud <Cloud>
   [-Tag <String>]
   [-CostCenter <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet New-SCServiceConfiguration erstellt eine Dienstkonfiguration aus einer Dienstvorlage. Die Dienstkonfiguration enthält instanzspezifische Werte, die verwendet werden, wenn der Dienst bereitgestellt wird.

Beispiele

Beispiel 1: Erstellen einer Dienstkonfiguration für eine Hostgruppe

PS C:\> $HostGroup = Get-SCVMHostGroup | where { $_.Path -eq "All Hosts\HostGroup02\Production" }
PS C:\> $ServiceTemplate = Get-SCServiceTemplate -Name "ServiceTemplate01"
PS C:\> $ServiceConfig = New-SCServiceConfiguration -ServiceTemplate $ServiceTemplate -Name "Service01" -VMHostGroup $HostGroup  -Description "Contoso Service 01" -ServicePriority High -CostCenter 1033 
PS C:\> $ServiceConfig

Der erste Befehl ruft das Hostgruppenobjekt mit dem Pfad "Alle Hosts\HostGroup02\Production" ab und speichert das Objekt in der $HostGroup Variablen.

Der zweite Befehl ruft das Dienstvorlagenobjekt namens ServiceTemplate01 ab und speichert es in der $ServiceTemplate Variablen.

Der dritte Befehl erstellt ein Dienstkonfigurationsobjekt in der Bibliothek für die in $HostGroup gespeicherte Hostgruppe mithilfe des in $ServiceTemplate gespeicherten Dienstvorlagenobjekts. Anschließend speichert der Befehl das neue Dienstkonfigurationsobjekt in der variablen $ServiceConfig.

Der letzte Befehl zeigt die Eigenschaften des neuen Dienstkonfigurationsobjekts für den Benutzer an.

Beispiel 2: Erstellen einer Dienstkonfiguration für eine private Cloud

PS C:\> $Cloud = Get-SCCloud -Name "Production"
PS C:\> $ServiceTemplate = Get-SCServiceTemplate -Name "ServiceTemplate01"
PS C:\> $ServiceConfig = New-SCServiceConfiguration -ServiceTemplate $ServiceTemplate -Name "Service02" -Cloud $Cloud  -Description "Contoso Cloud Service" -ServicePriority High -CostCenter 1033 
PS C:\> $ServiceConfig

Der erste Befehl ruft das private Cloudobjekt mit dem Namen Production ab und speichert das Objekt in der $Cloud Variablen.

Der zweite Befehl ruft das Dienstvorlagenobjekt namens ServiceTemplate01 ab und speichert es in der $ServiceTemplate Variablen.

Der dritte Befehl erstellt ein Dienstkonfigurationsobjekt in der Bibliothek für die in $Cloud gespeicherte private Cloud mithilfe des in $ServiceTemplate gespeicherten Dienstvorlagenobjekts. Anschließend speichert der Befehl das neue Dienstkonfigurationsobjekt in der variablen $ServiceConfig.

Der letzte Befehl zeigt die Eigenschaften des neuen Dienstkonfigurationsobjekts für den Benutzer an.

Parameter

-Cloud

Gibt ein privates Cloudobjekt an.

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

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

-Description

Gibt eine Beschreibung für die Dienstkonfiguration an.

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

-JobVariable

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

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

-Name

Gibt den Namen eines VMM-Objekts (Virtual Machine Manager) an.

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

-OnBehalfOfUser

Gibt einen Benutzernamen an. Dieses Cmdlet wird im Namen 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. Um eine Benutzerrolle abzurufen, verwenden Sie das Cmdlet Get-SCUserRole . Dieses Cmdlet wird im Namen 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

-ServicePriority

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

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

-ServiceTemplate

Gibt ein Dienstvorlagenobjekt an.

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

-Tag

Gibt ein Wort oder einen Ausdruck an, der einem Objekt zugeordnet werden soll, damit Sie nach allen Objekten mit dem angegebenen Satz von Tags suchen können. Sie können nach einer Teilmenge von Tags suchen oder nach der vollständigen Gruppe von Tags suchen.

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

-VMHostGroup

Gibt ein Hostgruppenobjekt für virtuelle Maschinen oder einen Array aus Hostgruppenobjekten an.

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

Ausgaben

ServiceConfiguration

Dieses Cmdlet gibt ein ServiceConfiguration -Objekt zurück.