Udostępnij za pośrednictwem

klasa WMI serwera SMS_Collection

  • Artykuł

Klasa SMS_Collection WMI jest klasą serwera dostawcy programu SMS w Configuration Manager. Reprezentuje kolekcję zasobów powiązanych logicznie przez reguły wraz z informacjami o kolekcji.

Poniższa składnia jest uproszczona z kodu MOF (Managed Object Format) i zawiera wszystkie dziedziczone właściwości.

Składni

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;
};

Metody

W klasie SMS_Collection dostępne są następujące metody:

Właściwości

CollectionID

Typ danych: String

Typ dostępu: tylko do odczytu

Kwalifikatory: [klucz, odczyt]

Unikatowy identyfikator automatycznie wygenerowany dla tej kolekcji, który zawiera osiem znaków.

Format identyfikatora kolekcji to kod witryny, który utworzył kolekcję, po której następuje pięciocyfrowy szesnastkowy numer seryjny, na przykład JAX0002C. Domyślne kolekcje Configuration Manager używają prefiksu SMS, na przykład SMS00001.

CollectionRules

Typ danych: SMS_CollectionRule tablica

Typ dostępu: odczyt/zapis

Kwalifikatory: [leniwy]

SMS_CollectionRule obiektów klasy WMI serwera definiujących kryteria członkostwa dla kolekcji.

CollectionType

Typ danych: UInt32

Typ dostępu: tylko do odczytu

Kwalifikatory: [odczyt, wyliczenie]

Typ kolekcji. Podczas tworzenia lub modyfikowania kolekcji typ kolekcji musi być taki sam dla wszystkich kolekcji uwzględnionych, wykluczonych i ograniczonych. Niezgodne typy kolekcji nie są dozwolone.

Value Typ kolekcji
0 Inne
1 Użytkownik
2 Urządzenie

CollectionVariablesCount

Typ danych: SInt32

Typ dostępu: tylko do odczytu

Kwalifikatory: [odczyt]

Liczba zmiennych kolekcji.

Comment

Typ danych: String

Typ dostępu: odczyt/zapis

Kwalifikatory: Brak

Ogólny komentarz lub zwróć uwagę, że dokumentuje kolekcję.

CurrentStatus

Typ danych: UInt32

Typ dostępu: tylko do odczytu

Kwalifikatory: [odczyt, wyliczenie]

Bieżący stan kolekcji. Możliwe wartości to:

Value Bieżący stan
0 Brak
1 Gotowy
2 Orzeźwiające
3 Zapisywanie
4 Oceny
5 Oczekiwanie na odświeżenie
6 Usuwanie
7 Dołączanie elementu członkowskiego
8 Badanie

FullEvaluationRunTime

Typ danych: Uint32

Typ dostępu: tylko do odczytu

Kwalifikatory: [odczyt]

Począwszy od wersji 2010, pełny czas wykonywania oceny w sekundach.

FullEvaluationMemberChanges

Typ danych: Uint32

Typ dostępu: tylko do odczytu

Kwalifikatory: [odczyt]

Począwszy od wersji 2010, liczba elementów członkowskich zmienia się od pełnej oceny.

FullEvaluationMemberChangeTime

Typ danych: Datetime

Typ dostępu: tylko do odczytu

Kwalifikatory: [odczyt]

Począwszy od wersji 2010, ostatni raz członkostwo zmieniło się z pełnej oceny.

FullEvaluationLastRefreshTime

Typ danych: Datetime

Typ dostępu: tylko do odczytu

Kwalifikatory: [odczyt]

Począwszy od wersji 2010, czas ostatniego odświeżenia pełnej oceny.

FullEvaluationNextRefreshTime

Typ danych: Datetime

Typ dostępu: tylko do odczytu

Kwalifikatory: [odczyt]

Począwszy od wersji 2010, pełna ocena zostanie ponownie odświeżona.

HasProvisionedMember

Typ danych: Boolean

Typ dostępu: tylko do odczytu

Kwalifikatory: [odczyt]

true jeśli ta kolekcja ma aprowizowane elementy członkowskie.

IncludeExcludeCollectionsCount

Typ danych: SInt32

