Dela via


New-CMRequirementRuleCommonValue

SYNOPSIS

Skapa en kravregel för att utvärdera ett värdebaserat globalt villkor för en programdistributionstyp.

SYNTAX

New-CMRequirementRuleCommonValue [-PropertyForAssembly <AssemblyProperty>]
 [-PropertyForFileFolder <FileFolderProperty>] -RuleOperator <RuleExpressionOperator> -Value1 <String[]>
 [-Value2 <String[]>] [-InputObject] <IResultObject> [-DisableWildcardHandling] [-ForceWildcardHandling]
 [<CommonParameters>]

DESCRIPTION

Använd den här cmdleten för att skapa en kravregel för en programdistributionstyp som utvärderar ett globalt villkor med regeltypen Värde.

När du har använder den här cmdleten använder du en av cmdletarna Add- eller Set- för distributionstyper. Skicka det här kravregelobjektet till parametrarna AddRequirement eller RemoveRequirement.

Mer information finns i Krav för distributionstyp och Skapa globala villkor.

Anteckning

Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenhet, till exempel PS XYZ:\> . Mer information finns i Komma igång.

EXAMPLES

Exempel 1: Lägg till en kravregel för antalet processorer

I det här exemplet används först cmdleten Get-CMGlobalCondition för att hämta det globala standardvillkoret Antal processorer. Därefter skapar den kravregelobjektet för att utvärdera det globala villkoret på enheten så att det är större än eller lika med två. Slutligen skickar den regelobjektet till cmdleten Set-CMScriptDeploymentType för att lägga till kravet.

Med andra ord måste enheten ha minst två processorer för att appen ska kunna installeras.

$myGC = Get-CMGlobalCondition -Name "Number of processors"
$myRule = New-CMRequirementRuleCommonValue -GlobalCondition $myGC -Value1 "2" -RuleOperator GreaterEquals

Set-CMScriptDeploymentType -ApplicationName "Central app" -DeploymentTypeName "Install" -AddRequirement $myRule

PARAMETERS

-DisableWildcardHandling

Den här parametern behandlar jokertecken som värden för literaltecken. Du kan inte kombinera den med ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Den här parametern bearbetar jokertecken och kan leda till oväntat beteende (rekommenderas inte). Du kan inte kombinera den med DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-InputObject

Ange ett globalt villkorsobjekt som ska användas som grund för den här kravregeln. Hämta det här objektet med hjälp av cmdleten Get-CMGlobalCondition.

Det globala villkoret måste ha stöd för regeltypen Värde.

Type: IResultObject
Parameter Sets: (All)
Aliases: GlobalCondition

Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-PropertyForAssembly

Om det globala villkoret stöder det anger du sammansättningsegenskapen som ska jämföras med det förväntade värdet.

Type: AssemblyProperty
Parameter Sets: (All)
Aliases:
Accepted values: Culture, Version, PublicKeyToken

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

-PropertyForFileFolder

Om det globala villkoret stöder det anger du en fil- eller mappegenskap som ska jämföras med det förväntade värdet.

Ett exempel:

$myRule = New-CMRequirementRuleCommonValue -GlobalCondition $myGC -PropertyForFileFolder DateCreated -Value1 "2018-08-07T05:32:45Z" -RuleOperator GreaterEquals

Type: FileFolderProperty
Parameter Sets: (All)
Aliases:
Accepted values: Size, Version, DateCreated, DateModified, Company, ProductName, SHA1Hash, Permissions, Attributes

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

-RuleOperator

Ange operatorn för att jämföra enhetens inställning med det förväntade värdet.

Type: RuleExpressionOperator
Parameter Sets: (All)
Aliases:
Accepted values: And, Or, Other, IsEquals, NotEquals, GreaterThan, LessThan, Between, NotBetween, GreaterEquals, LessEquals, BeginsWith, NotBeginsWith, EndsWith, NotEndsWith, Contains, NotContains, AllOf, OneOf, NoneOf, SetEquals, SubsetOf, ExcludesAll

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

-Value1

Ange en sträng eller matris med förväntade värden att jämföra.

Type: String[]
Parameter Sets: (All)
Aliases:

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

-Value2

Om du använder en RuleOperator som Between använder du den här parametern för att ange det övre värdet.

Ett exempel:

$myRule = New-CMRequirementRuleCommonValue -GlobalCondition $GC -PropertyForFileFolder Size -Value1 200 -Value2 300 -RuleOperator Between

Type: String[]
Parameter Sets: (All)
Aliases:

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

CommonParameters

Denna cmdlet har stöd för parametrarna -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

System.Object

ANTECKNINGAR

New-CMRequirementRuleActiveDirectorySiteValue New-CMRequirementRuleBooleanValue New-CMRequirementRuleCMSiteValue New-CMRequirementRuleDeviceOwnershipValue New-CMRequirementRuleExistential New-CMRequirementRuleExpression New-CMRequirementRuleFileAttributeValue New-CMRequirementRuleFilePermissionValue New-CMRequirementRuleFreeDiskSpaceValue New-CMRequirementRuleInputTypeValue New-CMRequirementRuleOperatingSystemLanguageValue New-CMRequirementRuleOperatingSystemValue New-CMRequirementRuleOUValue New-CMRequirementRuleRegistryKeyPermissionValue New-CMRequirementRuleScreenResolutionValue Get-CMGlobalCondition Krav för distributionstyp Skapa globala villkor