Share via


New-CMRequirementRuleActiveDirectorySiteValue

Crie uma regra de requisito de valor de site do Active Directory para um tipo de implantação de aplicativo.

Syntax

New-CMRequirementRuleActiveDirectorySiteValue
   -RuleOperator <RuleExpressionOperator>
   -Site <String[]>
   [-InputObject] <IResultObject>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

Use esse cmdlet para criar uma regra de requisito de valor do site do Active Directory para um tipo de implantação de aplicativo.

Depois de usar esse cmdlet, use um dos cmdlets Adicionar ou Definir para tipos de implantação. Passe esse objeto de regra de requisito para os parâmetros AddRequirement ou RemoveRequirement .

Para obter mais informações, consulte Requisitos de tipo de implantação e Criar condições globais.

Observação

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

Exemplos

Exemplo 1: Adicionar uma regra de requisito para sites do Active Directory

Este exemplo usa primeiro o cmdlet Get-CMGlobalCondition para obter a condição global padrão do site do Active Directory . Em seguida, ele define uma matriz de cadeia de caracteres de dois sites do Active Directory. Em seguida, ele cria o objeto de regra de requisito. Por fim, ele passa esse objeto de regra para o cmdlet Set-CMScriptDeploymentType para adicionar o requisito.

$gc = Get-CMGlobalCondition -Name "Active Directory site"
$sites = @('London', 'Wells')
$rule = New-CMRequirementRuleActiveDirectorySiteValue -InputObject $gc -RuleOperator OneOf -Site $sites

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

Parâmetros

-DisableWildcardHandling

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.

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

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você não pode combiná-lo com DisableWildcardHandling.

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

-InputObject

Especifique um objeto de condição global a ser usado como base para essa regra de requisito. Para obter esse objeto, use o cmdlet Get-CMGlobalCondition .

Na maioria das instâncias, você usará a condição global padrão do site do Active Directory , por exemplo: Get-CMGlobalCondition -Name "Active Directory site".

Type:IResultObject
Aliases:GlobalCondition
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-RuleOperator

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

Type:RuleExpressionOperator
Accepted values:OneOf, NoneOf
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Site

Especifique uma matriz de cadeia de caracteres de nomes de site do Active Directory.

Type:String[]
Aliases:Sites, SiteName, SiteNames
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object