WMI-Serverklasse SMS_DistributionPoint

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

Die folgende Syntax wurde aus 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 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

Qualifikanten: [lesen]

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

IsPeerDP

Datentyp: Boolean

Zugriffstyp: Schreibgeschützt

Qualifikanten: [lesen]

true wenn der Verteilungspunkt ein Branch-Verteilungspunkt ist. Der Standardwert ist false.

IsProtected

Datentyp: Boolean

Zugriffstyp: Schreibgeschützt

Qualifikanten: [lesen]

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

ISVData

Datentyp: UInt8 Array

Zugriffstyp: Lesen/Schreiben

Qualifikanten: [groß, faul]

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

ISVDataSize

Datentyp: UInt32

Zugriffstyp: Lesen/Schreiben

Qualifikanten: [faul]

Die Größe der Daten, angegeben durch ISVData. Der Standardwert ist 0.

ISVString

Datentyp: String

Zugriffstyp: Lesen/Schreiben

Qualifikanten: keine

Zeichenfolge für die Partnererweiterbarkeit.

LastRefreshTime

Datentyp: DateTime

Zugriffstyp: Lesen/Schreiben

Qualifikanten: Keine

Datum und Uhrzeit, zu dem das Paket zuletzt auf dem Verteilungsserver aktualisiert wurde. Der Standardwert ist 19900101000000.000000+***.

ObjectTypeID

Datentyp: UInt32

Zugriffstyp: Schreibgeschützt

Qualifiers: [enumeration, read]

Gesicherte Objektklassen-ID.

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: Lesen/Schreiben

Qualifiers: [key]

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

PackageType

Datentyp: UInt32

Zugriffstyp: Schreibgeschützt

Qualifiers: [enumeration, read]

Der Pakettyp.

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

RefreshNow

Datentyp: Boolean

Zugriffstyp: Lesen/Schreiben

Qualifikanten: 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 auf 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 auf untergeordnete Websites repliziert. Der Standardwert ist false.

ResourceType

Datentyp: String

Zugriffstyp: Schreibgeschützt

Qualifikanten: [lesen]

Der Ressourcentyp des Verteilungspunkts. Der Standardwert ist "".

SecureObjectID

Datentyp: String

Zugriffstyp: Lesen/Schreiben

Qualifikanten: Keine

Schlüssel des Sicherheitsobjekts. Für die Anwendung ist es CI_UniqueID. Für package ist es PackageID.

ServerNALPath

Datentyp: String

Zugriffstyp: Lesen/Schreiben

Qualifiers: [key]

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

SiteCode

Datentyp: String

Zugriffstyp: Lesen/Schreiben

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

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

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

SiteName

Datentyp: String

Zugriffstyp: Lesen/Schreiben

Qualifikanten: Keine

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

SourceSite

Datentyp: String

Zugriffstyp: Lesen/Schreiben

Qualifier: [SizeLimit("3")]

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

Status

Datentyp: UInt32

Zugriffstyp: Schreibgeschützt

Qualifiers: [read, enumeration]

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

Wert DP package status
0 KEINE
1 AKTUALISIERT
2 HINZUGEFÜGT
3 GELÖSCHT

Hinweise

Für diese Klasse gibt es keine speziellen Klassenqualifikationen. Weitere Informationen zu den Klassen- und Eigenschaftskennzeichnern, die im Abschnitt Eigenschaften enthalten sind, finden Sie unter Klassen- und Eigenschaftskennzeichner im Configuration Manager.

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

Ihre Anwendung kann die PackageID Eigenschaft nach dem 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 WMI-Klassenklasse SMS_SystemResourceList Server enthält eine Liste der verfügbaren Verteilungspunkte und deren NAL-Pfade. Ihre Anwendung sollte die Eigenschaft SMS_SystemResourceList auswählen, die NALPath einer RoleName Eigenschaftseinstellung von "SMS-Verteilungspunkt" entspricht.

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

Es gibt keine Einschränkungen oder definierten Formate für die Daten, die von angegeben werden ISVData. Es ist jedoch wichtig, dass der ISV-Besitz an dieser Immobilie nicht überschrieben wird, nachdem er festgestellt wurde. Daher sollte die Anwendung zuerst die in dieser Eigenschaft vorhandenen Daten lesen. Wenn die Daten nicht dem 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 festgestellt werden kann.

Anforderungen

Laufzeitanforderungen

Weitere Informationen finden Sie unter Anforderungen an die Configuration Manager-Serverlaufzeit.

Entwicklungsanforderungen

Weitere Informationen finden Sie unter Anforderungen für die Serverentwicklung in Configuration Manager.

Siehe auch