Share via

New-CMRequirementRuleFreeDiskSpaceValue

  • Referência
Módulo:
ConfigurationManager

Crie uma regra de requisito de espaço em disco para um tipo de implantação de aplicativo.

Syntax

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

Description

Use este cmdlet para criar uma regra de requisito de espaço em disco para um tipo de implantação de aplicativo.

Depois de usar esse cmdlet, use um dos cmdlets Adicionar ou Definir para tipos de implantação. Passe esse objeto de regra de requisito para os parâmetros AddRequirement ou RemoveRequirement .

Para obter mais informações, consulte Requisitos de tipo de implantação e Criar condições globais.

Observação

Execute Configuration Manager cmdlets da unidade do site Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, confira introdução.

Exemplos

Exemplo 1: Adicionar uma regra de requisito para espaço em disco

Este exemplo usa primeiro o cmdlet Get-CMGlobalCondition para obter a condição global de espaço de disco padrão. Em seguida, ele cria o objeto de regra de requisito para verificar o espaço livre no E: a unidade está entre 5 MB e 10 MB. Por fim, ele passa esse objeto de regra para o cmdlet Set-CMScriptDeploymentType para adicionar o 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

Parâmetros

-DisableWildcardHandling

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.

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

-DriverLetter

Ao definir o parâmetro PartitionOption como Special, use esse parâmetro para especificar a letra da unidade. Por exemplo, "C:".

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

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você não pode combiná-lo com DisableWildcardHandling.

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

-InputObject

Especifique um objeto de condição global a ser usado como base para essa regra de requisito. Para obter esse objeto, use o cmdlet Get-CMGlobalCondition .

Na maioria das instâncias, você usará a condição global de espaço de disco padrão, por exemplo: 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

Especifique o tipo de partição a ser avaliado com essa regra de requisito:

  • Any: qualquer unidade no dispositivo
  • System: a unidade do sistema Windows
  • Special: uma unidade específica. Use o parâmetro DriverLetter para especificar a letra da unidade.
Type:PartitionType
Accepted values:Any, System, Special
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-RuleOperator

Especifique o operador para comparar a configuração do dispositivo com o valor esperado.

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

Especifique um inteiro ou uma matriz de valores esperados a serem comparados. Esse valor é a quantidade de espaço livre em megabytes (MB).

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

-Value2

Se você usar um RuleOperator como Between, use este parâmetro para especificar o valor superior.

Por exemplo:

$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

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object