SMS_Collection clase WMI de servidor

La SMS_Collection clase WMI es una clase de servidor de proveedor de SMS en Configuration Manager. Representa una colección de recursos relacionados lógicamente por reglas junto con la información de la colección.

La sintaxis siguiente se simplifica a partir del código de formato de objeto administrado (MOF) e incluye todas las propiedades heredadas.

Sintaxis

Class SMS_Collection : SMS_BaseClass
{
   String CollectionID;
   SMS_CollectionRule CollectionRules[];
   UInt32 CollectionType;
   SInt32 CollectionVariablesCount;
   String Comment;
   UInt32 CurrentStatus;
   Uint32 FullEvaluationRunTime;
   Uint32 FullEvaluationMemberChanges;
   DateTime FullEvaluationMemberChangeTime;
   DateTime FullEvaluationLastRefreshTime;
   DateTime FullEvaluationNextRefreshTime;
   Boolean HasProvisionedMember;
   SInt32 IncludeExcludeCollectionsCount;
   Uint32 IncrementalEvaluationRunTime;
   Uint32 IncrementalEvaluationMemberChanges;
   DateTime IncrementalEvaluationMemberChangeTime;
   DateTime IncrementalEvaluationLastRefreshTime;
   Boolean IsBuiltIn;
   Boolean IsReferenceCollection;
   UInt8 ISVData[];
   UInt32 ISVDataSize;
   String ISVString;
   DateTime LastChangeTime;
   DateTime LastMemberChangeTime;
   DateTime LastRefreshTime;
   String LimitToCollectionID;
   String LimitToCollectionName;
   SInt32 LocalMemberCount;
   String MemberClassName;
   SInt32 MemberCount;
   UInt32 MonitoringFlags;
   String Name;
   Boolean OwnedByThisSite;
   SInt32 PowerConfigsCount;
   SMS_ScheduleToken RefreshSchedule[];
   UInt32 RefreshType;
   Boolean ReplicateToSubSites;
   SInt32 ServiceWindowsCount;
   Boolean UseCluster;
};

Métodos

Los métodos siguientes están disponibles en la SMS_Collection clase:

• Método AddMembershipRule: agrega una nueva regla a la CollectionRules propiedad de SMS_Collection.
• AddMembershipRules method: Agrega varias reglas nuevas a la CollectionRules propiedad de SMS_Collection.
• Método ApproveClients: aprueba los equipos cliente especificados para unirse al sitio.
• Método BlockClients: impide que los equipos cliente especificados se comuniquen con el sitio.
• Método ChangeOwnership: cambia la propiedad de las máquinas a un propietario del dispositivo.
• Método ClearDeploymentLocksForCollection: borra los bloqueos de implementación de una colección seleccionada.
• Método ClearDeviceCategory: borra una categoría de un conjunto de dispositivos.
• Método ClearLastNBSAdvForCollection: borra la última implementación de PXE para una colección seleccionada.
• Método ClearLastNBSAdvForMachines: borra la última implementación de PXE para los equipos cliente seleccionados.
• Método ClientEditions: recupera una lista de ediciones de cliente.
• Método CreateCCR: crea una solicitud de configuración de cliente (CCR) para un recurso determinado.
• Método CreateCCRs: genera solicitudes de configuración de cliente (CCR) para los equipos de la colección.
• Método DeleteAllMembers: Elimina todos los miembros, es decir, los recursos y los datos de detección, de la colección.
• Método DeleteMembershipRule: elimina una regla de pertenencia de la colección.
• Método DeleteMembershipRules: elimina varias reglas de pertenencia de la colección.
• Método FindResourceSite: obtiene información de código de sitio para un equipo de la base de datos del sitio.
• Método FindMachineSite: obtiene información de código de sitio para los recursos de la base de datos del sitio.
• Método GetDependency: A partir de la versión 2010, obtiene la información de relación de colección de la que depende la colección de entrada.
• Método GetDependiente: A partir de la versión 2010, obtenga la información de la relación de colección que depende de la colección de entrada.
• Método GetNumResults: obtiene un recuento de todos los miembros de una colección, excluyendo las subcolecciones.
• Método GenerateCCRByName: genera una solicitud de configuración de cliente por nombre de equipo.
• Método GetTotalNumResults: obtiene un recuento de todos los miembros de una colección, incluidas las subcolecciones.
• Método ReassignClientsToSite: Reasigna el sitio para los clientes de la lista.
• Método RequestRefresh: desencadena una reevaluación de la pertenencia a la colección por parte del componente evaluador de colecciones de Configuration Manager.
• Método SetDeviceCategory: asigna una categoría a un conjunto de dispositivos.
• Método SetMemberOrder: Establece el orden de los miembros de una colección.
• Método UpdateVisibilityInEPDashBoard: Muestre esta colección en el panel de protección de puntos de conexión.
• Método VerifyNoCircularDependencies: comprueba que no se formen dependencias circulares si una colección es el elemento primario de otra.

Propiedades

CollectionID

Tipo de datos: String

Tipo de acceso: solo lectura

