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.