Freigeben über

New-SCVMConfiguration

Modul:
VirtualMachineManager Module

Erstellt eine VM-Konfiguration aus einer VM-Vorlage.

Syntax

FromTemplateOnly (Standardwert) 

New-SCVMConfiguration
    -VMTemplate <Template>
    [-Name <String>]
    [-Description <String>]
    [-CostCenter <String>]
    [-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

Cloud 

New-SCVMConfiguration
    -VMTemplate <Template>
    -Name <String>
    -Cloud <Cloud>
    [-Description <String>]
    [-CostCenter <String>]
    [-CapabilityProfile <CapabilityProfile>]
    [-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

VMHostGroup 

New-SCVMConfiguration
    -VMTemplate <Template>
    -Name <String>
    -VMHostGroup <HostGroup>
    [-Description <String>]
    [-CostCenter <String>]
    [-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

ComputerTier 

New-SCVMConfiguration
    -ComputerTier <ComputerTier>
    [-Name <String>]
    [-Description <String>]
    [-CostCenter <String>]
    [-ComputerName <String>]
    [-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

Beschreibung

Mit dem Cmdlet New-SCVMConfiguration wird eine VM-Konfiguration aus einer VM-Vorlage erstellt. Die Konfiguration der virtuellen Maschine wird verwendet, um instanzspezifische Werte anzugeben, die bei der Bereitstellung der Konfiguration der virtuellen Maschine verwendet werden sollen.

Beispiele

Beispiel 1: Erstellen einer VM-Konfiguration für die Platzierung einer virtuellen Maschine in einer Hostgruppe

PS C:\> $HostGroup = Get-SCVMHostGroup -Name "Production"
PS C:\> $VMTemplate = Get-SCVMTemplate | where {$_.Name -eq "VMTemplate01"}
PS C:\> $VMConfig = New-SCVMConfiguration -VMTemplate $VMTemplate -VMHostGroup $HostGroup -CostCenter 1234 -Name "VMConfig01"

Der erste Befehl ruft das Hostgruppenobjekt mit dem Namen Production ab und speichert das Objekt in der Variablen $HostGroup.

Der zweite Befehl ruft alle Vorlagenobjekte für virtuelle Maschinen ab, wählt die Vorlage mit dem Namen VMTemplate01 aus und speichert das Objekt dann in der Variablen $VMTemplate.

Mit dem letzten Befehl wird eine VM-Konfiguration mit dem Namen VMConfig01 für die in $VMTemplate gespeicherte VM-Vorlage für die Bereitstellung in der in $HostGroup gespeicherten Hostgruppe erstellt, wobei der Kostenstellenwert 1234 angegeben wird.

Parameter

-AvailabilitySetNames

Gibt eine Liste der Namen von Verfügbarkeitsgruppen an.

Parametereigenschaften

Typ:

System.Collections.Generic.List`1[System.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

-CapabilityProfile

Gibt ein Funktionsprofilobjekt an.

Parametereigenschaften

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

Parametersätze

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

-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

-ComputerName

Gibt den Namen eines Computers an, den VMM in Ihrem Netzwerk eindeutig identifizieren kann. Gültige Formate sind:

  • FQDN (vollqualifizierter Domainname)
  • IPv4-Adresse
  • IPv6-Adresse
  • NetBIOS-Name

Parametereigenschaften

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

Parametersätze

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

-ComputerTier

Gibt ein Objekt auf Computerebene an.

Parametereigenschaften

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

Parametersätze

ComputerTier
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 Konfiguration des virtuellen Computers 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

FromTemplateOnly
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
ComputerTier
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-OnBehalfOfUser

Gibt den Namen eines Benutzers an. Dieses Cmdlet legt den Benutzer im Auftrag des Benutzers als Benutzer fest, den dieser Parameter angibt.

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. Mit diesem Cmdlet wird die Im Auftrag der Benutzerrolle als Benutzerrolle festgelegt, die dieser Parameter angibt. Verwenden Sie zum Abrufen eines Benutzerrollenobjekts das cmdlet Get-SCUserRole.

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

-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

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

-VMTemplate

Gibt ein VMM-Vorlagenobjekt an, das zum Erstellen virtueller Computer verwendet wird.

Parametereigenschaften

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

Parametersätze

FromTemplateOnly
Position:Named
Obligatorisch.:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
Cloud
Position:Named
Obligatorisch.:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
VMHostGroup
Position:Named
Obligatorisch.:True
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

VMConfiguration

Dieses Cmdlet gibt ein VMConfiguration-Objekt zurück.

Hinweise

  • Erfordert ein VMM-Vorlagenobjekt für virtuelle Maschinen, das Sie mit dem Cmdlet Get-SCVMTemplate abrufen können.