Klasa WMI serwera SMS_Collection

Klasa SMS_Collection WMI jest klasą serwera dostawcy wiadomości SMS w programie Configuration Manager. Reprezentuje on kolekcję zasobów powiązanych logicznie regułami wraz z informacjami o kolekcji.

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

Składnia

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, wygenerowany automatycznie identyfikator dla tej kolekcji, który zawiera osiem znaków.

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

CollectionRules

Typ danych: SMS_CollectionRule tablica

Typ dostępu: Właściwość do odczytu i zapisu

Kwalifikatory: [leniwe]

SMS_CollectionRule obiektów klasy WMI serwera określających kryteria członkostwa w 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 dołączonych, wykluczonych i ograniczonych kolekcji. 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: Właściwość do odczytu i zapisu

Kwalifikatory: brak

Ogólny komentarz lub notatka dokumentująca kolekcję.

CurrentStatus

Typ danych: UInt32

Typ dostępu: Tylko do odczytu

Kwalifikatory: [odczyt, wyliczenie]

Bieżący stan kolekcji. Dopuszczalne wartości:

Value Stan bieżący
0 Brak
1 Gotowe
2 Orzeźwiający
3 Oszczędność
4 Ocenianie
5 Oczekujące na odświeżenie
6 Usuwanie
7 Element dołączający
8 Wykonywanie zapytań

FullEvaluationRunTime

Typ danych: Uint32

Typ dostępu: Tylko do odczytu

Kwalifikatory: [odczyt]

Począwszy od wersji 2010, czas wykonania pełnej oceny w sekundach.

FullEvaluationMemberChanges

Typ danych: Uint32

Typ dostępu: Tylko do odczytu

Kwalifikatory: [odczyt]

Począwszy od wersji 2010, liczba zmian elementów członkowskich z pełnej oceny.

FullEvaluationMemberChangeTime

Typ danych: Datetime

Typ dostępu: Tylko do odczytu

Kwalifikatory: [odczyt]

Począwszy od wersji 2010, przy ostatniej zmianie członkostwa z pełnej oceny.

FullEvaluationLastRefreshTime

Typ danych: Datetime

Typ dostępu: Tylko do odczytu

Kwalifikatory: [odczyt]

Począwszy od wersji 2010, pełna ocena czasu ostatniego odświeżania.

FullEvaluationNextRefreshTime

Typ danych: Datetime

Typ dostępu: Tylko do odczytu

Kwalifikatory: [odczyt]

Począwszy od wersji 2010, pełna ocena czasu następnego odświeżania.

HasProvisionedMember

Typ danych: Boolean

Typ dostępu: Tylko do odczytu

Kwalifikatory: [odczyt]

true Jeśli ta kolekcja ma aprowizowanych członków.

IncludeExcludeCollectionsCount

Typ danych: SInt32

Typ dostępu: Tylko do odczytu

Kwalifikatory: [odczyt]

Liczba kolekcji, które są uwzględnione i wykluczone w tej kolekcji.

IncrementalEvaluationRunTime

Typ danych: Uint32

Typ dostępu: Tylko do odczytu

Kwalifikatory: [odczyt]

Począwszy od wersji 2010, czas uruchomienia oceny przyrostowej w sekundach.

IncrementalEvaluationMemberChanges

Typ danych: Uint32

Typ dostępu: Tylko do odczytu

Kwalifikatory: [odczyt]

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

IncrementalEvaluationMemberChangeTime

Typ danych: Datetime

Typ dostępu: Tylko do odczytu

Kwalifikatory: [odczyt]

Począwszy od wersji 2010, ostatni raz, kiedy 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, przyrostowa ocena czasu ostatniego odświeżania.

IsBuiltIn

Typ danych: Boolean

Typ dostępu: Read-Only

Kwalifikatory: [odczyt]

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

IsReferenceCollection

Typ danych: Boolean

Typ dostępu: Tylko do odczytu

Kwalifikatory: [odczyt]

