Freigeben über

New-SCServiceConfiguration

Modul:
VirtualMachineManager Module

Erstellt eine Dienstkonfiguration aus einer Dienstvorlage.

Syntax

HostGroup 

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

Cloud 

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

Beschreibung

Mit dem Cmdlet New-SCServiceConfiguration wird eine Dienstkonfiguration aus einer Dienstvorlage erstellt. Die Dienstkonfiguration enthält instanzspezifische Werte, die bei der Bereitstellung des Dienstes verwendet werden.

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 All Hosts\HostGroup02\Production ab und speichert das Objekt in der Variablen $HostGroup.

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

Der dritte Befehl erstellt ein Dienstkonfigurationsobjekt in der Bibliothek für die in $HostGroup gespeicherte Hostgruppe unter Verwendung des in $ServiceTemplate gespeicherten Dienstvorlagenobjekts. Der Befehl speichert dann das neue Dienstkonfigurationsobjekt in der Variablen $ServiceConfig.

Mit dem letzten Befehl werden dem Benutzer die Eigenschaften des neuen Dienstkonfigurationsobjekts angezeigt.

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 Cloud-Objekt mit dem Namen Production ab und speichert das Objekt in der Variablen $Cloud.

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

Der dritte Befehl erstellt ein Dienstkonfigurationsobjekt in der Bibliothek für die private Cloud, das in $Cloud gespeichert ist, unter Verwendung des in $ServiceTemplate gespeicherten Dienstvorlagenobjekts. Der Befehl speichert dann das neue Dienstkonfigurationsobjekt in der Variablen $ServiceConfig.

Mit dem letzten Befehl werden dem Benutzer die Eigenschaften des neuen Dienstkonfigurationsobjekts angezeigt.

Parameter

-Cloud

Gibt ein privates Cloud-Objekt an.

Parametereigenschaften

Typ:Cloud
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Cloud
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-CostCenter

Gibt die Kostenstelle für eine virtuelle Maschine an, damit Sie Daten über die Zuordnung von virtuellen Maschinen (oder Ressourcen, die virtuellen Maschinen zugeordnet sind) erfassen können, die in Ihrem Abrechnungssystem verwendet werden sollen.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Description

Gibt eine Beschreibung für die Dienstkonfiguration an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-JobVariable

Gibt an, dass der Auftragsfortschritt nachverfolgt und in der Variablen gespeichert wird, die von diesem Parameter benannt wird.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Name

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:0
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-OnBehalfOfUser

Gibt einen Benutzernamen an. Dieses Cmdlet wird im Namen des Benutzers ausgeführt, der durch diesen Parameter angegeben wird.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-OnBehalfOfUserRole

Gibt eine Benutzerrolle an. Verwenden Sie zum Abrufen einer Benutzerrolle das Cmdlet Get-SCUserRole . Dieses Cmdlet wird im Namen der Benutzerrolle ausgeführt, die durch diesen Parameter angegeben wird.

Parametereigenschaften

Typ:UserRole
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:Guid
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-RunAsynchronously

Gibt an, dass der Auftrag asynchron ausgeführt wird, damit das Steuerelement sofort zur Befehlsshell zurückkehrt.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ServicePriority

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ServiceTemplate

Gibt ein Dienstvorlagenobjekt an.

Parametereigenschaften

Typ:ServiceTemplate
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Tag

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-VMHostGroup

Gibt ein Hostgruppenobjekt einer virtuellen Maschine oder ein Array von Hostgruppenobjekten an.

Parametereigenschaften

Typ:HostGroup
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

HostGroup
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-VMMServer

Gibt ein VMM-Serverobjekt an.

Parametereigenschaften

Typ:ServerConnection
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Ausgaben

ServiceConfiguration

Dieses Cmdlet gibt ein ServiceConfiguration-Objekt zurück.