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 Trennung 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 PreferredAddressType
Zeitplan 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 ISVData
in 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
, Name
und 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 das Paket status enthält.
MIFName
Datentyp: String
Zugriffstyp: Lese-/Schreibzugriff
Qualifizierer: Keine
Name der MIF-Datei, die das Programm status 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 MIFName , MIFPublisher und MIFVersion für den MIF-Dateiabgleich verwendet status. Andernfalls verwendet Name Configuration Manager , Manufacturer und Version für status Abgleich. 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 zum Vergleichen mit der Objektversion in der Datenbank verwendet wird. 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 ShareName
angeben.
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.
Hinweise
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 in der MIFFileName
-Eigenschaft angegebenen MIF-Installationsdatei status. Wenn Configuration Manager die Datei nicht findet, sucht es nach allen MIF-Dateien in diesen Verzeichnissen. Die Werte für MIFName
, MIFPublisher
und MIFVersion
werden mit den in der MIF-Datei angegebenen Werten ohne Berücksichtigung der Groß-/Kleinschreibung verglichen. Wenn eine Übereinstimmung gefunden wird, wird die in der MIF-Datei angegebene status als Installations-status für das Programm verwendet, was 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 installations-status 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.