WMI-Klasse des SMS_PackageBaseclass-Servers

Die SMS_PackageBaseclass WMI-Klasse (Windows Management Instrumentation) ist eine SMS-Anbieter-Serverklasse in Configuration Manager, die als abstrakte Basisklasse für alle Pakete dient, z. B. SMS_BootImagePackage Server-WMI-Klasse, SMS_DriverPackage Server-WMI-Klasse und SMS_SoftwareUpdatesPackage Server-WMI-Klasse.

Syntax

Class SMS_PackageBaseclass : SMS_BaseClass  
{  
      UInt32 ActionInProgress;  
      String AlternateContentProviders;  
      String Description;  
      UInt8 ExtendedData[];  
      UInt32 ExtendedDataSize;  
      UInt32 ForcedDisconnectDelay;  
      Boolean ForcedDisconnectEnabled;  
      UInt32 ForcedDisconnectNumRetries;  
      UInt8 Icon[];  
      UInt32 IconSize;  
      Boolean IgnoreAddressSchedule;  
      UInt8 ISVData[];  
      UInt32 ISVDataSize;  
      String ISVString;  
      String Language;  
      DateTime LastRefreshTime;  
      String LocalizedCategoryInstanceNames[];  
      String Manufacturer;  
      String MIFFilename;  
      String MIFName;  
      String MIFPublisher;  
      String MIFVersion;  
      String Name;  
      UInt32 NumOfPrograms;  
      String PackageID;  
      UInt32 PackageSize;  
      UInt32 PackageType;  
      UInt32 PkgFlags;  
      UInt32 PkgSourceFlag;  
      String PkgSourcePath;  
      String PreferredAddressType;  
      UInt32 Priority;  
      Boolean RefreshPkgSourceFlag;  
      SMS_ScheduleToken RefreshSchedule[];  
      String SecuredScopeNames[];  
      String SedoObjectVersion;  
      String ShareName;  
      UInt32 ShareType;  
      DateTime SourceDate;  
      String SourceSite;  
      UInt32 SourceVersion;  
      String StoredPkgPath;  
      UInt32 StoredPkgVersion;  
      String Version;  
};  

Methoden

Die SMS_PackageBaseclass -Klasse definiert keine Methoden.

Eigenschaften

ActionInProgress'

Datentyp: UInt32

Zugriffstyp: Schreibgeschützt

Qualifizierer: [lesen]

Die aktuelle Aktion, die von Configuration Manager für das Paket ausgeführt wird. Die folgenden Werte sind möglich:

Wert Beschreibung
0 NICHTS
1 UPDATE
2 Hinzufügen
3 LÖSCHEN

AlternateContentProviders

Datentyp: String

Zugriffstyp: Lese-/Schreibzugriff

Qualifizierer: [groß, lazy]

Eine XML-Zeichenfolge zum Festlegen alternativer Inhaltsanbietereinstellungen. Diese Eigenschaft gilt nicht für ein Softwareupdatepaket oder ein Treiberpaket.

Beschreibung

Datentyp: String

Zugriffstyp: Lese-/Schreibzugriff

Qualifizierer: Keine

Die lange Beschreibung des Pakets.

ExtendedData

Datentyp: UInt8 Array

Zugriffstyp: Lese-/Schreibzugriff

Qualifizierer: [groß, lazy]

Das XML-Blob für die Imagebereitstellung.

ExtendedDataSize

Datentyp: UInt32

Zugriffstyp: Lese-/Schreibzugriff

Qualifizierer: [lazy]

Die Größe der erweiterten Daten für das Paket. Der Standardwert ist 0.

ForcedDisconnectDelay

Datentyp: UInt32

Zugriffstyp: Lese-/Schreibzugriff

Qualifizierer: Keine

Die Zeit in Minuten, die Configuration Manager wartet, bevor die Verbindung von Benutzern von der Verteilungspunktfreigabe erzwungen wird. Der Standardwert beträgt 5 Minuten.

ForcedDisconnectEnabled

Datentyp: Boolean

