Freigeben über


Add-SCCustomPlacementRule

Fügt der Platzierungskonfiguration für eine Hostgruppe eine benutzerdefinierte Platzierungsregel hinzu.

Syntax

Add-SCCustomPlacementRule
   -PlacementConfiguration <PlacementConfigurationSettings>
   -CustomPropertyName <String>
   [-ShouldMatch]
   [-VMMServer <ServerConnection>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-SCCustomPlacementRule
   -PlacementConfiguration <PlacementConfigurationSettings>
   -CustomPropertyName <String>
   [-ShouldNotMatch]
   [-VMMServer <ServerConnection>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-SCCustomPlacementRule
   -PlacementConfiguration <PlacementConfigurationSettings>
   -CustomPropertyName <String>
   [-MustMatch]
   [-VMMServer <ServerConnection>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-SCCustomPlacementRule
   -PlacementConfiguration <PlacementConfigurationSettings>
   -CustomPropertyName <String>
   [-MustNotMatch]
   [-VMMServer <ServerConnection>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Add-SCCustomPlacementRule fügt der Platzierungskonfiguration für eine Hostgruppe eine benutzerdefinierte Platzierungsregel hinzu.

Beispiele

Beispiel 1: Hinzufügen einer neuen benutzerdefinierten Platzierungsregel zu einer Platzierungskonfiguration für eine Hostgruppe

PS C:\> $HostGroup = Get-SCVMHostGroup "HostGroup01"
PS C:\> $PlacementConfig = Get-SCPlacementConfiguration -VMHostGroup $HostGroup
PS C:\> $CustomProp = Get-SCCustomProperty -Name "Cost Center"
PS C:\> Add-SCCustomPlacementRule -PlacementConfiguration $PlacementConfig -MustMatch -CustomProperty $CustomProp

Der erste Befehl ruft das Hostgruppenobjekt namens HostGroup01 ab und speichert das Objekt in der $HostGroup Variablen.

Der zweite Befehl ruft das Platzierungskonfigurationsobjekt für die in $HostGroup gespeicherte Hostgruppe ab und platziert das Objekt in der $PlacementConfig Variablen.

Der dritte Befehl ruft das benutzerdefinierte Eigenschaftsobjekt namens Cost Center ab und speichert das Objekt in der $CustomProp Variablen.

Mit dem letzten Befehl wird der in $PlacementConfig gespeicherten Platzierungskonfiguration eine benutzerdefinierte Platzierungsregel hinzugefügt.

Parameter

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-CustomPropertyName

Gibt den Namen für eine benutzerdefinierte Eigenschaft an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
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

-MustMatch

Gibt an, dass der Eigenschaftswert des virtuellen Computers mit dem Host übereinstimmen muss.

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

-MustNotMatch

Gibt an, dass der Eigenschaftswert des virtuellen Computers nicht mit dem Host übereinstimmen darf.

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

-PlacementConfiguration

Gibt ein Platzierungskonfigurationsobjekt an.

Typ:PlacementConfigurationSettings
Position:Named
Standardwert:None
Erforderlich:True
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

-ShouldMatch

Gibt an, dass der Eigenschaftswert des virtuellen Computers mit dem Host übereinstimmen soll.

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

-ShouldNotMatch

Gibt an, dass der Eigenschaftswert des virtuellen Computers nicht mit dem Host übereinstimmt.

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

-VMMServer

Gibt ein VMM-Serverobjekt an.

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

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Ausgaben

CustomPlacementRule

Dieses Cmdlet gibt ein CustomPlacementRule-Objekt zurück.