Condividi tramite

Get-CMCollectionMember

  • Riferimento
Modulo:
ConfigurationManager

Ottenere i membri di un dispositivo o di una raccolta di utenti.

Sintassi

Get-CMCollectionMember
   -CollectionName <String>
   [-Name <String>]
   [-ResourceId <Int32>]
   [-SmsId <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMCollectionMember
   -CollectionId <String>
   [-Name <String>]
   [-ResourceId <Int32>]
   [-SmsId <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMCollectionMember
   -InputObject <IResultObject>
   [-Name <String>]
   [-ResourceId <Int32>]
   [-SmsId <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Descrizione

Usare questo cmdlet per ottenere i membri di una raccolta. Le raccolte possono includere dispositivi o utenti, ma non entrambi. Quando si esegue una query su una raccolta, questo cmdlet restituisce oggetti per tutti i membri.

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 un membro di una raccolta usando l'operatore della pipeline

Questo comando usa innanzitutto il cmdlet Get-CMCollection per ottenere l'oggetto raccolta denominato UserCol1. Usa quindi l'operatore della pipeline per passare l'oggetto a Get-CMCollectionMember, che ottiene tutti i membri dell'insieme. Infine, questo esempio usa il cmdlet Select-Object per visualizzare solo i nomi dei membri.

Get-CMCollection -Name "UserCol1" | Get-CMCollectionMember | Select-Object Name

Esempio 2: Ottenere un membro di una raccolta per nome

Questo comando esegue una query sulla raccolta DeviceCol1 per i membri con un nome che inizia con domain. Il carattere jolly asterisco (*) corrisponde a più caratteri. I risultati possono quindi includere nomi come "domain1" o "domain-controller".

Get-CMCollectionMember -CollectionName "DeviceCol1" -Name "domain*"

Esempio 3: Esportare i dettagli della raccolta in un csv

Questo esempio esegue una query sulla raccolta di dispositivi XYZ0004B per un set di proprietà e archivia che nella variabile $collMem. La seconda riga converte i dati in formato CSV (Comma Separated Value) e restituisce l'output in un file.

$collMem = Get-CMCollectionMember -CollectionId "XYZ0004B" | Select-Object Name,Domain,LastLogonUser,DeviceOS,DeviceOSBuild,MACAddress,SerialNumber
$collMem | ConvertTo-Csv -NoTypeInformation | Out-File -FilePath "C:\output\XYZ0004B.csv"

Parametri

-CollectionId

Specificare l'ID di una raccolta su cui eseguire una query. Ad esempio, "XYZ0004B".

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

-CollectionName

Specificare il nome di una raccolta su cui eseguire una query.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
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

-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

-InputObject

Specificare un oggetto raccolta su cui eseguire una query. Per ottenere un oggetto raccolta, usare uno dei cmdlet seguenti:

È anche possibile usare l'operatore della pipeline (|) per passare un oggetto raccolta a Get-CMCollectionMemeber nella riga di comando.

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

-Name

Per filtrare i risultati, specificare il nome di una risorsa nella raccolta. Questo filtro non fa distinzione tra maiuscole e minuscole.

È possibile usare caratteri jolly:

  • *: più caratteri
  • ?: carattere singolo
Tipo:String
Alias:ResourceName
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:True

-ResourceId

Per filtrare i risultati, specificare un ID risorsa. Ad esempio, 16777242. Il cmdlet restituisce solo un record per la risorsa nella raccolta di destinazione.

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

-SmsId

Per filtrare i risultati, specificare l'SMSID di una risorsa. Ad esempio, "GUID:7a186367-7372-4841-889e-ba2e3aad1e85". Questo filtro non fa distinzione tra maiuscole e minuscole.

È possibile usare caratteri jolly:

  • *: più caratteri
  • ?: carattere singolo
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

System.Object