Zugriffstyp: Lese-/Schreibzugriff

Qualifizierer: Keine

true, wenn Configuration Manager beim Aktualisieren, Aktualisieren oder Löschen von Paketquelldateien die Verbindung von Benutzern von der Verteilungspunktfreigabe erzwungen werden soll, wenn ein Freigabeverstoß auftritt. Der Standardwert ist false.

Hinweis

Aktivieren Sie diese Eigenschaft mit Vorsicht. Das Erzwungene Trennen von Benutzern kann negative Auswirkungen auf den Client haben.

ForcedDisconnectNumRetries

Datentyp: UInt32

Zugriffstyp: Lese-/Schreibzugriff

Qualifizierer: Keine

Gibt an, wie oft Configuration Manager versucht, einen Benutzer von der Verteilungspunktfreigabe zu trennen. Die Standardanzahl von Wiederholungen ist 2.

Symbol

Datentyp: UInt8 Array

Zugriffstyp: Lese-/Schreibzugriff

Qualifizierer: [groß]

Optional. Array, das die Datei darstellt, die das Symbol enthält, das für das Paket verwendet werden soll. Wenn es verwendet wird, ersetzt dieses Symbol das Standardpaketsymbol in der Configuration Manager-Konsole.

IconSize

Datentyp: UInt32

Zugriffstyp: Lese-/Schreibzugriff

Qualifizierer: [lazy]

Die Größe des Symbols in Bytes. Der Standardwert ist 0. Legen Sie diese Eigenschaft auf 0 fest, um das Symbol zu löschen.

IgnoreAddressSchedule

Datentyp: Boolean

Zugriffstyp: Lese-/Schreibzugriff

Qualifizierer: Keine

true, wenn Configuration Manager einen durch angegebenen PreferredAddressTypeZeitplan des Absenders ignoriert. Der Standardwert ist false.

ISVData

Datentyp: UInt8 Array

Zugriffstyp: Lese-/Schreibzugriff

Qualifizierer: [groß, lazy]

ISV-Erweiterbarkeitsdaten.

ISVDataSize

Datentyp: UInt32

Zugriffstyp: Lese-/Schreibzugriff

Qualifizierer: [lazy]

Die Größe von ISVDatain Bytes. Der Standardwert ist 0.

ISVString

Datentyp: String

Zugriffstyp: Lese-/Schreibzugriff

Qualifizierer: keine

Zeichenfolge für die Partnererweiterbarkeit.

Sprache

Datentyp: String

Zugriffstyp: Lese-/Schreibzugriff

Qualifizierer: Keine

Die Sprache des Pakets. Diese Eigenschaft wird mit Manufacturer, Nameund Version verwendet, um ein Paket in der Konsole zu identifizieren. Sie können z. B. eine englische und eine deutsche Version desselben Pakets verwenden.

LastRefreshTime

Datentyp: DateTime

Zugriffstyp: Schreibgeschützt

Qualifizierer: [lesen]

Das Datum und die Uhrzeit der letzten Aktualisierung der Paketquelle an ihren Verteilungspunkten.

LocalizedCategoryInstanceNames

Datentyp: String Array

Zugriffstyp: Schreibgeschützt

Qualifizierer: [lesen]

Lokalisierte Namen der Kategorien, zu denen das Konfigurationselement gehört.

Hersteller

Datentyp: String

Zugriffstyp: Lese-/Schreibzugriff

Qualifizierer: Keine

Der Hersteller (Herausgeber) des Pakets.

MIFFilename

Datentyp: String

Zugriffstyp: Lese-/Schreibzugriff

Qualifizierer: Keine

Der Name der MIF-Datei (Management Information Format), die den Paketstatus enthält.

MIFName

Datentyp: String

Zugriffstyp: Lese-/Schreibzugriff

Qualifizierer: Keine

Name der MIF-Datei, die den Programmstatus für das Paket enthält. Die Dateinamenerweiterung muss MIF sein. Weitere Informationen finden Sie im Abschnitt "Hinweise" weiter unten in diesem Thema.

