Get-CMDeviceCollection

SYNOPSIS

Gets one or more device collections in the Configuration Manager hierarchy.

SYNTAX

ByName (Default)

Get-CMDeviceCollection [-Name <String>] [<CommonParameters>]

ById

Get-CMDeviceCollection -Id <String> [<CommonParameters>]

ByDPGroupName

Get-CMDeviceCollection -DistributionPointGroupName <String> [<CommonParameters>]

ByDPGroupId

Get-CMDeviceCollection -DistributionPointGroupId <String> [<CommonParameters>]

ByDPGroup

Get-CMDeviceCollection -DistributionPointGroup <IResultObject> [<CommonParameters>]

DESCRIPTION

The Get-CMDeviceCollection cmdlet retrieves collections that contain computers or mobile devices. For more information about collections, see Introduction to Collections in Configuration Manager on TechNet.

EXAMPLES

Example 1: Get a device collection by using an ID

PS C:\> Get-CMDeviceCollection -CollectionId "9990000D"

This command gets the device collection that has the ID 9990000D.

PARAMETERS

-DistributionPointGroup

Type: IResultObject
Parameter Sets: ByDPGroup
Aliases: 

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DistributionPointGroupId

Type: String
Parameter Sets: ByDPGroupId
Aliases: 

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DistributionPointGroupName

Type: String
Parameter Sets: ByDPGroupName
Aliases: 

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Id

Type: String
Parameter Sets: ById
Aliases: CollectionId

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Name

Type: String
Parameter Sets: ByName
Aliases: 

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).

INPUTS

OUTPUTS

NOTES

Introduction to Collections in Configuration Manager

New-CMDeviceCollection