Metode TaskFolder.RegisterTask

Artikel
06/13/2023

Untuk pembuatan skrip, mendaftarkan (membuat) tugas baru di folder menggunakan XML untuk menentukan tugas.

Sintaks

TaskFolder.RegisterTask( _
  ByVal path, _
  ByVal xmlText, _
  ByVal flags, _
  ByVal userId, _
  ByVal password, _
  ByVal logonType, _
  [ ByVal sddl ], _
  ByRef pTask _
)

Parameter

path [in]

Nama tugas. Jika nilai ini Tidak Ada, tugas akan didaftarkan di folder tugas akar dan nama tugas akan menjadi nilai GUID yang dibuat oleh layanan Penjadwal Tugas.

Nama tugas tidak dapat dimulai atau diakhir dengan karakter spasi. Karakter '.' tidak dapat digunakan untuk menentukan folder tugas saat ini dan '..' karakter tidak dapat digunakan untuk menentukan folder tugas induk di jalur.

xmlText [in]

Deskripsi tugas yang diformat XML.

Topik berikut berisi tugas yang ditentukan menggunakan XML.

flags [in]

Konstanta TASK_CREATION.

Nilai	Makna
TASK_VALIDATE_ONLY 0x1	Penjadwal Tugas memeriksa sintaks XML yang menguraikan tugas tetapi tidak mendaftarkan tugas. Konstanta ini tidak dapat digabungkan dengan nilai TASK_CREATE, TASK_UPDATE, atau TASK_CREATE_OR_UPDATE .
TASK_CREATE 0x2	Penjadwal Tugas mendaftarkan tugas sebagai tugas baru.
TASK_UPDATE 0x4	Penjadwal Tugas mendaftarkan tugas sebagai versi terbaru dari tugas yang sudah ada. Ketika tugas dengan pemicu pendaftaran diperbarui, tugas akan dijalankan setelah pembaruan terjadi.
TASK_CREATE_OR_UPDATE 0x6	Penjadwal Tugas mendaftarkan tugas sebagai tugas baru atau sebagai versi yang diperbarui jika tugas sudah ada. Setara dengan TASK_CREATE \| TASK_UPDATE.
TASK_DISABLE 0x8	Penjadwal Tugas menonaktifkan tugas yang ada.
TASK_DONT_ADD_PRINCIPAL_ACE 0x10	Penjadwal Tugas dicegah untuk menambahkan entri izinkan kontrol akses (ACE) untuk prinsip konteks. Ketika fungsi TaskFolder.RegisterTask dipanggil dengan bendera ini untuk memperbarui tugas, layanan Penjadwal Tugas tidak menambahkan ACE untuk prinsip konteks baru dan tidak menghapus ACE dari prinsip konteks lama.
TASK_IGNORE_REGISTRATION_TRIGGERS 0x20	Penjadwal Tugas membuat tugas, tetapi mengabaikan pemicu pendaftaran dalam tugas. Dengan mengabaikan pemicu pendaftaran, tugas tidak akan dijalankan ketika terdaftar kecuali pemicu berbasis waktu menyebabkannya dijalankan pada pendaftaran.

userId [in]

Kredensial pengguna yang digunakan untuk mendaftarkan tugas.

Catatan

Jika tugas didefinisikan sebagai tugas Task Scheduler 1.0, maka jangan gunakan nama grup (bukan nama pengguna tertentu) dalam parameter userId ini. Tugas didefinisikan sebagai tugas Penjadwal Tugas 1.0 saat atribut versi elemen Tugas dalam XML tugas diatur ke 1.1.

password [in]

Kata sandi untuk userId yang digunakan untuk mendaftarkan tugas. Ketika jenis masuk TASK_LOGON_SERVICE_ACCOUNT digunakan, kata sandi harus merupakan nilai VARIAN kosong seperti VT_NULL atau VT_EMPTY.

logonType [in]

Menentukan teknik masuk apa yang digunakan untuk menjalankan tugas terdaftar.

Nilai	Makna
TASK_LOGON_NONE 0	Metode masuk tidak ditentukan. Digunakan untuk kredensial non-NT.
TASK_LOGON_PASSWORD 1	Gunakan kata sandi untuk pengelogan pada pengguna. Kata sandi harus disediakan pada waktu pendaftaran.
TASK_LOGON_S4U 2	Gunakan token interaktif yang ada untuk menjalankan tugas. Pengguna harus masuk menggunakan layanan untuk masuk pengguna (S4U). Ketika masuk S4U digunakan, tidak ada kata sandi yang disimpan oleh sistem dan tidak ada akses ke jaringan atau ke file terenkripsi.
TASK_LOGON_INTERACTIVE_TOKEN 3	Pengguna harus sudah masuk. Tugas hanya akan dijalankan dalam sesi interaktif yang ada.
TASK_LOGON_GROUP 4	Aktivasi grup. Bidang groupId menentukan grup.
TASK_LOGON_SERVICE_ACCOUNT 5	Menunjukkan bahwa Sistem Lokal, Layanan Lokal, atau akun Layanan Jaringan sedang digunakan sebagai konteks keamanan untuk menjalankan tugas.
TASK_LOGON_INTERACTIVE_TOKEN_OR_PASSWORD 6	Pertama-tama gunakan token interaktif. Jika pengguna tidak masuk (tidak ada token interaktif yang tersedia), maka kata sandi digunakan. Kata sandi harus ditentukan ketika tugas didaftarkan. Bendera ini tidak disarankan untuk tugas baru karena kurang dapat diandalkan daripada TASK_LOGON_PASSWORD.

sddl [in, opsional]

Deskriptor keamanan yang terkait dengan tugas terdaftar. Anda dapat menentukan daftar kontrol akses (ACL) di pendeskripsi keamanan untuk tugas guna mengizinkan atau menolak akses pengguna dan grup tertentu ke tugas.

Catatan

Jika akun Sistem Lokal ditolak akses ke tugas, maka layanan Penjadwal Tugas dapat menghasilkan hasil yang tidak terduga.

pTask [out]

Objek RegisteredTask yang mewakili tugas baru.

Nilai kembali

Metode ini tidak mengembalikan nilai.

Keterangan

Untuk tugas, yang berisi tindakan kotak pesan, kotak pesan akan ditampilkan jika tugas diaktifkan dan tugas memiliki jenis masuk interaktif. Untuk mengatur jenis masuk tugas ke interaktif, tentukan 3 (TASK_LOGON_INTERACTIVE_TOKEN) atau 4 (TASK_LOGON_GROUP) di properti LogonType dari prinsipal tugas, atau dalam parameter logonTypetaskFolder.RegisterTask atau TaskFolder.RegisterTaskDefinition.

Hanya anggota grup Administrator yang dapat membuat tugas dengan pemicu boot.

Anda berhasil mendaftarkan tugas dengan grup yang ditentukan dalam parameter userId dan 3 (TASK_LOGON_INTERACTIVE_TOKEN) yang ditentukan dalam parameter logonTypetaskFolder.RegisterTask atau TaskFolder.RegisterTaskDefinition, tetapi tugas tidak akan berjalan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Pustaka jenis	Taskschd.tlb
DLL	Taskschd.dll

Lihat juga

Tugas Microsoft Azure Scheduler
RegisteredTask
TaskFolder

Bagikan melalui