MIFPublisher

Datentyp: String

Zugriffstyp: Lese-/Schreibzugriff

Qualifizierer: Keine

Der Name des Softwareherausgebers des Pakets.

MIFVersion

Datentyp: String

Zugriffstyp: Lese-/Schreibzugriff

Qualifizierer: Keine

Die Versionsnummer des Pakets.

Name

Datentyp: String

Zugriffstyp: Lese-/Schreibzugriff

Qualifizierer: Keine

Der Name des Pakets. Der Standardname ist "".

NumOfPrograms

Datentyp: UInt32

Zugriffstyp: Lese-/Schreibzugriff

Qualifizierer: Keine

Die Anzahl der Programme, über die das Paket verfügt.

PackageID

Datentyp: String

Zugriffstyp: [Schlüssel]

Ein eindeutiger, automatisch generierter Schlüssel, der verwendet wird, um Programme, Ankündigungen und Verteilungspunkte mit dem Paket zu verknüpfen.

PackageSize

Datentyp: UInt32

Zugriffstyp: Lesen

Größe des Pakets.

PackageType

Datentyp: UInt32

Zugriffstyp: Lese-/Schreibzugriff

Qualifizierer: Keine

Der Typ des Pakets. Die folgenden Werte sind möglich:

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

PkgFlags

Datentyp: UInt32

Zugriffstyp: Lese-/Schreibzugriff

Qualifizierer: [Bits]

Flags, die spezielle Eigenschaften des Pakets angeben. Die folgenden Werte sind möglich:

Hexadezimal (Bit) Beschreibung
0x0100011 (23) DO_NOT_ENCRYPT_CONTENT_ON_CLOUD. Verschlüsseln Sie keine Inhalte in der Cloud.

Diese Informationen gelten für System Center 2012 Configuration Manager SP1 oder höher und System Center 2012 R2 Configuration Manager oder höher.
0x01000000 (24) DO_NOT_DOWNLOAD. Laden Sie das Paket nicht auf Verzweigungsverteilungspunkte herunter, da es vorab bereitgestellt wird.
0x02000000 (25) PERSIST_IN_CACHE. Speichern Sie das Paket im Cache.
0x04000000 (26) USE_BINARY_DELTA_REP. Markiert das Paket, das vom Verteilungs-Manager mithilfe der binären Deltareplikation repliziert werden soll.
0x10000000 (28) NO_PACKAGE. Das Paket erfordert keine Verteilungspunkte.
0x20000000 (29) USE_SPECIAL_MIF. Dieser Wert bestimmt, ob Configuration Manager , MIFPublisherund MIFVersion für den MIF-Dateistatusabgleich verwendetMIFName. Andernfalls verwendet NameConfiguration Manager , Manufacturerund Version für den Statusabgleich. Weitere Informationen finden Sie im Abschnitt "Hinweise" weiter unten in diesem Thema.
0x40000000 (30) DISTRIBUTE_ON_DEMAND. Das Paket darf bei Bedarf an Verzweigungsverteilungspunkte verteilt werden.

PkgSourceFlag

Datentyp: UInt32

Zugriffstyp: Lese-/Schreibzugriff

Qualifizierer: Keine

Flag, das die Methode zum Lesen der Paketquelldateien angibt. Mögliche Werte sind unten aufgeführt. Der Standardwert ist STORAGE_NO_SOURCE (1).

Wert Beschreibung
0 STORAGE_NEEDS_SPECIFYING. Der Benutzer gibt den Quelldateispeicher an.
1 STORAGE_NO_SOURCE. Das Programm verwendet keine Quelldateien.
2 STORAGE_DIRECT. Nehmen Sie Quelldateien direkt aus der Quelle ohne Komprimierung. Verwenden Sie dieses Flag, wenn sich die Quelldateien auf dem lokalen Server befinden oder wenn ein UNC-Pfad (Universal Naming Convention) zu einem persistenten Speicherort angegeben wurde.
3 STORAGE_COMPRESS. Dieses Flag ist veraltet.
4 STORAGE_LOCAL. Quelldateien aus einer lokalen Quelle verwenden.

