New-CMRequirementRuleOperatingSystemValue

  • Referencia
Módulo:
ConfigurationManager

Cree una regla de requisitos del sistema operativo para un tipo de implementación de aplicación.

Syntax

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

Description

Use este cmdlet para crear una regla de requisitos del sistema operativo 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 un sistema operativo por plataforma

En este ejemplo, primero se usa el cmdlet Get-CMGlobalCondition para obtener la condición global del sistema operativo predeterminada para dispositivos Windows que no son móviles. A continuación, usa el cmdlet Get-CMConfigurationPlatform para definir variables para dos plataformas para Windows Server 2016 y Windows Server 2019. A continuación, crea el objeto de regla de requisitos para incluir estas dos plataformas. Por último, pasa ese objeto de regla al cmdlet Set-CMScriptDeploymentType para agregar el 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 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

-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 del sistema operativo predeterminada para dispositivos Windows que no sean móviles. Por ejemplo: Get-CMGlobalCondition -Name "Operating System" | Where-Object PlatformType -eq 1.

Nota:

De forma predeterminada, Configuration Manager tiene dos condiciones globales denominadas Sistema operativo. Puede distinguirlos por tipo de dispositivo mediante la propiedad PlatformType :

PlatformType Tipo de dispositivo
1 Windows
2 Móvil
Type:IResultObject
Aliases:GlobalCondition
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Platform

Especifique una matriz de uno o varios objetos de plataforma del sistema operativo. Para obtener este objeto, use el cmdlet Get-CMConfigurationPlatform .

Type:IResultObject[]
Aliases:Platforms
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PlatformString

En lugar de usar el cmdlet Get-CMConfigurationPlatform con el parámetro Platform , puede usar este parámetro para especificar una matriz de una o varias cadenas ModelName conocidas. Por ejemplo, ModelName para la plataforma All Windows 11 y versiones posteriores (64 bits) es Windows/All_x64_Windows_11_and_higher_Clients.

Use un comando similar al siguiente para detectar el nombre del modelo de una plataforma:

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

Type:String[]
Aliases:PlatformStrings, PlatformCIUniqueID, PlatformCIUniqueIDs
Position:Named
Default value:None
Required:False
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:OneOf, NoneOf
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SelectFullPlatform

Use este parámetro para seleccionar todas las plataformas del tipo especificado.

Type:FullPlatformOption
Accepted values:Windows, Nokia, WindowsMobile, IOs, IOsDeepLink, Android, AndroidDeepLink, Mac, WinPhone8, WinPhone8DeepLink, MobileMsi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Salidas

System.Object