New-CMRequirementRuleOUValue

Artigo
07/27/2021

SINOPSE

Crie uma regra de requisito de unidade organizacional ative diretório (OU) para um tipo de implementação de aplicação.

SINTAXE

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

DESCRIÇÃO

Utilize este cmdlet para criar uma regra de requisito de unidade organizacional ative diretório (OU) 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.

EXEMPLOS

Exemplo 1: Adicionar uma regra de requisito para OUs de Diretório Ativo

Este exemplo utiliza primeiro o cmdlet Get-CMGlobalCondition para obter a condição global da unidade organizacional (OU) padrão. Em seguida, define várias variáveis para duas OUs do Diretório Ativo. Em seguida, cria o objeto de regra de exigência. Por fim, passa o objeto de regra ao set-CMScriptDeploymentType cmdlet para adicionar o 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 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, você usará a condição global da unidade organizacional (OU) padrão, por exemplo: Get-CMGlobalCondition -Name "Organizational unit (OU)" .

Type: IResultObject
Parameter Sets: (All)
Aliases: GlobalCondition

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

-Organização

Especifique uma tabela hash para indicar o nome da UO e se deve incluir as OUs subordinados. Por exemplo:

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

Type: Hashtable[]
Parameter Sets: (All)
Aliases: OrganizationalUnits, OU, OUs, OrganizationalUnitWithSubOUOption, OrganizationalUnitWithSubOUOptions

Required: True
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

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.

ENTRADAS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

SAÍDAS

Sistema.Objeto

NOTAS

LIGAÇÕES RELACIONADAS

Partilhar via