New-CMUserCollection
SYNOPSIS
Skapar en samling för användare och lägger till samlingen i Konfigurationshanteraren hierarkin.
SYNTAX
ByName (standard)
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
Cmdleten New-CMUserCollection skapar en samling baserat på en specifik begränsande samling. Den begränsande samlingen avgör vilka användare som kan vara medlemmar i den användarsamling som du skapar. När du till exempel använder samlingen Alla användare som den begränsande samlingen kan den nya samlingen innehålla alla användare i Konfigurationshanteraren hierarkin. Du anger den begränsande samlingen genom att ange dess namn eller ID.
Användare läggs till i samlingen med medlemskapsregler. Om du vill lägga till medlemmar i användarsamlingen använder du någon av följande cmdlets för medlemskapsregeln:
- Add-CMDeviceCollectionQueryMembershipRule
- Add-CMUserCollectionDirectMembershipRule
- Add-CMUserCollectionExcludeMembershipRule
- Add-CMUserCollectionIncludeMembershipRule
Samlingar representerar logiska gruppningar av resurser, till exempel användare och enheter. Mer information om hur Konfigurationshanteraren samlingar finns i Introduktion till samlingar i Konfigurationshanteraren.
Anteckning
Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenheten, till exempel PS XYZ:\>
. Mer information finns i Komma igång.
EXAMPLES
Exempel 1: Skapa en användarsamling
PS XYZ:\> New-CMUserCollection -Name "Sales" -LimitingCollectionName "All Users"
Det här kommandot skapar en samling för alla användare på försäljningsavdelningen. Om du anger Alla användare för parametern LimitingCollectionName anger du att den nya samlingen kan innehålla alla användare i Konfigurationshanteraren hierarkin.
PARAMETERS
-Kommentar
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Confirm
Uppmanar dig att bekräfta innan du kör cmdleten.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
Anger indata för denna cmdlet. Du kan använda den här parametern eller skicka indata till denna 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
Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: False
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
RELATED LINKS
Add-CMDeviceCollectionQueryMembershipRule
Add-CMUserCollectionDirectMembershipRule
Add-CMUserCollectionExcludeMembershipRule