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 Pakettyp.
| 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: [lesen, Aufzählung]
Aktuelle status des Pakets auf dem Verteilungspunkt. Mögliche Werte sind unten aufgeführt. Weitere Informationen finden Sie unter Hinweise.
| Wert | DP-Status |
|---|---|
| 0 | NICHTS |
| 1 | AKTUALISIERTE |
| 2 | ZUGEFÜGT |
| 3 | GELÖSCHT |
Hinweise
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 instance 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 instance von SMS_DistributionPointlöscht, wird die instance 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.