Klasa WMI serwera SMS_DistributionPoint

Klasa SMS_DistributionPoint WMI jest klasą serwera dostawcy wiadomości SMS w programie Configuration Manager. Reprezentuje punkt dystrybucji, z którego dany pakiet został rozesłany do klientów.

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_DistributionPoint : SMS_BaseClass
{
      Boolean BitsEnabled;
      Boolean IsPeerDP;
      Boolean IsProtected;
      UInt8 ISVData[];
      UInt32 ISVDataSize;
      String ISVString;
      DateTime LastRefreshTime;
      UInt32 ObjectTypeID;
      String PackageID;
      UInt32 PackageType;
      Boolean RefreshNow;
      String ResourceType;
      String SecureObjectID;
      String ServerNALPath;
      String SiteCode;
      String SiteName;
      String SourceSite;
      UInt32 Status;
};

Metody

Poniższa tabela zawiera listę metod dostępnych w SMS_DistributionPoint tej klasie.

Metoda Opis
Metoda VerifyPackage w klasie SMS_DistributionPoint Weryfikuje integralność pakietu.
Metoda CancelDistribution w klasie SMS_DistributionPoint Anuluje dystrybucję pakietu.

Właściwości

BitsEnabled

Typ danych: Boolean

Typ dostępu: Tylko do odczytu

Kwalifikatory: [odczyt]

true jeśli punkt dystrybucji obsługuje usługę BITS. Wartość domyślna to false.

IsPeerDP

Typ danych: Boolean

Typ dostępu: Tylko do odczytu

Kwalifikatory: [odczyt]

true jeśli punkt dystrybucji jest rozgałęzionym punktem dystrybucji. Wartość domyślna to false.

IsProtected

Typ danych: Boolean

Typ dostępu: Tylko do odczytu

Kwalifikatory: [odczyt]

true Jeśli system lokacji punktu dystrybucji jest chroniony. Wartość domyślna to false.

ISVData

Typ danych: UInt8 Tablica

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

Kwalifikatory: [duży, leniwy]

Wartości umożliwiają pojedynczemu niezależnemu dostawcy oprogramowania przechowywanie danych powiązanych z obiektem klasy WMI serwera SMS_Program skojarzonym z pakietem. Aby uzyskać więcej informacji, zobacz Spostrzeżenia.

ISVDataSize

Typ danych: UInt32

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

Kwalifikatory: [leniwe]

Rozmiar danych wskazywany przez ISVData. Wartość domyślna to 0.

ISVString

Typ danych: String

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

Kwalifikatory: brak

Ciąg dotyczący rozszerzalności partnerów.

LastRefreshTime

Typ danych: DateTime

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

Kwalifikatory: brak

Data i godzina ostatniej aktualizacji pakietu na serwerze dystrybucyjnym. Wartość domyślna to 19900101000000.000000+***.

ObjectTypeID

Typ danych: UInt32

Typ dostępu: Tylko do odczytu

Kwalifikatory: [wyliczenie, odczyt]

Identyfikator klasy zabezpieczonego obiektu.

Value Typ obiektu
2 SMS_Package
14 SMS_OperatingSystemInstallPackage
18 SMS_ImagePackage
19 SMS_BootImagePackage
23 SMS_DriverPackage
24 SMS_SoftwareUpdatesPackage
31 SMS_Application

PackageID

Typ danych: String

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

Kwalifikatory: [klucz]

Identyfikator pakietu, który został rozpowszechniony do tego punktu dystrybucji. Wartość domyślna to "".

PackageType

Typ danych: UInt32

Typ dostępu: Tylko do odczytu

Kwalifikatory: [wyliczenie, odczyt]

Typ pakietu.

Value Opis
0 Regularny pakiet dystrybucji oprogramowania
3 Pakiet sterownika
4 Pakiet sekwencji zadań
5 Pakiet aktualizacji oprogramowania
6 Pakiet ustawień urządzenia
257 Pakiet obrazów
258 Pakiet obrazu rozruchowego
259 Pakiet aktualizacji systemu operacyjnego

RefreshNow

Typ danych: Boolean

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

Kwalifikatory: brak

