New-SCVMHostGroup

Erstellt eine Hostgruppe, die Hostcomputer der virtuellen Maschine, andere Hostgruppen oder Hostcluster enthalten kann.

Syntax

Default (Standardwert)

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

Beschreibung

Mit dem Cmdlet New-SCVMHostGroup wird ein Hostgruppenobjekt erstellt, das Hostcomputer, auf denen ein oder mehrere virtuelle Computer bereitgestellt werden, andere Hostgruppen oder Hostcluster enthalten kann.

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

Eine Hostgruppe kann ein übergeordneter Container für einen der folgenden Elemente 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, verfügen über eine Hostpfadeigenschaft, die die Position dieses Hosts in der Hostgruppenhierarchie anzeigt, wie in der folgenden Tabelle dargestellt:

Name Pfad

  • Alle Hosts Alle Hosts
  • ChildHostGroup01 Alle Hosts\ChildHostGroup01
  • ChildHostGroup02 Alle Hosts\ChildHostGroup02
  • Neues Datencenter Alle Hosts\Neues Datencenter
  • nested1 Alle Hosts\Neues Datencenter\nested01
  • nested2 Alle Hosts\Neue Datencenter-\nested\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 mit dem Namen HostGroup01 auf VMMServer01 in der Domäne Contoso.com erstellt. Standardmäßig platziert VMM diese Hostgruppe unter der Stammhostgruppe mit dem Namen Alle Hosts.

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 mit dem Namen 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.

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

-EnableUnencryptedFileTransfer

Gibt an, dass bei Festlegung von True keine Verschlüsselung für Netzwerkdateiübertragungen erforderlich ist. Das Zulassen unverschlüsselter Dateiübertragungen über das Netzwerk kann die Leistung verbessern, wenn weder der Quellhost noch der Zielhost eine Verschlüsselung erfordert.

Verwenden Sie diesen Parameter für Folgendes:

  • Aktivieren Sie unverschlüsselte Dateiübertragungen in die oder aus der Bibliothek.
  • Aktivieren Sie unverschlüsselte Dateiübertragungen in, aus oder innerhalb einer Hostgruppe.

Parametereigenschaften

Typ:Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:AllowUnencryptedTransfers

Parametersätze

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

-InheritNetworkSettings

Gibt an, dass die Netzwerkeinstellungen für eine Hostgruppe dieselben Werte aufweisen, wenn sie auf $True festgelegt sind.

Parametereigenschaften

Typ:Boolean
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 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

-ParentHostGroup

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

Parametereigenschaften

Typ:HostGroup
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Übergeordnete VMHostGruppe

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:True
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

-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

HostGroup

Dieses Cmdlet gibt ein HostGroup-Objekt zurück.