PkgSourcePath

Datentyp: String

Zugriffstyp: Lese-/Schreibzugriff

Qualifizierer: Keine

Speicherort der Dateien von Updateinhalten, die durch das Paket dargestellt werden. Der Speicherort kann entweder ein vollständiger lokaler Pfad oder ein UNC-Pfad sein. Stellen Sie sicher, dass dieser Speicherort alle Dateien und Unterverzeichnisse enthält, die zum Abschließen des Programms erforderlich sind, einschließlich aller Skripts.

PreferredAddressType

Datentyp: String

Zugriffstyp: Lese-/Schreibzugriff

Qualifizierer: Keine

Bevorzugter Absender, der beim Kopieren der Paketquelldateien auf Verteilungspunkte verwendet werden soll. Mögliche Werte sind unten aufgeführt. Configuration Manager bestimmt, welcher Absender verwendet werden soll, wenn kein Wert angegeben wird.

  • ADDR_NONE()
  • ADR_LAN(MS_LAN)
  • ADDR_MAPI(MS_MAPI)
  • ADDR_RAS_ASYNC(MS_ASYNC_RAS)
  • ADDR_RAS_ISDN(MS_ISDN_RAS)
  • ADDR_RAS_X25(MS_X25_RAS)
  • ADDR_RAS_SNA(MS_SNA_RAS)
  • ADDR_SNA_BATCH(MS_BATCH_SNA)
  • ADDR_SNA_INTER(MS_INTER_SNA)
  • ADDR_COURIER(MS_COURIER)

Priorität

Datentyp: UInt32

Zugriffstyp: Lese-/Schreibzugriff

Qualifizierer: Keine

Sendepriorität des Pakets. Mögliche Werte werden für die Priority -Eigenschaft von SMS_Advertisement Server WMI-Klasse definiert.

RefreshPkgSourceFlag

Datentyp: Boolean

Zugriffstyp: Lese-/Schreibzugriff

Qualifizierer: [lazy]

true, wenn Configuration Manager die Paketquelldateien aktualisieren sollen. Der Standardwert ist false. Diese Eigenschaft enthält false beim Lesen immer.

Das Festlegen dieser Eigenschaft auf true hat die gleiche Auswirkung wie das Aufrufen der RefreshPkgSource-Methode in Class SMS_Package.

Verwenden Sie diese Eigenschaft nicht, um die Paketquelldateien zu aktualisieren. Verwenden Sie stattdessen die RefreshPkgSource -Methode.

RefreshSchedule

Datentyp: SMS_ScheduleToken Array

Zugriffstyp: [max(15), lazy]

Ein eingebettetes Array von SMS_ScheduleToken -Objekten, die definieren, wann Configuration Manager, aktualisiert die Paketquelldateien an den Verteilungspunkten. Sie können einen Aktualisierungszeitplan nur angeben, wenn PkgSourceFlag STORAGE_DIRECT ist.

SecuredScopeNames

Datentyp: String Array

Zugriffstyp: Schreibgeschützt

Qualifizierer: [lesen]

Stellt die Sicherheitsbereiche dar, zu denen das Paket gehört.

SedoObjectVersion

Datentyp: String

Zugriffstyp: Schreibgeschützt

Qualifizierer: [lesen]

Die Objektversion, die beim Aktualisieren des Objekts verwendet wird, um mit der Objektversion in der Datenbank zu vergleichen. Wenn die Objektversion nicht übereinstimmt, schlägt das Update fehl.

ShareName

Datentyp: String

Zugriffstyp: Lese-/Schreibzugriff

Qualifizierer: Keine

Freigabe, die auf dem Verteilungspunkt verwendet werden soll. Der Name kann Verzeichnisse enthalten. Wenn die Verzeichnisse nicht vorhanden sind, erstellt Configuration Manager sie. Sie müssen einen Freigabenamen angeben, wenn Sie auf SHARE_SPECIFIC festlegen ShareType .

