Get-CMCollectionMember

Referencia

Módulo:: ConfigurationManager

Obtener miembros de un dispositivo o colección de usuarios.

Syntax

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>]

Description

Use este cmdlet para obtener miembros de una colección. Las colecciones pueden incluir dispositivos o usuarios, pero no ambos. Al consultar una colección, este cmdlet devuelve objetos para todos los miembros.

Para obtener más información, vea Introducción a las colecciones en Configuration Manager.

Nota

Ejecute los cmdlets de Configuration Manager desde la unidad de sitio de Configuration Manager, por ejemplo PS XYZ:\> . Para obtener más información, vea getting started.

Ejemplos

Ejemplo 1: Obtener un miembro de una colección mediante el operador de canalización

Este comando usa primero el cmdlet Get-CMCollection para obtener el objeto de colección denominado UserCol1. A continuación, usa el operador de canalización para pasar el objeto a Get-CMCollectionMember, que obtiene todos los miembros de la colección. Por último, en este ejemplo se usa el cmdlet Select-Object para mostrar solo los nombres de los miembros.

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

Ejemplo 2: Obtener un miembro de una colección por su nombre

Este comando consulta la colección DeviceCol1 para los miembros que tienen un nombre que empieza por domain . El asterisco ( * ) comodín coincide con varios caracteres. Por lo tanto, los resultados pueden incluir nombres como "dominio1" o "controlador de dominio".

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

Ejemplo 3: Exportar detalles de la colección a un CSV

En este ejemplo se consulta la colección de dispositivos XYZ0004B para un conjunto de propiedades y se almacena en la variable, $collMem. La segunda línea convierte los datos en formato de valores separados por comas (CSV) y se genera en un archivo.

$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"

Parámetros

-CollectionId

Especifique el identificador de una colección que se debe consultar. Por ejemplo, "XYZ0004B".

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

-CollectionName

Especifique el nombre de una colección que se debe consultar.

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

-DisableWildcardHandling

Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.

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

-ForceWildcardHandling

Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.

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

-InputObject

Especifique un objeto de colección que se debe consultar. Para obtener un objeto de colección, use uno de los cmdlets siguientes:

También puede usar el operador de canalización ( ) para pasar un objeto | de colección a Get-CMCollectionMemeber en la línea de comandos.

Type:	IResultObject
Aliases:	Collection
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

Para filtrar los resultados, especifique el nombre de un recurso en la colección. Este filtro no distingue mayúsculas de minúsculas.

Puede usar caracteres comodín:

*: Varios caracteres
?: Carácter único

Type:	String
Aliases:	ResourceName
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	True

-ResourceId

Para filtrar los resultados, especifique un identificador de recurso. Por ejemplo, 16777242. El cmdlet solo devuelve un registro para ese recurso en la colección de destino.

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

-SmsId

Para filtrar los resultados, especifique el SMSID de un recurso. Por ejemplo, "GUID:7a186367-7372-4841-889e-ba2e3aad1e85". Este filtro no distingue mayúsculas de minúsculas.