SMS_Collection clase WMI de servidor
La SMS_Collection
clase WMI es una clase de servidor proveedor de SMS en Configuration Manager. Representa una colección de recursos relacionada lógicamente por reglas junto con información de recopilació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 deSMS_Collection
. -
Método AddMembershipRules: agrega varias reglas nuevas a la
CollectionRules
propiedad deSMS_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, obtenga la información de relación de colección de la que depende la colección de entrada.
- Método GetDependent: a partir de la versión 2010, obtenga la información de relación de la colección que depende de la colección de entrada.
- Método GetNumResults: obtiene un recuento de todos los miembros de una colección, excepto 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 recopilación 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: muestra esta colección en el panel de Endpoint Protection.
- Método VerifyNoCircularDependencies: comprueba que no se forman dependencias circulares si una colección es el elemento primario de otra.
Propiedades
CollectionID
Tipo de datos: String
Tipo de acceso: solo lectura
Calificadores: [clave, lectura]
Identificador ú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 de Configuration Manager predeterminadas usan el prefijo SMS, por ejemplo, SMS00001
.
CollectionRules
Tipo de datos: SMS_CollectionRule
matriz
Tipo de acceso: lectura y escritura
Calificadores: [diferido]
SMS_CollectionRule objetos de clase WMI de 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]
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 no coincidentes.
Valor | Tipo de colección |
---|---|
0 |
Otros |
1 |
User |
2 |
Device |
CollectionVariablesCount
Tipo de datos: SInt32
Tipo de acceso: solo lectura
Calificadores: [leer]
Recuento de variables de colección.
Comment
Tipo de datos: String
Tipo de acceso: lectura y escritura
Calificadores: Ninguno
Comentario general o tenga en cuenta 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:
Valor | Estado actual |
---|---|
0 |
Ninguno |
1 |
Listo |
2 |
Refreshing |
3 |
Ahorro |
4 |
Evaluar |
5 |
En espera de actualización |
6 |
Eliminación |
7 |
Anexar miembro |
8 |
Consulta |
FullEvaluationRunTime
Tipo de datos: Uint32
Tipo de acceso: solo lectura
Calificadores: [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
Calificadores: [leer]
A partir de la versión 2010, el número de cambios de miembros de la evaluación completa.
FullEvaluationMemberChangeTime
Tipo de datos: Datetime
Tipo de acceso: solo lectura
Calificadores: [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
Calificadores: [leer]
A partir de la versión 2010, la hora de la última actualización de evaluación completa.
FullEvaluationNextRefreshTime
Tipo de datos: Datetime
Tipo de acceso: solo lectura
Calificadores: [leer]
A partir de la versión 2010, la próxima vez que se actualice la evaluación completa.
HasProvisionedMember
Tipo de datos: Boolean
Tipo de acceso: solo lectura
Calificadores: [leer]
true
si esta colección tiene miembros aprovisionados.
IncludeExcludeCollectionsCount
Tipo de datos: SInt32
Tipo de acceso: solo lectura
Calificadores: [leer]
Recuento de colecciones que se incluyen y excluyen con esta.
IncrementalEvaluationRunTime
Tipo de datos: Uint32
Tipo de acceso: solo lectura
Calificadores: [leer]
A partir de la versión 2010, el tiempo de ejecución de la evaluación incremental en segundos.
IncrementalEvaluationMemberChanges
Tipo de datos: Uint32
Tipo de acceso: solo lectura
Calificadores: [leer]
A partir de la versión 2010, el número de cambios de miembros de la evaluación incremental.
IncrementalEvaluationMemberChangeTime
Tipo de datos: Datetime
Tipo de acceso: solo lectura
Calificadores: [leer]
A partir de la versión 2010, la última vez que la pertenencia cambió de evaluación incremental.
IncrementalEvaluationLastRefreshTime
Tipo de datos: Datetime
Tipo de acceso: solo lectura
Calificadores: [leer]
A partir de la versión 2010, la hora de la última actualización de la evaluación incremental.
IsBuiltIn
Tipo de datos: Boolean
Tipo de acceso: Read-Only
Calificadores: [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
Calificadores: [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, diferido]
Un espacio de datos para la extensibilidad de asociados.
ISVDataSize
Tipo de datos: UInt32
Tipo de acceso: lectura y escritura
Calificadores: [diferido]
Tamaño ISVData.
ISVString
Tipo de datos: String
Tipo de acceso: lectura y escritura
Calificadores: ninguno
Cadena para la extensibilidad de asociados.
LastChangeTime
Tipo de datos: DateTime
Tipo de acceso: lectura y escritura
Calificadores: Ninguno
Fecha y hora de la última modificación de la colección.
LastMemberChangeTime
Tipo de datos: DateTime
Tipo de acceso: lectura y escritura
Calificadores: Ninguno
Fecha y hora de la última modificación de la pertenencia a la colección.
LastRefreshTime
Tipo de datos: DateTime
Tipo de acceso: lectura y escritura
Calificadores: Ninguno
Fecha y hora de la última actualización de la pertenencia a la colección.
LimitToCollectionID
Tipo de datos: String
Tipo de acceso: lectura y escritura
Calificadores: Ninguno
Identificador de la colección de limitación.
LimitToCollectionName
Tipo de datos: DateTime
Tipo de acceso: lectura y escritura
Calificadores: Ninguno
Nombre de la colección de limitación.
LocalMemberCount
Tipo de datos: SInt32
Tipo de acceso: solo lectura
Calificadores: [leer]
Recuento de miembros visibles en el sitio local.
MemberClassName
Tipo de datos: String
Tipo de acceso: solo lectura
Calificadores: [leer]
Nombre de la clase que contiene los miembros de esta colección. Configuration Manager no almacena miembros de 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 de servidor.
MemberCount
Tipo de datos: SInt32
Tipo de acceso: solo lectura
Calificadores: [leer]
Recuento de los miembros de la colección.
MonitoringFlags
Tipo de datos: UInt32
Tipo de acceso: solo lectura
Calificadores: [leer]
Habilita la colección para ciertos tipos de supervisión.
Name
Tipo de datos: String
Tipo de acceso: lectura y escritura
Calificadores: [Not_null]
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
true
si la colección se originó en el sitio de Configuration Manager local. 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 de servidor que indican una programación de actualización o 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 recopilación use la programación, establezca la RefreshType
propiedad en periódica (2
).
RefreshType
Tipo de datos: UInt32
Tipo de acceso: lectura y escritura
Calificadores: [diferido, enumeración]
Este valor indica cómo Configuration Manager actualiza la colección. El valor predeterminado es manual (1
). Posibles valores:
Valor | Tipo de actualización |
---|---|
1 |
Manual |
2 |
Periódica |
4 |
Actualización constante |
Para basar la actualización en la programación especificada en , establezca esta propiedad en RefreshSchedule
periódica (2
). Si establece esta propiedad en manual (1
), actualice manualmente la colección con el método RequestRefresh.
ReplicateToSubSites
Esta propiedad no se implementa.
ServiceWindowsCount
Tipo de datos: SInt32
Tipo de acceso: solo lectura
Calificadores: [leer]
Recuento de ventanas de mantenimiento para esta colección.
UseCluster
Tipo de datos: Boolean
Tipo de acceso: solo lectura
Calificadores: [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 sobre los calificadores de clase y los calificadores de propiedad incluidos en la sección de propiedades, vea Configuration Manager calificadores de clase y propiedad.
La información de colecció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 de servidor . La aplicación puede usar una colección para dirigirse a 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 ha 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, vea Configuration Manager calificadores de contexto.
Requisitos
Requisitos en tiempo de ejecución
Para obtener más información, consulte Configuration Manager requisitos de tiempo de ejecución del servidor.
Requisitos de desarrollo
Para obtener más información, consulte Configuration Manager requisitos de desarrollo del servidor.