WMI-Serverklasse SMS_DistributionPoint

Die SMS_DistributionPoint WMI-Klasse ist eine SMS-Anbieter-Serverklasse in Configuration Manager. Es stellt einen Verteilungspunkt dar, von dem aus ein bestimmtes Paket an Clients verteilt wurde.

Die folgende Syntax wird vom MOF-Code (Managed Object Format) vereinfacht und enthält alle geerbten Eigenschaften.

Syntax

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

Methoden

In der folgenden Tabelle sind die Methoden in der SMS_DistributionPoint -Klasse aufgeführt.

Methode Beschreibung
VerifyPackage-Methode in der Klasse SMS_DistributionPoint Überprüft die Integrität des Pakets.
CancelDistribution-Methode in der Klasse SMS_DistributionPoint Bricht die Verteilung eines Pakets ab.

Eigenschaften

BitsEnabled

Datentyp: Boolean

Zugriffstyp: Schreibgeschützt

Qualifizierer: [lesen]

true , wenn der Verteilungspunkt BITS-fähig ist. Der Standardwert ist false.

IsPeerDP

Datentyp: Boolean

Zugriffstyp: Schreibgeschützt

Qualifizierer: [lesen]

true , wenn der Verteilungspunkt ein Branchverteilungspunkt ist. Der Standardwert ist false.

IsProtected

Datentyp: Boolean

Zugriffstyp: Schreibgeschützt

Qualifizierer: [lesen]

true , wenn das Standortsystem des Verteilungspunkts geschützt ist. Der Standardwert ist false.

ISVData

Datentyp: UInt8 Array

Zugriffstyp: Lese-/Schreibzugriff

Qualifizierer: [groß, lazy]

Werte ermöglichen es einem einzelnen ISV, Daten zu speichern, die sich auf das SMS_Program Server WMI Class-Objekt beziehen, das dem Paket zugeordnet ist. Weitere Informationen finden Sie unter Hinweise.

ISVDataSize

Datentyp: UInt32

Zugriffstyp: Lese-/Schreibzugriff

Qualifizierer: [lazy]

Die Größe der daten, die durch angegeben werden ISVData. Der Standardwert ist 0.

ISVString

Datentyp: String

Zugriffstyp: Lese-/Schreibzugriff

Qualifizierer: keine

Zeichenfolge für die Partnererweiterbarkeit.

LastRefreshTime

Datentyp: DateTime

Zugriffstyp: Lese-/Schreibzugriff

Qualifizierer: Keine

Datum und Uhrzeit der letzten Aktualisierung des Pakets auf dem Verteilungsserver. Der Standardwert ist 19900101000000.000000+***.

ObjectTypeID

Datentyp: UInt32

Zugriffstyp: Schreibgeschützt

Qualifizierer: [enumeration, read]

ID der geschützten Objektklasse.

Wert Objekttyp
2 SMS_Package
14 SMS_OperatingSystemInstallPackage
18 SMS_ImagePackage
19 SMS_BootImagePackage
23 SMS_DriverPackage
24 SMS_SoftwareUpdatesPackage
31 SMS_Application

PackageID

Datentyp: String

Zugriffstyp: Lese-/Schreibzugriff

Qualifizierer: [Schlüssel]

ID für das Paket, das an diesen Verteilungspunkt verteilt wurde. Der Standardwert ist "".

PackageType

Datentyp: UInt32

Zugriffstyp: Schreibgeschützt

Qualifizierer: [enumeration, read]

Der Typ des Pakets.

Wert Beschreibung
0 Reguläres Softwareverteilungspaket
3 Treiberpaket
4 Tasksequenzpaket
5 Softwareupdatepaket
6 Geräteeinstellungspaket
257 Imagepaket
258 Startabbildpaket
259 Betriebssystemupgradepaket

RefreshNow

Datentyp: Boolean

Zugriffstyp: Lese-/Schreibzugriff

Qualifizierer: Keine

true, um Configuration Manager zu signalisieren, das Paket auf dem Verteilungspunkt zu aktualisieren. Das Update ist verteilungspunktspezifisch und entspricht der Aktion Verteilungspunkt aktualisieren in der Configuration Manager-Konsole. Dieses Paketupdate kopiert den neuesten Inhalt aus der Quelle des Pakets an einen bestimmten Verteilungspunkt, sodass der Verteilungspunkt über die neueste Version verfügt. Die Quellversion des Pakets wird nicht erhöht, und der Paketinhalt wird nicht an untergeordnete Websites repliziert. Der Standardwert ist false.

ResourceType

Datentyp: String

Zugriffstyp: Schreibgeschützt

Qualifizierer: [lesen]

Der Ressourcentyp des Verteilungspunkts. Der Standardwert ist "".