Typ dostępu: tylko do odczytu

Kwalifikatory: [odczyt]

Liczba kolekcji dołączonych i wykluczonych z tej kolekcji.

IncrementalEvaluationRunTime

Typ danych: Uint32

Typ dostępu: tylko do odczytu

Kwalifikatory: [odczyt]

Począwszy od wersji 2010, przyrostowy czas wykonywania oceny w sekundach.

IncrementalEvaluationMemberChanges

Typ danych: Uint32

Typ dostępu: tylko do odczytu

Kwalifikatory: [odczyt]

Począwszy od wersji 2010, liczba elementów członkowskich zmienia się z oceny przyrostowej.

IncrementalEvaluationMemberChangeTime

Typ danych: Datetime

Typ dostępu: tylko do odczytu

Kwalifikatory: [odczyt]

Począwszy od wersji 2010, ostatni raz członkostwo zmieniło się z oceny przyrostowej.

IncrementalEvaluationLastRefreshTime

Typ danych: Datetime

Typ dostępu: tylko do odczytu

Kwalifikatory: [odczyt]

Począwszy od wersji 2010, czas ostatniego odświeżania oceny przyrostowej.

IsBuiltIn

Typ danych: Boolean

Typ dostępu: Read-Only

Kwalifikatory: [odczyt]

Gdy ta wartość to true, kolekcja jest wbudowana. Na przykład Wszystkie systemy.

IsReferenceCollection

Typ danych: Boolean

Typ dostępu: tylko do odczytu

Kwalifikatory: [odczyt]

Jeśli ta wartość to true, kolekcja nie jest ograniczona przez inną kolekcję.

ISVData

Typ danych: UInt8[]

Typ dostępu: odczyt/zapis

Kwalifikatory: [duży, leniwy]

Przestrzeń danych na potrzeby rozszerzalności partnerów.

ISVDataSize

Typ danych: UInt32

Typ dostępu: odczyt/zapis

Kwalifikatory: [leniwy]

Rozmiar isvdata.

ISVString

Typ danych: String

Typ dostępu: odczyt/zapis

Kwalifikatory: brak

Ciąg rozszerzalności partnera.

LastChangeTime

Typ danych: DateTime

Typ dostępu: odczyt/zapis

Kwalifikatory: Brak

Data i godzina ostatniej zmiany kolekcji w jakikolwiek sposób.

LastMemberChangeTime

Typ danych: DateTime

Typ dostępu: odczyt/zapis

Kwalifikatory: Brak

Data i godzina ostatniej zmiany członkostwa w kolekcji.

LastRefreshTime

Typ danych: DateTime

Typ dostępu: odczyt/zapis

Kwalifikatory: Brak

Data i godzina ostatniego odświeżenia członkostwa w kolekcji.

LimitToCollectionID

Typ danych: String

Typ dostępu: odczyt/zapis

Kwalifikatory: Brak

Identyfikator kolekcji ograniczającej.

LimitToCollectionName

Typ danych: DateTime

Typ dostępu: odczyt/zapis

Kwalifikatory: Brak

Nazwa kolekcji ograniczającej.

LocalMemberCount

Typ danych: SInt32

Typ dostępu: tylko do odczytu

Kwalifikatory: [odczyt]

Liczba elementów członkowskich widocznych w witrynie lokalnej.

MemberClassName

Typ danych: String

Typ dostępu: tylko do odczytu

Kwalifikatory: [odczyt]

Nazwa klasy zawierającej elementy członkowskie tej kolekcji. Configuration Manager nie przechowuje elementów członkowskich kolekcji w SMS_Collection. Lokacja dynamicznie generuje nazwę klasy składowej i pochodzi od klasy WMI serwera SMS_CM_RES_COLL_CollectionID.

MemberCount

Typ danych: SInt32

Typ dostępu: tylko do odczytu

Kwalifikatory: [odczyt]

Liczba elementów członkowskich kolekcji.

MonitoringFlags

Typ danych: UInt32

Typ dostępu: tylko do odczytu

Kwalifikatory: [odczyt]

Włącza kolekcję na potrzeby pewnych rodzajów monitorowania.

Name

Typ danych: String

