Freigeben über


New-SCVMHostGroup

Erstellt eine Hostgruppe, die Hostcomputer des virtuellen Computers, andere Hostgruppen oder Hostcluster enthalten kann.

Syntax

New-SCVMHostGroup
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [-Description <String>]
   [-ParentHostGroup <HostGroup>]
   [-EnableUnencryptedFileTransfer <Boolean>]
   [-InheritNetworkSettings <Boolean>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet New-SCVMHostGroup erstellt ein Hostgruppenobjekt, das Hostcomputer enthalten kann, auf denen mindestens ein virtueller Computer bereitgestellt wird, andere Hostgruppen oder Hostcluster.

Virtual Machine Manager (VMM) stellt eine standardmäßige übergeordnete Hostgruppe namens "Alle Hosts" bereit, der Sie untergeordnete Hostgruppen hinzufügen können. Eine neue Hostgruppe ist leer, bis Sie Hosts darin verschieben oder eine oder mehrere untergeordnete Hostgruppen erstellen. Hostgruppen sind in einer hierarchischen und anpassbaren Struktur organisiert. In der Hostgruppenstruktur ist das übergeordnete Element einer neuen Hostgruppe entweder die Standardstammhostgruppe (Alle Hosts) oder eine vom Benutzer erstellte Hostgruppe.

Eine Hostgruppe kann ein übergeordneter Container für eine der folgenden Aktionen sein:

  • Ein Host oder eine Gruppe von Hosts
  • Eine Hostgruppe oder eine Gruppe von Hostgruppen und Hosts innerhalb dieser Hostgruppen
  • Ein Hostcluster und Hosts (Knoten) innerhalb dieses Hostclusters

Hosts, die in einer Hostgruppe enthalten sind, weisen eine Hostpfadeigenschaft auf, die den Speicherort dieses Hosts in der Hostgruppenhierarchie anzeigt, wie in der folgenden Tabelle dargestellt:

Name Path

  • Alle Hosts alle Hosts
  • ChildHostGroup01 All Hosts\ChildHostGroup01
  • ChildHostGroup02 All Hosts\ChildHostGroup02
  • Neues Rechenzentrum alle Hosts\Neues Rechenzentrum
  • geschachtelt1 Alle Hosts\Neues Rechenzentrum\nested01
  • geschachtelt2 Alle Hosts\Neues Rechenzentrum\n\nested02

Beispiele

Beispiel 1: Erstellen einer Hostgruppe unter der Stammhostgruppe

PS C:\> New-SCVMHostGroup -VMMServer "VMMServer01.Contoso.com" -Name "HostGroup01"

Mit diesem Befehl wird eine Hostgruppe namens "HostGroup01" auf VMMServer01 in der domäne Contoso.com erstellt. Standardmäßig platziert VMM diese Hostgruppe unter der Stammhostgruppe, die als "Alle Hosts" bezeichnet wird.

Beispiel 2: Erstellen einer Hostgruppe unter einer angegebenen übergeordneten Hostgruppe

PS C:\> $ParentGroup = Get-SCVMHostGroup -Name "HostGroup01" 
PS C:\> New-SCVMHostGroup -Name "ChildGroup01" -ParentHostGroup $ParentGroup

Der erste Befehl ruft die Hostgruppe "HostGroup01" ab und speichert sie in der variablen $ParentGroup.

Der zweite Befehl erstellt eine Hostgruppe mit dem Namen ChildGroup01 und platziert sie unter der übergeordneten Hostgruppe, die in der variablen $ParentGroup gespeichert ist.

Parameter

-Description

Gibt eine Beschreibung für die Hostgruppe an.

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

-EnableUnencryptedFileTransfer

Gibt an, dass bei Festlegung auf "True" keine Verschlüsselung von Netzwerkdateiübertragungen erforderlich ist. Das Zulassen unverschlüsselter Netzwerkdateiübertragungen kann die Leistung verbessern, wenn weder der Quellhost noch der Zielhost Verschlüsselung erfordert.

Verwenden Sie diesen Parameter, um:

  • Aktivieren Sie unverschlüsselte Dateiübertragungen in oder aus der Bibliothek.
  • Aktivieren Sie unverschlüsselte Dateiübertragungen in, außerhalb oder innerhalb einer Hostgruppe.
Typ:Boolean
Aliase:AllowUnencryptedTransfers
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InheritNetworkSettings

Gibt an, dass bei Festlegung auf $True die Netzwerkeinstellungen für eine Hostgruppe dieselben Werte wie für das übergeordnete Element aufweisen.

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

-JobVariable

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

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

-Name

Gibt den Namen eines VMM-Objekts an.

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

-ParentHostGroup

Gibt die übergeordnete Hostgruppe an, die einen oder mehrere Hosts, Hostgruppen oder Hostcluster enthält.

Typ:HostGroup
Aliase:ParentVMHostGroup
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
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

-VMMServer

Gibt ein VMM-Serverobjekt an.

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

Ausgaben

HostGroup

Dieses Cmdlet gibt ein HostGroup--Objekt zurück.