New-CMUserCollection
SYNOPSIS
Tworzy kolekcję dla użytkowników i dodaje kolekcję do Menedżer konfiguracji hierarchii.
SYNTAX
ByName (wartość domyślna)
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
Polecenie cmdlet New-CMUserCollection tworzy kolekcję na podstawie określonej kolekcji ograniczającej. Kolekcja ograniczająca określa, którzy użytkownicy mogą być członkami kolekcji użytkowników, którą tworzysz. Na przykład w przypadku użycia kolekcji Wszyscy użytkownicy jako kolekcji ograniczającej nowa kolekcja może zawierać dowolnego użytkownika w Menedżer konfiguracji hierarchii. Aby określić kolekcję ograniczającą, podaj jej nazwę lub identyfikator.
Użytkownicy są dodawana do kolekcji przez reguły członkostwa. Aby dodać członków do kolekcji użytkowników, użyj jednego z następujących cmdlet reguł członkostwa:
- Add-CMDeviceCollectionQueryMembershipRule
- Add-CMUserCollectionDirectMembershipRule
- Add-CMUserCollectionExcludeMembershipRule
- Add-CMUserCollectionIncludeMembershipRule
Kolekcje reprezentują logiczne grupy zasobów, takie jak użytkownicy i urządzenia. Aby uzyskać więcej informacji na Menedżer konfiguracji kolekcji, zobacz Introduction to Collections in Menedżer konfiguracji(Wprowadzenie do kolekcji w Menedżer konfiguracji ).
Uwaga
Uruchom Menedżer konfiguracji cmdlet z Menedżer konfiguracji lokacji, na przykład PS XYZ:\> . Aby uzyskać więcej informacji, zobacz wprowadzenie.
EXAMPLES
Przykład 1: Tworzenie kolekcji użytkowników
PS XYZ:\> New-CMUserCollection -Name "Sales" -LimitingCollectionName "All Users"
To polecenie tworzy kolekcję dla wszystkich użytkowników w dziale sprzedaży. Określenie dla parametru LimitingCollectionName parametru Wszyscy użytkownicy wskazuje, że nowa kolekcja może zawierać dowolnego użytkownika w Menedżer konfiguracji hierarchii.
PARAMETERS
-Komentarz
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Confirm
Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
Określa dane wejściowe tego polecenia cmdlet. Możesz użyć tego parametru lub potoku danych wejściowych do tego polecenia cmdlet.
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 (Harmonogram odświeżania)
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
Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie jest uruchamiane.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
Typowe parametry
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.
INPUTS
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
OUTPUTS
System.Object
UWAGI
RELATED LINKS
Add-CMDeviceCollectionQueryMembershipRule
Add-CMUserCollectionDirectMembershipRule
Add-CMUserCollectionExcludeMembershipRule