Typ dostępu: odczyt/zapis

Kwalifikatory: [Not_null]

Nazwa kolekcji. Ta wartość reprezentuje kolekcję w konsoli Configuration Manager i powinna być unikatowa.

OwnedByThisSite

Typ danych: Boolean

Typ dostępu: odczyt/zapis

Kwalifikator: Brak

truejeśli kolekcja pochodzi z lokalnej witryny Configuration Manager. Wartość domyślna to false.

PowerConfigsCount

Typ danych: SInt32

Typ dostępu: tylko do odczytu

Kwalifikator: [odczyt]

Liczba konfiguracji zasilania.

RefreshSchedule

Typ danych: SMS_ScheduleToken tablica

Typ dostępu: odczyt/zapis

Kwalifikatory: [max(15), lazy]

SMS_ScheduleToken obiektów klasy WMI serwera wskazujących harmonogram aktualizacji lub odświeżania dla kolekcji. Witryna aktualizuje członkostwo w kolekcji tylko wtedy, gdy aplikacja określa harmonogram lub wywołuje metodę RequestRefresh w klasie SMS_Collection . Aby ewaluator kolekcji używał harmonogramu RefreshType , ustaw właściwość na okresową (2).

RefreshType

Typ danych: UInt32

Typ dostępu: odczyt/zapis

Kwalifikatory: [z opóźnieniem, wyliczenie]

Ta wartość wskazuje, jak Configuration Manager odświeża kolekcję. Wartość domyślna to ręczna (1). Możliwe wartości:

Value Typ odświeżania
1 Ręcznie
2 Okresowe
4 Aktualizacja stała

Aby oprzeć odświeżanie na harmonogramie określonym w RefreshScheduleprogramie , ustaw tę właściwość na okresową (2). Jeśli ta właściwość zostanie ustawiona na ręczną (1), ręcznie zaktualizuj kolekcję za pomocą metody RequestRefresh.

ReplicateToSubSites

Ta właściwość nie jest implementowana.

ServiceWindowsCount

Typ danych: SInt32

Typ dostępu: tylko do odczytu

Kwalifikatory: [odczyt]

Liczba okien obsługi dla tej kolekcji.

UseCluster

Typ danych: Boolean

Typ dostępu: tylko do odczytu

Kwalifikatory: [odczyt]

Określa, że ta kolekcja jest grupą serwerów.

Uwagi

Kwalifikatory klas dla tej klasy obejmują:

  • Zabezpieczone

Aby uzyskać więcej informacji na temat kwalifikatorów klas i kwalifikatorów właściwości zawartych w sekcji właściwości, zobacz Configuration Manager klasy i kwalifikatorów właściwości.

Informacje o kolekcji reprezentowane przez tę klasę obejmują harmonogram odświeżania i elementy członkowskie reprezentowane przez obiekty klasy WMI serwera SMS_CM_RES_COLL_CollectionID . Aplikacja może używać kolekcji do kierowania zasobów do dystrybucji oprogramowania.

Po uruchomieniu zapytania względem kolekcji dynamicznej reprezentowanej przez SMS_Collectionprogram upewnij się, że dostawca programu SMS został załadowany lub że została już uruchomiona inna metoda lub zapytanie.

Aplikacja powinna używać metod dodawania SMS_Collection , aktualizowania lub usuwania reguł członkostwa zdefiniowanych przez właściwość CollectionRules . Ta właściwość nie jest pobierana, gdy aplikacja wylicza SMS_Collectionwartość . Aby uzyskać reguły kolekcji dla kolekcji, aplikacja musi użyć polecenia IWbemServices::GetObject lub SWbemServices::Get. Aby uzyskać więcej informacji, zobacz Configuration Manager kwalifikatory kontekstu.

Wymagania

Wymagania dotyczące środowiska uruchomieniowego

Aby uzyskać więcej informacji, zobacz wymagania dotyczące środowiska uruchomieniowego serwera Configuration Manager.

Wymagania dotyczące programowania

Aby uzyskać więcej informacji, zobacz Configuration Manager wymagania dotyczące programowania serwera.

Zobacz też

klasa WMI serwera SMS_CollectionRule