Freigeben über

New-SCServiceConfiguration

  • Referenz
Modul:
VirtualMachineManager

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.

Type:Cloud
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 Dienstkonfiguration an.

Type:String
Position:Named
Default value:None
Required:False
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 (Virtual Machine Manager) an.

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

-OnBehalfOfUser

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

-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.

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, damit das Steuerelement sofort zur Befehlsshell zurückkehrt.

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

-ServicePriority

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

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

-ServiceTemplate

Gibt ein Dienstvorlagenobjekt an.

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

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

-VMHostGroup

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

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

Ausgaben

ServiceConfiguration

Dieses Cmdlet gibt ein ServiceConfiguration -Objekt zurück.