Compartir a través de

Get-CMCollection

  • Referencia
Módulo:
ConfigurationManager

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

Sintaxis

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

Description

Use este cmdlet para obtener un dispositivo o un objeto de colección de usuarios.

Las colecciones le ayudan a organizar los recursos en unidades administrables. Puede crear colecciones para que coincidan con sus necesidades de administración de clientes y para realizar operaciones en varios recursos a la vez. La mayoría de las tareas de administración se basan en o requieren el uso de una o varias colecciones.

Para limitar el tipo de colección que obtiene, use los cmdlets Get-CMDeviceCollection o Get-CMUserCollection .

Si no especifica una colección por nombre, identificador o objeto, este cmdlet devuelve todas las colecciones.

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: Obtención de una colección por nombre

Este comando obtiene la colección denominada testUser.

Get-CMCollection -Name "testUser"

Ejemplo 2: Obtener una colección para un grupo de puntos de distribución

Este comando obtiene el objeto de grupo de puntos de distribución denominado dpg1 y usa el operador de canalización para pasar el objeto a Get-CMCollection, que obtiene las colecciones asociadas al grupo de puntos de distribución.

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

Al distribuir contenido a estas colecciones, el sitio se distribuye automáticamente a todos los miembros actuales de este grupo de puntos de distribución. Para obtener más información, vea Administrar grupos de puntos de distribución.

Parámetros

-CollectionType

Filtre el tipo de colección que se va a obtener. Este parámetro es funcionalmente el mismo que el uso de los cmdlets Get-CMDeviceCollection o Get-CMUserCollection .

Tipo:CollectionType
Valores aceptados:User, Device
Posición:Named
Valor predeterminado:None
Requerido:False
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

-DistributionPointGroup

Especifique un objeto de grupo de puntos de distribución asociado a esta colección. Para obtener este objeto, use el cmdlet Get-CMDistributionPointGroup .

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

-DistributionPointGroupId

Especifique el GUID de un grupo de puntos de distribución asociado a esta colección. Este valor es la propiedad GroupID , que es un GUID estándar rodeado de corchetes, por ejemplo, {537e6303-69eb-4104-bf7b-7baf43ce2352}.

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

-DistributionPointGroupName

Especifique el nombre de un grupo de puntos de distribución asociado a esta colección.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
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

-Id

Especifique el identificador de la colección que se va a obtener. Este valor es la propiedad CollectionID , por ejemplo, XYZ00012 o SMS00001.

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

-Name

Especifique el nombre de la colección que se va a obtener.

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

IResultObject[]

IResultObject

Notas

Para obtener más información sobre este objeto devuelto y sus propiedades, vea SMS_Collection clase WMI de servidor.