Compartir a través de

Get-CMCollectionMember

  • Referencia
Módulo:
ConfigurationManager

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

Sintaxis

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, consulte Introducción a las colecciones en Configuration Manager.

Nota:

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

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 miembro.

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

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

Este comando consulta la colección DeviceCol1 para los miembros que tienen un nombre que comienza por domain. El carácter comodín de asterisco (*) coincide con varios caracteres. Por lo tanto, los resultados pueden incluir nombres como "domain1" o "domain-controller".

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

Ejemplo 3: Exportación de los detalles de la colección a un archivo CSV

En este ejemplo se consulta a la colección de dispositivos XYZ0004B un conjunto de propiedades y se almacena en la variable $collMem. La segunda línea convierte esos 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 va a consultar. Por ejemplo, "XYZ0004B".

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-CollectionName

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

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DisableWildcardHandling

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

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ForceWildcardHandling

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

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InputObject

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

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.

Tipo:IResultObject
Alias:Collection
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Name

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

Puede usar caracteres comodín:

  • *: varios caracteres
  • ?: carácter único
Tipo:String
Alias:ResourceName
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:Int32
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Puede usar caracteres comodín:

  • *: varios caracteres
  • ?: carácter único
Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:True

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Salidas

System.Object