GetTsPoliciesSaMedia-Methode in der Klasse SMS_TaskSequencePackage
Die GetTsPoliciesSaMedia
WMI-Klassenmethode (Windows Management Instrumentation) in Configuration Manager ruft alle Richtlinien ab, die der angegebenen Tasksequenz zugeordnet sind. Der Benutzer muss über Rechte zum Erstellen eigenständiger Medien verfügen.
Die folgende Syntax wird von MOF-Code (Managed Object Format) vereinfacht und definiert die -Methode.
Syntax
SInt32 GetTsPoliciesSaMedia (
String AdvertisementID,
String PackageID,
SMS_TaskSequence TaskSequence,
String AdvertisementName,
String AdvertisementComment,
UInt32 AdvertisementFlags,
String BootImageID,
String SourceSite,
String PolicyXmls[],
String PolicyAssignmentXmls[]
);
Parameter
AdvertisementID
Datentyp: String
Qualifizierer: [in]
Eine benutzerdefinierte Ankündigungs-ID, die in die Richtlinie eingebettet werden soll. Diese ID darf nicht mit anderen Werbe-IDs in Konflikt stehen, die von der Website erstellt wurden.
PackageID
Datentyp: String
Qualifizierer: [in]
Die ID für das Tasksequenzpaket, wenn die Methode die Richtlinie für eine Tasksequenz abrufen soll, die in der Configuration Manager-Datenbank gespeichert ist. Entweder PackageID
oder TaskSequence
können nicht NULL sein, aber nicht beide Parameter.
TaskSequence
Datentyp: SMS_TaskSequence
Qualifizierer: [in]
SMS_TaskSequence WMI-Klassenobjekt des Servers , das die Tasksequenz darstellt. Entweder PackageID
oder TaskSequence
können nicht NULL sein, aber nicht beide Parameter.
AdvertisementName
Datentyp: String
Qualifizierer: [in]
Ein benutzerdefinierter Name für die Ankündigung.
AdvertisementComment
Datentyp: String
Qualifizierer: [in]
Ein benutzerdefinierter Kommentar für die Ankündigung.
AdvertisementFlags
Datentyp: UInt32
Qualifizierer: [in]
Benutzerdefinierte Flags, die Ankündigungsdetails angeben. Weitere Informationen zu diesen Flags finden Sie unter SMS_Advertisement Server-WMI-Klasse .
BootImageID
Datentyp: String
Qualifizierer: [in]
Die ID für ein Startabbildpaket, das mit der Tasksequenz verwendet werden soll. Dieser Parameter ist erforderlich, wenn der TaskSequence
Parameter definiert ist. Andernfalls muss sie auf null
festgelegt werden.
SourceSite
Datentyp: String
Qualifizierer: [in]
Code für die Quellwebsite für die Ankündigung.
PolicyXmls
Datentyp: String Array
Qualifizierer: [out]
XML-Zeichenfolgen, die die Richtlinie für die angegebene Tasksequenz und abhängige Richtlinien darstellen.
PolicyAssignmentXmls
Datentyp: String Array
Qualifizierer: [out]
XML-Zeichenfolgen, die Zuweisungen für die von PolicyXmls
angegebene Richtlinie darstellen.
PolicyXmls
und PolicyAssignmentXmls
werden mit dem n-ten Element eines Parameters ausgerichtet, das dem n-ten Element des anderen entspricht.
Rückgabewerte
Ein SInt32
Datentyp, der 0 ist, um einen Erfolg anzugeben, oder ungleich 0 (null), um einen Fehler anzugeben.
Informationen zur Behandlung von zurückgegebenen Fehlern finden Sie unter Informationen zu Configuration Manager Fehlern.
Hinweise
Die Richtlinien für eine Tasksequenz umfassen die Richtlinie für die Tasksequenz selbst, Richtlinien für alle Pakete, auf die verwiesen wird, und entsprechende Richtlinienzuweisungen. Die Tasksequenz kann entweder in der Datenbank oder im Arbeitsspeicher als eine Gruppe von WMI-Objekten gespeichert werden.
Wenn sich die Tasksequenz in der Configuration Manager-Datenbank befindet, sollte Ihre Anwendung den Paketbezeichner für das Tasksequenzpaket im PackageID
Parameter angeben. Wenn Sie einen Wert für diesen Parameter angeben, müssen Sie über leseberechtigungen für die bestimmte Tasksequenz verfügen.
Wenn sich die Tasksequenz im Arbeitsspeicher befindet, muss Ihre Anwendung Werte für die TaskSequence
Parameter und BootImageID
angeben.
Anforderungen
Laufzeitanforderungen
Weitere Informationen finden Sie unter anforderungen an Configuration Manager Server Runtime.
Entwicklungsanforderungen
Weitere Informationen finden Sie unter Configuration Manager Serverentwicklungsanforderungen.