Gdy ta wartość wynosi true, kolekcja nie jest ograniczona przez inną kolekcję.

ISVData

Typ danych: UInt8[]

Typ dostępu: Właściwość do odczytu i zapisu

Kwalifikatory: [duży, leniwy]

Przestrzeń danych umożliwiająca rozszerzanie partnerów.

ISVDataSize

Typ danych: UInt32

Typ dostępu: Właściwość do odczytu i zapisu

Kwalifikatory: [leniwe]

Rozmiar ISVData.

ISVString

Typ danych: String

Typ dostępu: Właściwość do odczytu i zapisu

Kwalifikatory: brak

Ciąg rozszerzalności partnerów.

LastChangeTime

Typ danych: DateTime

Typ dostępu: Właściwość do odczytu i zapisu

Kwalifikatory: brak

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

LastMemberChangeTime

Typ danych: DateTime

Typ dostępu: Właściwość do odczytu i zapisu

Kwalifikatory: brak

Data i godzina ostatniej modyfikacji członkostwa w kolekcji.

LastRefreshTime

Typ danych: DateTime

Typ dostępu: Właściwość do odczytu i zapisu

Kwalifikatory: brak

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

LimitToCollectionID

Typ danych: String

Typ dostępu: Właściwość do odczytu i zapisu

Kwalifikatory: brak

Identyfikator kolekcji ograniczającej.

LimitToCollectionName

Typ danych: DateTime

Typ dostępu: Właściwość do odczytu i zapisu

Kwalifikatory: brak

Nazwa kolekcji ograniczającej.

LocalMemberCount

Typ danych: SInt32

Typ dostępu: Tylko do odczytu

Kwalifikatory: [odczyt]

Liczba członków 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 członków kolekcji w SMS_Collection. Lokacja dynamicznie generuje nazwę klasy członkowskiej i jest pochodną klasy WMI SMS_CM_RES_COLL_CollectionID serwera.

MemberCount

Typ danych: SInt32

Typ dostępu: Tylko do odczytu

Kwalifikatory: [odczyt]

Liczba członków kolekcji.

MonitoringFlags

Typ danych: UInt32

Typ dostępu: Tylko do odczytu

Kwalifikatory: [odczyt]

Włącza zbieranie danych dla określonych rodzajów monitorowania.

Name

Typ danych: String

Typ dostępu: Właściwość do odczytu i zapisu

Kwalifikatory: [Not_null]

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

OwnedByThisSite

Typ danych: Boolean

Typ dostępu: Właściwość do odczytu i zapisu

Kwalifikator: Brak

truejeśli kolekcja pochodzi z lokalnej lokacji programu 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: Właściwość do odczytu i zapisu

Kwalifikatory: [max(15), leniwe]

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

RefreshType

Typ danych: UInt32

Typ dostępu: Właściwość do odczytu i zapisu

Kwalifikatory: [leniwe, wyliczenie]

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

Value Typ odświeżania
1 Instrukcja obsługi
2 Okresowy
4 Stała aktualizacja

Aby odświeżanie odświeżało się zgodnie z harmonogramem określonym w RefreshScheduleustawieniu , ustaw tę właściwość na okresową (2). Jeśli ustawisz tę właściwość na ręczną (1), ręcznie zaktualizuj kolekcję za pomocą metody RequestRefresh.

ReplicateToSubSites

Ta właściwość nie została zaimplementowana.

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ą serwera.

Uwagi

Kwalifikacje do tej klasy obejmują:

  • Zabezpieczone

Aby uzyskać więcej informacji zarówno o kwalifikatorach klas, jak i kwalifikatorach właściwości zawartych w sekcji właściwości, zobacz Kwalifikatory klasy i właściwości programu Configuration Manager.

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

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

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

Wymagania

Wymagania dotyczące środowiska uruchomieniowego

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

Wymagania dotyczące rozwoju

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

Zobacz też

Klasa WMI serwera SMS_CollectionRule

  • Last updated on