Clasificatorios: [clave, leer]

El id. único generado automáticamente para esta colección que contiene ocho caracteres.

El formato del identificador de colección es el código de sitio que creó la colección seguido de un número de serie hexadecimal de cinco dígitos, por ejemplo, JAX0002C. Las colecciones predeterminadas de Configuration Manager usan el prefijo SMS, por ejemplo, SMS00001.

CollectionRules

Tipo de datos: SMS_CollectionRule matriz

Tipo de acceso: Lectura y escritura

Calificadores: [perezoso]

SMS_CollectionRule objetos de clase WMI del servidor que definen los criterios de pertenencia para la colección.

CollectionType

Tipo de datos: UInt32

Tipo de acceso: solo lectura

Calificadores: [lectura, enumeración]

El tipo de la colección. Al crear o modificar colecciones, el tipo de colección debe ser el mismo para todas las colecciones incluidas, excluidas y limitadas. No se permiten tipos de colección que no coincidan.

CollectionVariablesCount

Tipo de datos: SInt32

Tipo de acceso: solo lectura

Clasificatorios: [leer]

Recuento de variables de recopilación.

Comment

Tipo de datos: String

Tipo de acceso: Lectura y escritura

Clasificatorios: ninguno

Comentario general o nota que documenta la colección.

CurrentStatus

Tipo de datos: UInt32

Tipo de acceso: solo lectura

Calificadores: [lectura, enumeración]

Estado actual de la colección. Los posibles valores son:

FullEvaluationRunTime

Tipo de datos: Uint32

Tipo de acceso: solo lectura

Clasificatorios: [leer]

A partir de la versión 2010, el tiempo de ejecución de evaluación completo en segundos.

FullEvaluationMemberChanges

Tipo de datos: Uint32

Tipo de acceso: solo lectura

Clasificatorios: [leer]

A partir de la versión 2010, el número de miembros cambia con respecto a la evaluación completa.

FullEvaluationMemberChangeTime

Tipo de datos: Datetime

Tipo de acceso: solo lectura

Clasificatorios: [leer]

A partir de la versión 2010, la última vez que la pertenencia cambió de evaluación completa.

FullEvaluationLastRefreshTime

Tipo de datos: Datetime

Tipo de acceso: solo lectura

Clasificatorios: [leer]

A partir de la versión 2010, la última hora de actualización de la evaluación completa.

FullEvaluationNextRefreshTime

Tipo de datos: Datetime

Tipo de acceso: solo lectura

Clasificatorios: [leer]

A partir de la versión 2010, la evaluación completa después del momento de actualización.

HasProvisionedMember

Tipo de datos: Boolean

Tipo de acceso: solo lectura

Clasificatorios: [leer]

true Si esta colección tiene miembros aprovisionados.

IncludeExcludeCollectionsCount

Tipo de datos: SInt32

Tipo de acceso: solo lectura

Clasificatorios: [leer]

Recuento de colecciones que se incluyen y excluyen con esta.

IncrementalEvaluationRunTime

Tipo de datos: Uint32

Tipo de acceso: solo lectura

Clasificatorios: [leer]

A partir de la versión 2010, el tiempo de ejecución de evaluación incremental en segundos.

IncrementalEvaluationMemberChanges

Tipo de datos: Uint32

Tipo de acceso: solo lectura

Clasificatorios: [leer]

A partir de la versión 2010, el número de miembros cambia a partir de la evaluación incremental.

IncrementalEvaluationMemberChangeTime

Tipo de datos: Datetime

Tipo de acceso: solo lectura

Clasificatorios: [leer]

A partir de la versión 2010, la última vez que la pertenencia cambió de la evaluación incremental.

IncrementalEvaluationLastRefreshTime

Tipo de datos: Datetime

Tipo de acceso: solo lectura

Clasificatorios: [leer]

A partir de la versión 2010, la última hora de actualización de la evaluación incremental.

IsBuiltIn

Tipo de datos: Boolean

Tipo de acceso: Read-Only

Clasificatorios: [leer]

Cuando este valor es true, la colección está integrada. Por ejemplo, Todos los sistemas.

IsReferenceCollection

Tipo de datos: Boolean

Tipo de acceso: solo lectura

Clasificatorios: [leer]

Cuando este valor es true, la colección no está limitada por otra colección.

ISVData

Tipo de datos: UInt8[]

Tipo de acceso: Lectura y escritura

Calificadores: [grande, perezoso]

Un espacio de datos para la extensibilidad de asociados.

ISVDataSize

Tipo de datos: UInt32

Tipo de acceso: Lectura y escritura

Calificadores: [perezoso]

El tamaño de ISVData.

ISVString

Tipo de datos: String

Tipo de acceso: Lectura y escritura

Clasificatorios: ninguno

Una cadena para la extensibilidad de asociados.

LastChangeTime

Tipo de datos: DateTime

Tipo de acceso: Lectura y escritura

Clasificatorios: ninguno

Fecha y hora de la última vez que se modificó la colección de alguna manera.