SecureObjectID

Datentyp: String

Zugriffstyp: Lese-/Schreibzugriff

Qualifizierer: Keine

Sicherheitsobjektschlüssel. Für die Anwendung ist es CI_UniqueID. Für das Paket ist dies PackageID.

ServerNALPath

Datentyp: String

Zugriffstyp: Lese-/Schreibzugriff

Qualifizierer: [Schlüssel]

NAL-Pfad (Network Abstraction Layer) zum Verteilungspunktserver. Der Standardwert ist "". Weitere Informationen finden Sie unter Hinweise.

SiteCode

Datentyp: String

Zugriffstyp: Lese-/Schreibzugriff

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

Standortcode des Standorts, zu dem dieser Verteilungspunkt gehört. Der Standardwert ist "".

Der Wert, der für diese Eigenschaft eingerichtet wird, muss mit dem Wert von ServerNALPathübereinstimmen. Ihre Anwendung ruft den Wert aus SMS_SystemResourceList WMI-Serverklasse ab. Weitere Informationen finden Sie unter Hinweise.

SiteName

Datentyp: String

Zugriffstyp: Lese-/Schreibzugriff

Qualifizierer: Keine

Anzeigename des Standorts, von dem das Paket stammt. Der Standardwert ist "".

SourceSite

Datentyp: String

Zugriffstyp: Lese-/Schreibzugriff

Qualifizierer: [SizeLimit("3")]

Standortcode der Website, von der das Paket stammt. Der Standardwert ist "".

Status

Datentyp: UInt32

Zugriffstyp: Schreibgeschützt

Qualifizierer: [read, enumeration]

Aktueller Status des Pakets auf dem Verteilungspunkt. Mögliche Werte sind unten aufgeführt. Weitere Informationen finden Sie unter Hinweise.

Wert DP-Paketstatus
0 NICHTS
1 AKTUALISIERTE
2 HINZUGEFÜGT
3 GELÖSCHT

HinwBemerkungeneise

Für diese Klasse gibt es keine speziellen Klassenqualifizierer. Weitere Informationen sowohl zu den Klassenqualifizierern als auch zu den Eigenschaftenqualifizierern, die im Abschnitt Eigenschaften enthalten sind, finden Sie unter Configuration Manager Klassen- und Eigenschaftenqualifizierer.

Ein Verteilungspunkt ist immer einem bestimmten Paket zugeordnet, und ein Paket kann mehrere Verteilungspunkte aufweisen.

Ihre Anwendung kann die Eigenschaft nach dem PackageID Erstellen des Verteilungspunkts nicht mehr ändern. Um den Verteilungspunkt einem anderen Paket zuzuordnen, muss die Anwendung das SMS_DistributionPoint Objekt löschen und eine neue Instanz mit einem neuen PackageID Wert erstellen.

Die SMS_SystemResourceList-Server-WMI-Klassenklasse enthält eine Liste der verfügbaren Verteilungspunkte und deren NAL-Pfade. Ihre Anwendung sollte die NALPath -Eigenschaft von SMS_SystemResourceList auswählen, die einer RoleName Eigenschaftseinstellung von "SMS-Verteilungspunkt" entspricht.

Wenn Ihre Anwendung eine Instanz von SMS_DistributionPointlöscht, wird die Instanz erst vollständig gelöscht, wenn die zugehörigen Komponenten gelöscht wurden. Stattdessen legt Configuration Manager die Status -Eigenschaft auf 3 (löschen) fest, um die Anwendung darüber zu informieren, dass der Verteilungspunkt zum Löschen markiert ist. Um sicherzustellen, dass eine Abfrage keine Verteilungspunkte abruft, die gelöscht oder zum Löschen markiert wurden, sollte Ihre Anwendung diesen Fall der WHERE-Klausel hinzufügen.

Es gibt keine Einschränkungen oder definierten Formate für die Daten, die durch ISVDataangegeben werden. Es ist jedoch wichtig, dass sie nicht überschrieben werden sollte, nachdem der ISV-Besitz an dieser Eigenschaft eingerichtet wurde. Daher sollte die Anwendung zuerst die vorhandenen Daten in dieser Eigenschaft lesen. Wenn die Daten nicht zum Aufrufer gehören, sollten sie nicht geändert werden. Jeder ISV oder jede Anwendung, die diese Eigenschaft verwendet, sollte einen Bezeichner in den Daten enthalten, damit der Besitz einfach hergestellt werden kann.

Anforderungen

Laufzeitanforderungen

Weitere Informationen finden Sie unter Configuration Manager Serverruntimeanforderungen.

Entwicklungsanforderungen

Weitere Informationen finden Sie unter Configuration Manager Serverentwicklungsanforderungen.

Siehe auch