ShareType

Datentyp: UInt32

Zugriffstyp: Lese-/Schreibzugriff

Qualifizierer: Keine

Der Typ der Freigabe, die vom Verteilungspunkt bei der Freigabe des Pakets verwendet wird. Mögliche Werte sind unten aufgeführt, wobei der Standardwert SHARE_COMMON. Wenn Sie SHARE_SPECIFIC angeben, müssen Sie einen Wert für ShareNameangeben.

Wert Beschreibung
1 SHARE_COMMON
2 SHARE_SPECIFIC

SourceDate

Datentyp: DateTime

Zugriffstyp: Schreibgeschützt

Qualifizierer: [lesen]

Datum und Uhrzeit der letzten Aktualisierung der Paketquelldateien auf den Verteilungspunkten.

SourceSite

Datentyp: String

Zugriffstyp: Schreibgeschützt

Qualifizierer: [lesen]

Der Standortcode der Website, von der das Paket stammt.

Sourceversion

Datentyp: UInt32

Zugriffstyp: Schreibgeschützt

Qualifizierer: [lesen]

Die Version des Pakets, die am Standort verfügbar ist. Wird erhöht, wenn das Paket aktualisiert oder die Quelldateien aktualisiert werden.

StoredPkgPath

Datentyp: String

Zugriffstyp: Lese-/Schreibzugriff

Qualifizierer: Keine

Vollständiger Pfad zu dem Speicherort, an dem Configuration Manager die komprimierte Version der Quelldateien auf dem Standortserver speichert. Dieser Pfad wird von Configuration Manager festgelegt, wenn der Wert von PkgSourceFlag STORAGE_COMPRESS ist.

StoredPkgVersion

Datentyp: UInt32

Zugriffstyp: Lese-/Schreibzugriff

Qualifizierer: Keine

Die Version der komprimierten Quelldateien für das gespeicherte Paket. Der Standardwert ist 0.

Version

Datentyp: String

Zugriffstyp: Lese-/Schreibzugriff

Qualifizierer: Keine

Die Version des Pakets.

HinwBemerkungeneise

Klassenqualifizierer für diese Klasse sind:

  • Abstrakt

Weitere Informationen sowohl zu den Klassenqualifizierern als auch zu den Eigenschaftenqualifizierern, die im Abschnitt Eigenschaften enthalten sind, finden Sie unter Configuration Manager Klassen- und Eigenschaftsqualifizierer.

Wenn Sie das USE_SPECIAL_MIF-Flag der PkgFlags Eigenschaft festlegen, sucht Configuration Manager im Verzeichnis %TEMP% oder im Verzeichnis %windir% nach der MIF-Datei des Installationsstatus, die in der MIFFileName -Eigenschaft angegeben ist. Wenn Configuration Manager die Datei nicht findet, sucht es nach allen MIF-Dateien in diesen Verzeichnissen. Die Werte für MIFName, MIFPublisherund MIFVersion werden mit den in der MIF-Datei angegebenen Werten ohne Berücksichtigung der Groß-/Kleinschreibung verglichen. Wenn eine Übereinstimmung gefunden wird, wird der in der MIF-Datei angegebene Status als Installationsstatus für das Programm verwendet, der angibt, ob das Programm erfolgreich ausgeführt wurde. Wenn Configuration Manager keine Übereinstimmung finden oder USE_SPECIAL_MIF nicht angegeben ist, verwendet Configuration Manager den Programmendcode, um den Installationsstatus für das Programm festzulegen. Ein Exitcode von 0 (null) wird als erfolgreich betrachtet. Alle anderen Werte werden als anwendungsspezifische Fehlercodes betrachtet.

Anforderungen

Laufzeitanforderungen

Weitere Informationen finden Sie unter anforderungen an Configuration Manager Server Runtime.

Entwicklungsanforderungen

Weitere Informationen finden Sie unter Configuration Manager Serverentwicklungsanforderungen.

Siehe auch

Erstellen eines Pakets
PowerShell-Cmdlet: New-CMPackage