New-CMRequirementRuleFreeDiskSpaceValue

  • Riferimento
Modulo:
ConfigurationManager

Creare una regola di requisito dello spazio su disco per un tipo di distribuzione dell'applicazione.

Sintassi

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

Descrizione

Usare questo cmdlet per creare una regola di requisito dello spazio su disco per un tipo di distribuzione dell'applicazione.

Dopo aver usato questo cmdlet, usare uno dei cmdlet Add- o Set- per i tipi di distribuzione. Passare questo oggetto regola di requisito ai parametri AddRequirement o RemoveRequirement .

Per altre informazioni, vedere Requisiti del tipo di distribuzione e Creare condizioni globali.

Nota

Eseguire Configuration Manager cmdlet dall'unità del sito Configuration Manager, ad esempio PS XYZ:\>. Per altre informazioni, vedere Introduzione.

Esempio

Esempio 1: Aggiungere una regola di requisito per lo spazio su disco

In questo esempio viene innanzitutto usato il cmdlet Get-CMGlobalCondition per ottenere la condizione globale di spazio su disco predefinita. Crea quindi l'oggetto regola dei requisiti per controllare che lo spazio disponibile nell'unità E: sia compreso tra 5 MB e 10 MB. Infine passa l'oggetto regola al cmdlet Set-CMScriptDeploymentType per aggiungere il requisito.

$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

Parametri

-DisableWildcardHandling

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

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

-DriverLetter

Quando si imposta il parametro PartitionOption su Special, usare questo parametro per specificare la lettera di unità. Ad esempio, "C:".

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

-ForceWildcardHandling

Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.

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

-InputObject

Specificare un oggetto condizione globale da usare come base per questa regola del requisito. Per ottenere questo oggetto, usare il cmdlet Get-CMGlobalCondition .

Nella maggior parte dei casi si userà la condizione globale di spazio su disco predefinita, ad esempio: 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

Specificare il tipo di partizione da valutare con questa regola del requisito:

  • Any: qualsiasi unità nel dispositivo
  • System: unità di sistema Windows
  • Special: unità specifica. Usare il parametro DriverLetter per specificare la lettera di unità.
Type:PartitionType
Accepted values:Any, System, Special
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-RuleOperator

Specificare l'operatore per confrontare l'impostazione del dispositivo con il valore previsto.

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

Specificare un numero intero o una matrice di valori previsti da confrontare. Questo valore è la quantità di spazio disponibile in megabyte (MB).

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

-Value2

Se si usa un oggetto RuleOperator come Between, usare questo parametro per specificare il valore superiore.

Ad esempio:

$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

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

System.Object