Freigeben über

New-CMRequirementRuleCommonValue

  • Referenz
Modul:
ConfigurationManager

Erstellen Sie eine Anforderungsregel, um eine wertbasierte globale Bedingung für einen Anwendungsbereitstellungstyp auszuwerten.

Syntax

New-CMRequirementRuleCommonValue
   [-PropertyForAssembly <AssemblyProperty>]
   [-PropertyForFileFolder <FileFolderProperty>]
   -RuleOperator <RuleExpressionOperator>
   -Value1 <String[]>
   [-Value2 <String[]>]
   [-InputObject] <IResultObject>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Beschreibung

Verwenden Sie dieses Cmdlet, um eine Anforderungsregel für einen Anwendungsbereitstellungstyp zu erstellen, der eine globale Bedingung mit einem Wertregeltyp auswertet.

Nachdem Sie dieses Cmdlet verwendet haben, verwenden Sie eines der Add- oder Set-Cmdlets für Bereitstellungstypen. Übergeben Sie dieses Anforderungsregelobjekt entweder an die Parameter AddRequirement oder RemoveRequirement .

Weitere Informationen finden Sie unter Anforderungen für den Bereitstellungstyp und Erstellen globaler Bedingungen.

Hinweis

Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1: Hinzufügen einer Anforderungsregel für die Anzahl von Prozessoren

In diesem Beispiel wird zunächst das Cmdlet Get-CMGlobalCondition verwendet, um die globale Standardbedingung Anzahl von Prozessoren abzurufen. Als Nächstes wird das Anforderungsregelobjekt erstellt, um die globale Bedingung auf dem Gerät so auszuwerten, dass sie größer als oder gleich 2 ist. Schließlich wird dieses Regelobjekt an das Cmdlet Set-CMScriptDeploymentType übergeben, um die Anforderung hinzuzufügen.

Anders ausgedrückt: Das Gerät muss über mindestens zwei Prozessoren verfügen, damit die App installiert werden kann.

$myGC = Get-CMGlobalCondition -Name "Number of processors"
$myRule = New-CMRequirementRuleCommonValue -GlobalCondition $myGC -Value1 "2" -RuleOperator GreaterEquals

Set-CMScriptDeploymentType -ApplicationName "Central app" -DeploymentTypeName "Install" -AddRequirement $myRule

Parameter

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

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

-ForceWildcardHandling

Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.

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

-InputObject

Geben Sie ein globales Bedingungsobjekt an, das als Grundlage für diese Anforderungsregel verwendet werden soll. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMGlobalCondition .

Die globale Bedingung muss den RegeltypWert unterstützen.

Typ:IResultObject
Aliase:GlobalCondition
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-PropertyForAssembly

Wenn die globale Bedingung dies unterstützt, geben Sie die Assemblyeigenschaft an, die mit dem erwarteten Wert verglichen werden soll.

Typ:AssemblyProperty
Zulässige Werte:Culture, Version, PublicKeyToken
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PropertyForFileFolder

Wenn die globale Bedingung dies unterstützt, geben Sie eine Datei- oder Ordnereigenschaft an, die mit dem erwarteten Wert verglichen werden soll.

Zum Beispiel:

$myRule = New-CMRequirementRuleCommonValue -GlobalCondition $myGC -PropertyForFileFolder DateCreated -Value1 "2018-08-07T05:32:45Z" -RuleOperator GreaterEquals

Typ:FileFolderProperty
Zulässige Werte:Size, Version, DateCreated, DateModified, Company, ProductName, SHA1Hash, Permissions, Attributes
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RuleOperator

Geben Sie den Operator an, der die Einstellung des Geräts mit dem erwarteten Wert vergleichen soll.

Typ:RuleExpressionOperator
Zulässige Werte:And, Or, Other, IsEquals, NotEquals, GreaterThan, LessThan, Between, NotBetween, GreaterEquals, LessEquals, BeginsWith, NotBeginsWith, EndsWith, NotEndsWith, Contains, NotContains, AllOf, OneOf, NoneOf, SetEquals, SubsetOf, ExcludesAll
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Value1

Geben Sie eine Zeichenfolge oder ein Array von erwarteten Werten an, die verglichen werden sollen.

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

-Value2

Wenn Sie einen RuleOperator wie Betweenverwenden, verwenden Sie diesen Parameter, um den oberen Wert anzugeben.

Zum Beispiel:

$myRule = New-CMRequirementRuleCommonValue -GlobalCondition $GC -PropertyForFileFolder Size -Value1 200 -Value2 300 -RuleOperator Between

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

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

System.Object