New-CMRequirementRuleFreeDiskSpaceValue
Cree una regla de requisito de espacio en disco para un tipo de implementación de aplicación.
Syntax
New-CMRequirementRuleFreeDiskSpaceValue
[-DriverLetter <String>]
-PartitionOption <PartitionType>
-RuleOperator <RuleExpressionOperator>
-Value1 <Int64[]>
[-Value2 <Int64>]
[-InputObject] <IResultObject>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>]
Description
Use este cmdlet para crear una regla de requisito de espacio en disco para un tipo de implementación de aplicación.
Después de usar este cmdlet, use uno de los cmdlets Add- o Set- para los tipos de implementación. Pase este objeto de regla de requisito a los parámetros AddRequirement o RemoveRequirement .
Para obtener más información, vea Requisitos del tipo de implementación y Creación de condiciones globales.
Nota:
Ejecute cmdlets de Configuration Manager desde la unidad de sitio Configuration Manager, por ejemploPS XYZ:\>
. Para obtener más información, consulte Introducción.
Ejemplos
Ejemplo 1: Adición de una regla de requisitos para el espacio en disco
En este ejemplo se usa primero el cmdlet Get-CMGlobalCondition para obtener la condición global de espacio en disco predeterminada. A continuación, crea el objeto de regla de requisitos para comprobar el espacio libre en la unidad E: está entre 5 MB y 10 MB. Por último, pasa ese objeto de regla al cmdlet Set-CMScriptDeploymentType para agregar el 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 los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DriverLetter
Cuando establezca el parámetro Special
PartitionOption en , use este parámetro para especificar la letra de unidad. Por ejemplo, "C:"
.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Especifique un objeto de condición global que se usará como base para esta regla de requisitos. Para obtener este objeto, use el cmdlet Get-CMGlobalCondition .
En la mayoría de los casos, usará la condición global de espacio en disco predeterminada, por ejemplo: 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 el tipo de partición que se va a evaluar con esta regla de requisitos:
Any
: cualquier unidad del dispositivoSystem
: la unidad del sistema de WindowsSpecial
: una unidad específica. Use el parámetro DriverLetter para especificar la letra de unidad.
Type: | PartitionType |
Accepted values: | Any, System, Special |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RuleOperator
Especifique el operador para comparar la configuración del dispositivo con el 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 un entero o una matriz de valores esperados que se van a comparar. Este valor es la cantidad de espacio libre en megabytes (MB).
Type: | Int64[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Value2
Si usa un RuleOperator como Between
, use este parámetro para especificar el valor superior.
Por ejemplo:
$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
Salidas
System.Object
Vínculos 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 del tipo de implementación
- Crear condiciones globales
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de