New-CMRequirementRuleFreeDiskSpaceValue
Crie uma regra de requisito de espaço em disco para um tipo de implantação de aplicativo.
Sintaxe
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.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-DriverLetter
Ao definir o parâmetro PartitionOption como Special
, use esse parâmetro para especificar a letra da 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
Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você 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 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"
.
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 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.
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 configuraçã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 inteiro ou uma matriz de valores esperados a serem comparados. Esse 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 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
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
Links Relacionados
- New-CMRequirementRuleActiveDirectorySiteValue
- New-CMRequirementRuleBooleanValue
- New-CMRequirementRuleCMSiteValue
- New-CMRequirementRuleCommonValue
- New-CMRequirementRuleDeviceOwnershipValue
- New-CMRequirementRuleExistential
- New-CMRequirementRuleExpression
- New-CMRequirementRuleFileAttributeValue
- New-CMRequirementRuleFilePermissionValue
- New-CMRequirementRuleInputTypeValue
- New-CMRequirementRuleOperatingSystemLanguageValue
- New-CMRequirementRuleOperatingSystemValue
- New-CMRequirementRuleOUValue
- New-CMRequirementRuleRegistryKeyPermissionValue
- New-CMRequirementRuleScreenResolutionValue
- Get-CMGlobalCondition
- Requisitos de tipo de implantação
- Criar condições globais
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de