Partilhar via


New-CMRequirementRuleOperatingSystemValue

SYNOPSIS

Crie uma regra de exigência de SO para um tipo de implementação de aplicação.

SYNTAX

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

DESCRIPTION

Utilize este cmdlet para criar uma regra de exigência de SO para um tipo de implementação de aplicação.

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

Para obter mais informações, consulte os Requisitos do tipo de Implementação e Crie condições globais.

Nota

Executar cmdlets do Gestor de Configuração a partir da unidade do site do Gestor de Configuração, por exemplo PS XYZ:\> . Para mais informações, consulte a partida.

EXAMPLES

Exemplo 1: Adicionar uma regra de requisito para um SO por plataforma

Este exemplo utiliza primeiro o cmdlet Get-CMGlobalCondition para obter a condição global do sistema operativo padrão para dispositivos de Windows não móveis. Em seguida, utiliza o cmdlet Get-CMConfigurationPlatform para definir variáveis para duas plataformas para Windows Server 2016 e Windows Server 2019. Em seguida, cria o objeto de regra de exigência para incluir estas duas plataformas. Por fim, passa o objeto de regra ao set-CMScriptDeploymentType cmdlet para adicionar o requisito.

$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

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Este parâmetro processa caracteres wildcard e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-InputObject

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

Na maioria dos casos, utilizará a condição global do sistema operativo padrão para dispositivos de Windows não móveis. Por exemplo: Get-CMGlobalCondition -Name "Operating System" | Where-Object PlatformType -eq 1.

Nota

Por predefinição, o Gestor de Configuração tem duas condições globais chamadas sistema operativo. Pode distingui-los por tipo de dispositivo utilizando a propriedade PlatformType:

PlatformType Tipo de Dispositivo
1 Windows
2 Móvel
Type: IResultObject
Parameter Sets: (All)
Aliases: GlobalCondition

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

-Plataforma

Especifique um conjunto de um ou mais objetos da plataforma DE. Para obter este objeto, utilize o cmdlet 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

Em vez de utilizar o cmdlet Get-CMConfigurationPlatform com o parâmetro Plataforma, pode utilizar este parâmetro para especificar uma matriz de uma ou mais cadeias CI_ID conhecidas. Por exemplo, o CI_ID para a plataforma All Windows Server 2019 e superior (64-bit) é 287650 .

Utilize um comando semelhante ao seguinte para descobrir o CI_ID para uma plataforma:

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

-Operador de Regras

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

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

Utilize este parâmetro para selecionar todas as plataformas do tipo especificado.

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

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Para mais informações, consulte about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

Sistema.Objeto

NOTAS

Get-CMConfigurationPlatform

Novo CMRequirementRuleActiveDirectorySiteValue Novo CMRequirementRuleBooleanValue Novo CMRequirementRuleCMSiteValue Novo CMRequirementRuleCommonValue Novo CMRequirementRuleDeviceOwnershipValue Novo CMRequirementRuleExistential Nova CmRequirementRuleExpressão Novo CMRequirementRuleFileAttributeValue Novo CMRequirementRuleFilePermissionValue New-CMRequirementRuleFreeDiskSpaceValue Novo CMRequirementRuleInputTypeValue New-CMRequirementRuleOperatingSystemLanguageValue Novo CMRequirementRuleOUValue Novo CMRequirementRuleRegistryKeyPermissionValue Novo CMRequirementRuleScreenResolutionValue Obter-CMGlobalCondição Requisitos do tipo de implantação Criar condições globais