Condividi tramite

Get-CMCollection

  • Riferimento
Modulo:
ConfigurationManager

Ottenere un oggetto raccolta di dispositivi o utenti.

Sintassi

Get-CMCollection
   [-CollectionType <CollectionType>]
   [-Name <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMCollection
   [-CollectionType <CollectionType>]
   -DistributionPointGroup <IResultObject>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMCollection
   [-CollectionType <CollectionType>]
   -DistributionPointGroupId <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMCollection
   [-CollectionType <CollectionType>]
   -DistributionPointGroupName <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMCollection
   [-CollectionType <CollectionType>]
   -Id <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Descrizione

Usare questo cmdlet per ottenere un dispositivo o un oggetto raccolta utenti.

Le raccolte consentono di organizzare le risorse in unità gestibili. È possibile creare raccolte in base alle esigenze di gestione client ed eseguire operazioni su più risorse contemporaneamente. La maggior parte delle attività di gestione si basa o richiede l'uso di una o più raccolte.

Per definire l'ambito del tipo di raccolta ottenuto, usare i cmdlet Get-CMDeviceCollection o Get-CMUserCollection .

Se non si specifica una raccolta per nome, ID o oggetto, questo cmdlet restituisce tutte le raccolte.

Per altre informazioni, vedere Introduzione alle raccolte in Configuration Manager.

Nota

Eseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\>. Per altre informazioni, vedere Introduzione.

Esempio

Esempio 1: Ottenere una raccolta per nome

Questo comando ottiene la raccolta denominata testUser.

Get-CMCollection -Name "testUser"

Esempio 2: Ottenere una raccolta per un gruppo di punti di distribuzione

Questo comando ottiene l'oggetto gruppo di punti di distribuzione denominato dpg1 e usa l'operatore della pipeline per passare l'oggetto a Get-CMCollection, che ottiene le raccolte associate al gruppo di punti di distribuzione.

Get-CMDistributionPointGroup -Name "dpg1" | Get-CMCollection

Quando si distribuisce contenuto a queste raccolte, il sito viene automaticamente distribuito a tutti i membri correnti di questo gruppo di punti di distribuzione. Per altre informazioni, vedere Gestire i gruppi di punti di distribuzione.

Parametri

-CollectionType

Filtrare il tipo di raccolta da ottenere. Questo parametro è funzionalmente identico all'uso dei cmdlet Get-CMDeviceCollection o Get-CMUserCollection .

Tipo:CollectionType
Valori accettati:User, Device
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisableWildcardHandling

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DistributionPointGroup

Specificare un oggetto gruppo di punti di distribuzione associato a questa raccolta. Per ottenere questo oggetto, usare il cmdlet Get-CMDistributionPointGroup .

Tipo:IResultObject
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-DistributionPointGroupId

Specificare il GUID per un gruppo di punti di distribuzione associato a questa raccolta. Questo valore è la proprietà GroupID , ovvero un GUID standard racchiuso tra parentesi graffe, {537e6303-69eb-4104-bf7b-7baf43ce2352}ad esempio .

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DistributionPointGroupName

Specificare il nome di un gruppo di punti di distribuzione associato a questa raccolta.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ForceWildcardHandling

Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Id

Specificare l'ID della raccolta da ottenere. Questo valore è la proprietà CollectionID , ad esempio, XYZ00012 o SMS00001.

Tipo:String
Alias:CollectionId
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Name

Specificare il nome della raccolta da ottenere.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:True

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

IResultObject[]

IResultObject

Note

Per altre informazioni su questo oggetto restituito e sulle relative proprietà, vedere SMS_Collection classe WMI del server.