New-CMRequirementRuleActiveDirectorySiteValue

  • Referência
Módulo:
ConfigurationManager

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

Sintaxe

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

Description

Utilize este cmdlet para criar uma regra de requisito de valor de site do Active Directory 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 sites do Active Directory

Este exemplo utiliza primeiro o cmdlet Get-CMGlobalCondition para obter a condição global do site do Active Directory predefinida. Em seguida, define uma matriz de cadeia de carateres de dois sites do Active Directory. Em seguida, cria o objeto de regra de requisito. Por fim, transmite 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

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 site do Active Directory predefinida, por exemplo: Get-CMGlobalCondition -Name "Active Directory site".

Tipo:IResultObject
Aliases:GlobalCondition
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
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

-Site

Especifique uma matriz de cadeia de nomes de sites do Active Directory.

Tipo:String[]
Aliases:Sites, SiteName, SiteNames
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object