New-CMUserCollection
SYNOPSIS
Vytvoří kolekci pro uživatele a přidá ji do Správce konfigurace hierarchie.
SYNTAX
ByName (výchozí)
New-CMUserCollection [-Comment <String>] -LimitingCollectionName <String> -Name <String>
[-RefreshSchedule <IResultObject>] [-RefreshType <CollectionRefreshType>] [-WhatIf] [-Confirm]
[<CommonParameters>]
ByValue
New-CMUserCollection [-Comment <String>] -InputObject <IResultObject> -Name <String>
[-RefreshSchedule <IResultObject>] [-RefreshType <CollectionRefreshType>] [-WhatIf] [-Confirm]
[<CommonParameters>]
ById
New-CMUserCollection [-Comment <String>] -LimitingCollectionId <String> -Name <String>
[-RefreshSchedule <IResultObject>] [-RefreshType <CollectionRefreshType>] [-WhatIf] [-Confirm]
[<CommonParameters>]
DESCRIPTION
Rutina New-CMUserCollection vytvoří kolekci na základě konkrétní limitující kolekce. Limitující kolekce určuje, kteří uživatelé mohou být členem kolekce uživatelů, kterou vytvoříte. Pokud například použijete kolekci Všichni uživatelé jako limitující kolekci, může nová kolekce obsahovat libovolného uživatele v Správce konfigurace hierarchie. Limitující kolekci určíte zadáním jejího názvu nebo ID.
Uživatelé se do kolekce přidávají podle pravidel členství. Pokud chcete přidat členy do kolekce uživatelů, použijte jednu z následujících rutin pravidel členství:
- Add-CMDeviceCollectionQueryMembershipRule
- Add-CMUserCollectionDirectMembershipRule
- Add-CMUserCollectionExcludeMembershipRule
- Add-CMUserCollectionIncludeMembershipRule
Kolekce představují logická seskupení prostředků, jako jsou uživatelé a zařízení. Další informace o kolekcích Správce konfigurace v tématu Úvod do kolekcí v nástroji 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: Vytvoření kolekce uživatelů
PS XYZ:\> New-CMUserCollection -Name "Sales" -LimitingCollectionName "All Users"
Tento příkaz vytvoří kolekci pro všechny uživatele v prodejním oddělení. Zadáním možnosti Všichni uživatelé pro parametr LimitingCollectionName určíte, že nová kolekce může obsahovat libovolného uživatele v Správce konfigurace hierarchie.
PARAMETERS
-Comment
Type: String
Parameter Sets: (All)
Aliases:
Required: False
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
-InputObject
Určuje vstup pro tuto rutinu. Tento parametr můžete použít, nebo můžete vstup předáte této rutině.
Type: IResultObject
Parameter Sets: ByValue
Aliases: LimitingCollection
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-LimitingCollectionId
Type: String
Parameter Sets: ById
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-LimitingCollectionName
Type: String
Parameter Sets: ByName
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Name
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RefreshSchedule
Type: IResultObject
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RefreshType
Type: CollectionRefreshType
Parameter Sets: (All)
Aliases:
Accepted values: None, Manual, Periodic, Continuous, Both
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.
INPUTS
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
OUTPUTS
System.Object
POZNÁMKY
RELATED LINKS
Add-CMDeviceCollectionQueryMembershipRule
Add-CMUserCollectionDirectMembershipRule
Add-CMUserCollectionExcludeMembershipRule