trueaby zasygnalizować usłudze Configuration Manager zaktualizowanie pakietu w punkcie dystrybucji. Aktualizacja jest specyficzna dla punktu dystrybucji i jest równoważna akcji Odśwież punkt dystrybucji w konsoli programu Configuration Manager. Ta aktualizacja pakietu kopiuje najnowszą zawartość ze źródła pakietu do określonego punktu dystrybucji, dzięki czemu punkt dystrybucji ma najnowszą wersję. Wersja źródłowa pakietu nie jest zwiększana, a zawartość pakietu nie jest replikowana do witryn podrzędnych. Wartość domyślna to false.

ResourceType

Typ danych: String

Typ dostępu: Tylko do odczytu

Kwalifikatory: [odczyt]

Typ zasobu punktu dystrybucji. Wartość domyślna to "".

SecureObjectID

Typ danych: String

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

Kwalifikatory: brak

Klucz obiektu zabezpieczeń. Do zastosowania jest CI_UniqueID. W przypadku pakietu jest to identyfikator_pakietu.

ServerNALPath

Typ danych: String

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

Kwalifikatory: [klucz]

Ścieżka warstwy abstrakcji sieci (NAL, Network Abstraction Layer) do serwera punktu dystrybucji. Wartość domyślna to "". Aby uzyskać więcej informacji, zobacz Spostrzeżenia.

SiteCode

Typ danych: String

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

Kwalifikatory: [key, SizeLimit("3")]

Kod lokacji witryny, do której należy ten punkt dystrybucji. Wartość domyślna to "".

Wartość, która jest dostarczona dla tej nieruchomości, musi być zgodna z wartością ServerNALPath. Aplikacja pobiera wartość z klasy WMI SMS_SystemResourceList serwera. Aby uzyskać więcej informacji, zobacz Spostrzeżenia.

SiteName

Typ danych: String

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

Kwalifikatory: brak

Przyjazna nazwa witryny, z której pochodzi pakiet. Wartość domyślna to "".

SourceSite

Typ danych: String

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

Kwalifikatory: [SizeLimit("3")]

Kod witryny źródłowej pakietu. Wartość domyślna to "".

Status

Typ danych: UInt32

Typ dostępu: Tylko do odczytu

Kwalifikatory: [odczyt, wyliczenie]

Bieżący stan pakietu w punkcie dystrybucji. Poniżej przedstawiono możliwe wartości. Aby uzyskać więcej informacji, zobacz Spostrzeżenia.

Value Stan pakietu DP
0 BRAK
1 ZAKTUALIZOWANO
2 DODANO
3 SKREŚLA NUMER

Uwagi

Nie ma specjalnych kwalifikatorów klas dla tej klasy. 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 klas i właściwości programu Configuration Manager.

Punkt dystrybucji jest zawsze skojarzony z konkretnym pakietem, a pakiet może mieć kilka punktów dystrybucji.

Aplikacja nie może zmienić właściwości PackageID po utworzeniu punktu dystrybucji. Aby skojarzyć punkt dystrybucji z innym pakietem, aplikacja musi usunąć SMS_DistributionPoint obiekt i utworzyć nowe wystąpienie z nową PackageID wartością.

Klasa klasy WMI serwera SMS_SystemResourceList zawiera listę dostępnych punktów dystrybucji i ich ścieżek NAL. Aplikacja powinna wybrać NALPath właściwość SMS_SystemResourceList odpowiadającą ustawieniu RoleName właściwości "Punkt dystrybucji SMS".

Gdy aplikacja usunie wystąpienie SMS_DistributionPoint, nie zostanie ono całkowicie usunięte, dopóki nie zostaną usunięte powiązane z nim składniki. Zamiast tego program Configuration Manager ustawia właściwość Status na 3 (usuń), aby poinformować aplikację, że punkt dystrybucji jest oznaczony do usunięcia. Aby upewnić się, że zapytanie nie pobiera punktów dystrybucji, które zostały usunięte lub oznaczone do usunięcia, aplikacja powinna dodać ten przypadek do klauzuli WHERE.

Nie ma żadnych ograniczeń ani zdefiniowanych formatów danych, które są wskazywane przez ISVData. Należy jednak pamiętać, że po ustaleniu prawa własności ISV do tej właściwości nie należy jej zastępować. W związku z tym aplikacja powinna najpierw odczytać istniejące dane w tej właściwości. Jeśli dane nie należą do obiektu wywołującego, nie należy ich modyfikować. Każdy niezależny dostawca ISV lub aplikacja korzystająca z tej właściwości powinna zawierać identyfikator w danych, aby można było łatwo ustalić własność.

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ż