New-CMDeviceCollection
SYNOPSIS
Tworzy kolekcję dla urządzeń i dodaje kolekcję do Menedżer konfiguracji hierarchii.
SYNTAX
ByName (wartość domyślna)
New-CMDeviceCollection [-Comment <String>] -LimitingCollectionName <String> -Name <String>
[-RefreshSchedule <IResultObject>] [-RefreshType <CollectionRefreshType>] [-WhatIf] [-Confirm]
[<CommonParameters>]
ByValue
New-CMDeviceCollection [-Comment <String>] -InputObject <IResultObject> -Name <String>
[-RefreshSchedule <IResultObject>] [-RefreshType <CollectionRefreshType>] [-WhatIf] [-Confirm]
[<CommonParameters>]
ById
New-CMDeviceCollection [-Comment <String>] -LimitingCollectionId <String> -Name <String>
[-RefreshSchedule <IResultObject>] [-RefreshType <CollectionRefreshType>] [-WhatIf] [-Confirm]
[<CommonParameters>]
DESCRIPTION
Polecenie cmdlet New-CMDeviceCollection tworzy kolekcję na podstawie określonej kolekcji ograniczającej. Kolekcja ograniczająca określa, które urządzenia mogą być członkami kolekcji urządzeń, którą tworzysz. Na przykład w przypadku użycia kolekcji Wszystkie systemy jako kolekcji ograniczającej nowa kolekcja może zawierać dowolne urządzenie w Menedżer konfiguracji hierarchii. Aby określić kolekcję ograniczającą, podaj jej nazwę lub identyfikator.
Urządzenia są dodawane do kolekcji przez reguły członkostwa. Aby dodać członków do kolekcji urządzeń, użyj jednego z następujących cmdlet reguł członkostwa:
- Add-CMDeviceCollectionDirectMembershipRule
- Add-CMDeviceCollectionExcludeMembershipRule
- Add-CMDeviceCollectionIncludeMembershipRule
- Add-CMDeviceCollectionQueryMembershipRule
Kolekcje reprezentują logiczne grupy zasobów, takie jak użytkownicy i urządzenia. Aby uzyskać więcej informacji na temat Menedżer konfiguracji kolekcji, zobacz Wprowadzenie do kolekcji w Menedżer konfiguracji.
Uwaga
Uruchom Menedżer konfiguracji cmdlet z dysku Menedżer konfiguracji lokacji, na przykład PS XYZ:\>
. Aby uzyskać więcej informacji, zobacz wprowadzenie.
EXAMPLES
Przykład 1: tworzenie kolekcji urządzeń
PS XYZ:\> New-CMDeviceCollection -Name "Windows 7" -LimitingCollectionName "All Systems"
To polecenie tworzy kolekcję dla wszystkich komputerów z systemem Windows 7. Parametr LimitingCollectionName określa, że dowolne urządzenie w kolekcji Wszystkie systemy może być członkiem kolekcji Windows 7.
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żna użyć tego parametru lub potok 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
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.