Add-CMUserCollectionQueryMembershipRule
SYNOPSIS
Přidá pravidlo členství dotazu do jedné nebo více Správce konfigurace kolekcí uživatelů.
SYNTAX
ByCollectionValue (výchozí)
Add-CMUserCollectionQueryMembershipRule -InputObject <IResultObject> [-PassThru] -QueryExpression <String>
-RuleName <String> [-ValidateQueryHasResult] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf]
[-Confirm] [<CommonParameters>]
ByCollectionId
Add-CMUserCollectionQueryMembershipRule -CollectionId <String> [-PassThru] -QueryExpression <String>
-RuleName <String> [-ValidateQueryHasResult] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf]
[-Confirm] [<CommonParameters>]
ByCollectionName
Add-CMUserCollectionQueryMembershipRule -CollectionName <String> [-PassThru] -QueryExpression <String>
-RuleName <String> [-ValidateQueryHasResult] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf]
[-Confirm] [<CommonParameters>]
DESCRIPTION
Rutina Add-CMUserCollectionQueryMembershipRule přidá pravidlo, které přidá uživatele do kolekcí na základě dotazu v Správce konfigurace. Kolekce uživatelů můžete zadat pomocí jejich názvů, ID nebo zadáním objektu, který představuje kolekce. Dotaz se zadá jako textový řetězec.
Pravidlo dotazu umožňuje dynamicky aktualizovat členy kolekce na základě dotazu, který se spustí podle plánu. Další informace o pravidlech shromažďování najdete v tématu Úvod do kolekcí v Správce konfigurace.
Poznámka
Spusťte Správce konfigurace rutiny z Správce konfigurace lokality, například PS XYZ:\> . Další informace najdete v tématu Začínáme.
EXAMPLES
Příklad 1: Přidání pravidla do kolekce pomocí názvu
PS XYZ:\>Add-CMUserCollectionQueryMembershipRule -CollectionName "Remote Users" -QueryExpression "select SMS_R_USER.ResourceID,SMS_R_USER.ResourceType,SMS_R_USER.Name,SMS_R_USER.UniqueUserName,SMS_R_USER.WindowsNTDomain from SMS_R_User" -RuleName "Remote Users by Domain"
Tento příkaz přidá pravidlo s názvem Vzdálení uživatelé podle domény do kolekce s názvem Vzdálení uživatelé. Příkaz určuje dotaz jako řetězec.
PARAMETERS
-CollectionId
Určuje ID kolekce uživatelů, ve které se pravidlo používá.
Type: String
Parameter Sets: ByCollectionId
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CollectionName
Určuje název kolekce uživatelů, ve které se pravidlo používá.
Type: String
Parameter Sets: ByCollectionName
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Confirm
Před spuštěním rutiny zobrazí výzvu k potvrzení.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Tento parametr považuje zástupné znaky za hodnoty literálových znaků. Nemůžete ho kombinovat s forceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Tento parametr zpracovává zástupné znaky a může vést k neočekávanému chování (nedoporučuje se). Nemůžete ho kombinovat s příkazem DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
{{ Fill InputObject Description }}
Type: IResultObject
Parameter Sets: ByCollectionValue
Aliases: Collection
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-PassThru
Přidáním tohoto parametru vrátíte objekt, který představuje položku, se kterou pracujete. Ve výchozím nastavení tato rutina nemusí generovat žádný výstup.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-QueryExpression
Určuje výraz dotazu, který Správce konfigurace používá k aktualizaci kolekcí uživatelů.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RuleName
Určuje název pravidla.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ValidateQueryHasResult
{{ Fill ValidateQueryHasResult Description }}
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-WhatIf
Zobrazuje, co by se stalo při spuštění rutiny. Rutina se nespouštěl.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Tato rutina podporuje společné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v tématu about_CommonParameters.