Compartilhar via

New-CMRequirementRuleOperatingSystemValue

  • Referência
Módulo:
ConfigurationManager

Criar uma regra de requisito de SO para um tipo de implementação de aplicação.

Sintaxe

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

Description

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

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

Para obter mais informações, veja Requisitos do tipo de implementação e Criar condições globais.

Observação

Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, veja Introdução.

Exemplos

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 predefinida para dispositivos Windows não móveis. Em seguida, utiliza o cmdlet Get-CMConfigurationPlatform para definir variáveis para duas plataformas para o Windows Server 2016 e Windows Server 2019. Em seguida, cria o objeto de regra de requisito para incluir estas duas plataformas. Por fim, transmite esse objeto de regra para o cmdlet Set-CMScriptDeploymentType 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)" -Fast

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

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

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

Parâmetros

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. 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

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). 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 utilizar como base para esta regra de requisito. Para obter este objeto, utilize o cmdlet Get-CMGlobalCondition .

Na maioria das instâncias, irá utilizar a condição global do sistema operativo predefinida para dispositivos Windows não móveis. Por exemplo: Get-CMGlobalCondition -Name "Operating System" | Where-Object PlatformType -eq 1.

Observação

Por predefinição, o Configuration Manager tem duas condições globais denominadas Sistema operativo. Pode distingui-los por tipo de dispositivo com a propriedade PlatformType :

PlatformType Tipo de dispositivo
1 Windows
2 Dispositivo móvel
Tipo:IResultObject
Aliases:GlobalCondition
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Platform

Especifique uma matriz de um ou mais objetos da plataforma do SO. Para obter este objeto, utilize o cmdlet Get-CMConfigurationPlatform .

Tipo:IResultObject[]
Aliases:Platforms
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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 modelName conhecidas. Por exemplo, o ModelName para a plataforma Todos os Windows 11 e superiores (64 bits) é Windows/All_x64_Windows_11_and_higher_Clients.

Utilize um comando semelhante ao seguinte para descobrir o nome do modelo de uma plataforma:

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

Tipo:String[]
Aliases:PlatformStrings, PlatformCIUniqueID, PlatformCIUniqueIDs
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RuleOperator

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

Tipo:RuleExpressionOperator
Valores aceitos:OneOf, NoneOf
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SelectFullPlatform

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

Tipo:FullPlatformOption
Valores aceitos:Windows, Nokia, WindowsMobile, IOs, IOsDeepLink, Android, AndroidDeepLink, Mac, WinPhone8, WinPhone8DeepLink, MobileMsi
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