LastMemberChangeTime

Tipo de datos: DateTime

Tipo de acceso: Lectura y escritura

Clasificatorios: ninguno

Fecha y hora en que se modificó por última vez la membresía de la colección.

LastRefreshTime

Tipo de datos: DateTime

Tipo de acceso: Lectura y escritura

Clasificatorios: ninguno

Fecha y hora en que se actualizó por última vez la suscripción a la colección.

LimitToCollectionID

Tipo de datos: String

Tipo de acceso: Lectura y escritura

Clasificatorios: ninguno

Id. de la colección limitante.

LimitToCollectionName

Tipo de datos: DateTime

Tipo de acceso: Lectura y escritura

Clasificatorios: ninguno

Nombre de la colección limitante.

LocalMemberCount

Tipo de datos: SInt32

Tipo de acceso: solo lectura

Clasificatorios: [leer]

Recuento de miembros visibles en el sitio local.

MemberClassName

Tipo de datos: String

Tipo de acceso: solo lectura

Clasificatorios: [leer]

Nombre de la clase que contiene los miembros de esta colección. Configuration Manager no almacena miembros de la colección en SMS_Collection. El sitio genera dinámicamente el nombre de la clase miembro y se deriva de SMS_CM_RES_COLL_CollectionID clase WMI del servidor.

MemberCount

Tipo de datos: SInt32

Tipo de acceso: solo lectura

Clasificatorios: [leer]

El recuento de los miembros de la colección.

MonitoringFlags

Tipo de datos: UInt32

Tipo de acceso: solo lectura

Clasificatorios: [leer]

Habilita la recopilación para determinados tipos de supervisión.

Name

Tipo de datos: String

Tipo de acceso: Lectura y escritura

Clasificatorios: [Not_null]

El nombre de la colección. Este valor representa la colección en la consola de Configuration Manager y debe ser único.

OwnedByThisSite

Tipo de datos: Boolean

Tipo de acceso: Lectura y escritura

Calificador: ninguno

truesi la colección se originó en el sitio local de Configuration Manager. El valor predeterminado es false.

PowerConfigsCount

Tipo de datos: SInt32

Tipo de acceso: solo lectura

Calificador: [leer]

Recuento de las configuraciones de energía.

RefreshSchedule

Tipo de datos: SMS_ScheduleToken matriz

Tipo de acceso: Lectura y escritura

Calificadores: [max(15), lazy]

SMS_ScheduleToken objetos de clase WMI del servidor que indican una programación de actualización para la colección. El sitio solo actualiza la pertenencia a la colección si la aplicación especifica una programación o llama al método RequestRefresh en la clase SMS_Collection . Para que el evaluador de la colección use la programación, establezca la RefreshType propiedad en periódico (2).

RefreshType

Tipo de datos: UInt32

Tipo de acceso: Lectura y escritura

Calificadores: [lazy, enumeration]

Este valor indica cómo Configuration Manager actualiza la colección. El valor predeterminado es manual (1). Posibles valores:

Para basar la actualización en la programación especificada en , establezca esta propiedad en RefreshScheduleperiodic (2). Si establece esta propiedad en manual (1), actualice manualmente la colección con el método RequestRefresh.

ReplicateToSubSites

Esta propiedad no está implementada.

ServiceWindowsCount

Tipo de datos: SInt32

Tipo de acceso: solo lectura

Clasificatorios: [leer]

Recuento de ventanas de mantenimiento para esta colección.

UseCluster

Tipo de datos: Boolean

Tipo de acceso: solo lectura

Clasificatorios: [leer]

Especifica que esta colección es un grupo de servidores.

Comentarios

Los calificadores de clase para esta clase incluyen:

• Protegida

Para obtener más información acerca de los cualificadores de clase y de propiedad incluidos en la sección Propiedades, consulta Calificadores de clase y de propiedad de Configuration Manager.

La información de recopilación representada por esta clase incluye la programación de actualización y los miembros, representados por SMS_CM_RES_COLL_CollectionID objetos de clase WMI del servidor . La aplicación puede utilizar una colección para dirigirse a los recursos para la distribución de software.

Al ejecutar una consulta en una colección dinámica representada por SMS_Collection, asegúrese de que el proveedor de SMS esté cargado o de que ya se haya ejecutado otro método o consulta.

La aplicación debe usar los SMS_Collection métodos para agregar, actualizar o eliminar reglas de pertenencia definidas por la CollectionRules propiedad. Esta propiedad no se recupera cuando la aplicación enumera .SMS_Collection Para obtener las reglas de recopilación de una colección, la aplicación debe usar IWbemServices::GetObject o SWbemServices::Get. Para obtener más información, consulte Calificadores de contexto de Configuration Manager.

Requisitos

Requisitos del entorno de ejecución

Para obtener más información, consulta Requisitos de tiempo de ejecución del servidor de Configuration Manager.

Requisitos de desarrollo

Para obtener más información, consulte Requisitos de desarrollo del servidor de Configuration Manager.

Vea también

SMS_CollectionRule clase WMI de servidor