New-CMRequirementRuleFreeDiskSpaceValue

  • Referência
Módulo:
ConfigurationManager

Criar uma regra de requisito de espaço em disco para um tipo de implementação de aplicação.

Sintaxe

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

Description

Utilize este cmdlet para criar uma regra de requisito de espaço em disco para um tipo de implementação de aplicação.

Depois de utilizar este cmdlet, utilize um dos cmdlets Add- ou Set- para tipos de implementação. Transmita este objeto de regra de requisito para os parâmetros AddRequirement ou RemoveRequirement .

Para obter mais informações, veja Requisitos do tipo de implementação e Criar condições globais.

Observação

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

Exemplos

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

Este exemplo utiliza primeiro o cmdlet Get-CMGlobalCondition para obter a condição global espaço em disco predefinida. Em seguida, cria o objeto de regra de requisito para verificar se o espaço livre na unidade E: está entre 5 MB e 10 MB. Por fim, transmite 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

Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DriverLetter

Quando definir o parâmetro PartitionOption como Special, utilize este parâmetro para especificar a letra de unidade. Por exemplo, "C:".

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InputObject

Especifique um objeto de condição global a utilizar como base para esta regra de requisito. Para obter este objeto, utilize o cmdlet Get-CMGlobalCondition .

Na maioria das instâncias, irá utilizar a condição global de Espaço em disco predefinida, por exemplo: Get-CMGlobalCondition -Name "Disk space".

Tipo:IResultObject
Aliases:GlobalCondition
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-PartitionOption

Especifique o tipo de partição a avaliar com esta regra de requisito:

  • Any: Qualquer unidade no dispositivo
  • System: a unidade do sistema Windows
  • Special: uma unidade específica. Utilize o parâmetro DriverLetter para especificar a letra de unidade.
Tipo:PartitionType
Valores aceitos:Any, System, Special
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RuleOperator

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

Tipo:RuleExpressionOperator
Valores aceitos:IsEquals, NotEquals, GreaterThan, GreaterEquals, LessThan, LessEquals, Between
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Value1

Especifique um número inteiro ou uma matriz de valores esperados a comparar. Este valor é a quantidade de espaço livre em megabytes (MB).

Tipo:Int64[]
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Value2

Se utilizar um RuleOperator como Between, utilize este parâmetro para especificar o valor superior.

Por exemplo:

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

Tipo:Int64
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object