New-CMRequirementRuleOUValue

Cree una regla de requisitos de unidad organizativa (UO) de Active Directory para un tipo de implementación de aplicación.

Sintaxis

New-CMRequirementRuleOUValue
   -OrganizationalUnit <Hashtable[]>
   -RuleOperator <RuleExpressionOperator>
   [-InputObject] <IResultObject>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

Use este cmdlet para crear una regla de requisitos de unidad organizativa (OU) de Active Directory 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 de Configuration Manager, por ejemplo PS XYZ:\>. Para obtener más información, consulte Introducción.

Ejemplos

Ejemplo 1: Adición de una regla de requisitos para las unidades organizativas de Active Directory

En este ejemplo se usa primero el cmdlet Get-CMGlobalCondition para obtener la condición global de unidad organizativa (OU) predeterminada. A continuación, define varias variables para dos unidades organizativas de Active Directory. A continuación, crea el objeto de regla de requisitos. Por último, pasa ese objeto de regla al cmdlet Set-CMScriptDeploymentType para agregar el requisito.

$myGC = Get-CMGlobalCondition -Name "Organizational unit (OU)"

$ouName1 = "CN=Computers,DC=Contoso,DC=Com"

$ouName2 = "CN=Servers,DC=Contoso,DC=Com"

$ouA = @{"OU"=$ouName1; "IsIncludeSubOU"=$true}

$ouB = @{"OU"=$ouName2; "IsIncludeSubOU"=$false}

$myRule = $myGC | New-CMRequirementRuleOUValue -RuleOperator NoneOf -OU $ouA,$ouB

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.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ForceWildcardHandling

Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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 de unidad organizativa (UO) predeterminada, por ejemplo: Get-CMGlobalCondition -Name "Organizational unit (OU)".

Tipo:IResultObject
Alias:GlobalCondition
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-OrganizationalUnit

Especifique una tabla hash para especificar el nombre de la unidad organizativa y si se van a incluir unidades organizativas secundarias. Por ejemplo:

@{"OU"="CN=Computers,DC=Contoso,DC=Com"; "IsIncludeSubOU"=$true}

Tipo:Hashtable[]
Alias:OrganizationalUnits, OU, OUs, OrganizationalUnitWithSubOUOption, OrganizationalUnitWithSubOUOptions
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RuleOperator

Especifique el operador para comparar la configuración del dispositivo con el valor esperado.

Tipo:RuleExpressionOperator
Valores aceptados:OneOf, NoneOf
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Salidas

System.Object