Dela via


New-CMRequirementRuleOUValue

SYNOPSIS

Skapa en kravregel för Active Directory-organisationsenhet (OU) för en programdistributionstyp.

SYNTAX

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

DESCRIPTION

Använd den här cmdleten för att skapa en kravregel för Active Directory-organisationsenheter (OU) för en programdistributionstyp.

När du har använder den här cmdleten använder du en av cmdletarna Add- eller Set- för distributionstyper. Skicka det här kravregelobjektet till parametrarna AddRequirement eller RemoveRequirement.

Mer information finns i Krav för distributionstyp och Skapa globala villkor.

Anteckning

Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenhet, till exempel PS XYZ:\> . Mer information finns i Komma igång.

EXAMPLES

Exempel 1: Lägg till en kravregel för Active Directory-OUs

I det här exemplet används först cmdleten Get-CMGlobalCondition för att hämta standardvillkoret för organisationsenhet (OU). Den definierar sedan flera variabler för två Active Directory-OUs. Därefter skapas kravregelobjektet. Slutligen skickar den regelobjektet till cmdleten Set-CMScriptDeploymentType för att lägga till kravet.

$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

PARAMETERS

-DisableWildcardHandling

Den här parametern behandlar jokertecken som värden för literaltecken. Du kan inte kombinera den med ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Den här parametern bearbetar jokertecken och kan leda till oväntat beteende (rekommenderas inte). Du kan inte kombinera den med DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-InputObject

Ange ett globalt villkorsobjekt som ska användas som grund för den här kravregeln. Hämta det här objektet med hjälp av cmdleten Get-CMGlobalCondition.

I de flesta fall använder du det globala standardvillkoret för organisationsenhet (OU), till exempel: 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

-OrganizationalUnit

Ange en hash-tabell för att ange namnet på organisationsenheten och om underordnade organisationsenheten ska inkluderas. Ett exempel:

@{"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

-RuleOperator

Ange operatorn för att jämföra enhetens inställning med det förväntade värdet.

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

Denna cmdlet har stöd för parametrarna -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

System.Object

ANTECKNINGAR

New-CMRequirementRuleActiveDirectorySiteValue New-CMRequirementRuleBooleanValue New-CMRequirementRuleCMSiteValue New-CMRequirementRuleCommonValue New-CMRequirementRuleDeviceOwnershipValue New-CMRequirementRuleExistential New-CMRequirementRuleExpression New-CMRequirementRuleFileAttributeValue New-CMRequirementRuleFilePermissionValue New-CMRequirementRuleFreeDiskSpaceValue New-CMRequirementRuleInputTypeValue New-CMRequirementRuleOperatingSystemLanguageValue New-CMRequirementRuleOperatingSystemValue New-CMRequirementRuleRegistryKeyPermissionValue New-CMRequirementRuleScreenResolutionValue Get-CMGlobalCondition Krav för distributionstyp Skapa globala villkor