New-CMRequirementRuleFreeDiskSpaceValue

  • Referenz
Modul:
ConfigurationManager

Erstellen Sie eine Regel zur Speicherplatzanforderung für einen Anwendungsbereitstellungstyp.

Syntax

New-CMRequirementRuleFreeDiskSpaceValue
   [-DriverLetter <String>]
   -PartitionOption <PartitionType>
   -RuleOperator <RuleExpressionOperator>
   -Value1 <Int64[]>
   [-Value2 <Int64>]
   [-InputObject] <IResultObject>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Beschreibung

Verwenden Sie dieses Cmdlet, um eine Regel zur Speicherplatzanforderung für einen Anwendungsbereitstellungstyp zu erstellen.

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-Websitelaufwerk aus, z. PS XYZ:\>B. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1: Hinzufügen einer Anforderungsregel für Speicherplatz

In diesem Beispiel wird zunächst das Cmdlet Get-CMGlobalCondition verwendet, um die globale Standardbedingung für Den Datenträgerspeicher abzurufen. Anschließend wird das Anforderungsregelobjekt erstellt, um den freien Speicherplatz auf laufwerk E zu überprüfen : Zwischen 5 MB und 10 MB. Schließlich wird dieses Regelobjekt an das Cmdlet Set-CMScriptDeploymentType übergeben, um die Anforderung hinzuzufügen.

$value1 = 5

$value2 = 10

$myGC = Get-CMGlobalCondition -Name "Disk space"

$myRule = $myGC | New-CMRequirementRuleFreeDiskSpaceValue -PartitionOption Special -RuleOperator Between -Value1 $value1 -Value2 $value2 -DriverLetter "E:"

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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DriverLetter

Wenn Sie den PartitionOption-Parameter auf Specialfestlegen, verwenden Sie diesen Parameter, um den Laufwerkbuchstaben anzugeben. Beispiel: "C:".

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 .

In den meisten Fällen verwenden Sie die globale Standardbedingung für den Speicherplatz , z. B.: Get-CMGlobalCondition -Name "Disk space".

Type:IResultObject
Aliases:GlobalCondition
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PartitionOption

Geben Sie den Typ der Partition an, die mit dieser Anforderungsregel ausgewertet werden soll:

  • Any: Beliebiges Laufwerk auf dem Gerät
  • System: Das Windows-Systemlaufwerk
  • Special: Ein bestimmtes Laufwerk. Verwenden Sie den DriverLetter-Parameter , um den Laufwerkbuchstaben anzugeben.
Type:PartitionType
Accepted values:Any, System, Special
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-RuleOperator

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

Type:RuleExpressionOperator
Accepted values:IsEquals, NotEquals, GreaterThan, GreaterEquals, LessThan, LessEquals, Between
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Value1

Geben Sie eine ganze Zahl oder ein Array mit erwarteten Werten an, die verglichen werden sollen. Dieser Wert ist die Menge des freien Speicherplatzes in Megabyte (MB).

Type:Int64[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Value2

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

Beispiel:

$myRule = New-CMRequirementRuleFreeDiskSpaceValue -InputObject $GC -PartitionOption System -RuleOperator Between -Value1 1024 -Value2 2048

Type:Int64
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

System.Object