Dela via


New-CMRequirementRuleOperatingSystemValue

SYNOPSIS

Skapa en regel för operativsystemkrav för en programdistributionstyp.

SYNTAX

New-CMRequirementRuleOperatingSystemValue [-Platform <IResultObject[]>] [-PlatformString <String[]>]
 -RuleOperator <RuleExpressionOperator> [-SelectFullPlatform <FullPlatformOption>]
 [-InputObject] <IResultObject> [-DisableWildcardHandling] [-ForceWildcardHandling] [<CommonParameters>]

DESCRIPTION

Använd den här cmdleten för att skapa en regel för operativsystemkrav för en programdistributionstyp.

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 ett operativsystem per plattform

I det här exemplet används först cmdleten Get-CMGlobalCondition för att hämta det globala standardvillkoret operativsystem för icke-mobila Windows enheter. Den använder sedan cmdleten Get-CMConfigurationPlatform för att definiera variabler för två plattformar för Windows Server 2016 och Windows Server 2019. Därefter skapar den kravregelobjektet för att inkludera dessa två plattformar. Slutligen skickar den regelobjektet till cmdleten Set-CMScriptDeploymentType för att lägga till kravet.

$myGC = Get-CMGlobalCondition -Name "Operating System" | Where-Object PlatformType -eq 1

$platformA = Get-CMConfigurationPlatform -Name "All Windows Server 2019 and higher (64-bit)"

$platformB = Get-CMConfigurationPlatform -Name "All Windows Server 2016 and higher (64-bit)"

$myRule = $myGC | New-CMRequirementRuleOperatingSystemValue -RuleOperator OneOf -Platform $platformA, $platformB

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.

I de flesta fall använder du det globala standardvillkoret Operativsystem för icke-mobila Windows enheter. Exempel: Get-CMGlobalCondition -Name "Operating System" | Where-Object PlatformType -eq 1.

Anteckning

Som standard har Konfigurationshanteraren två globala villkor med namnet Operativsystem. Du kan särskilja dem efter enhetstyp med hjälp av egenskapen PlatformType:

PlatformType Enhetstyp
1 Windows
2 Mobilt
Type: IResultObject
Parameter Sets: (All)
Aliases: GlobalCondition

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

-Plattform

Ange en matris med ett eller flera os-plattformsobjekt. Hämta det här objektet med cmdleten Get-CMConfigurationPlatform.

Type: IResultObject[]
Parameter Sets: (All)
Aliases: Platforms

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

-PlatformString

I stället för att använda cmdleten Get-CMConfigurationPlatform med parametern Platform kan du använda den här parametern för att ange en matris med en eller flera kända CI_ID strängar. Till exempel är CI_ID för plattformen Alla Windows Server 2019 och senare (64-bitars) 287650 .

Använd ett kommando som liknar följande för att identifiera CI_ID för en plattform:

Get-CMConfigurationPlatform -Name "*Server 2019*" | Select-Object LocalizedDisplayName, CI_ID

Type: String[]
Parameter Sets: (All)
Aliases: PlatformStrings, PlatformCIUniqueID, PlatformCIUniqueIDs

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: OneOf, NoneOf

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

-SelectFullPlatform

Använd den här parametern för att välja alla plattformar av den angivna typen.

Type: FullPlatformOption
Parameter Sets: (All)
Aliases:
Accepted values: Windows, Nokia, WindowsMobile, IOs, IOsDeepLink, Android, AndroidDeepLink, Mac, WinPhone8, WinPhone8DeepLink, MobileMsi

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

Get-CMConfigurationPlatform

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