System.DirectoryServices.AccountManagement Ruang nama
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Menyediakan akses seragam dan manipulasi prinsip keamanan pengguna, komputer, dan grup di beberapa penyimpanan utama: Active Directory Domain Services (AD DS), Active Directory Lightweight Directory Services (AD LDS), dan Machine SAM (MSAM). System.DirectoryServices.AccountManagement mengelola objek direktori yang independen dari System.DirectoryServices namespace layanan.
Kelas
| AdvancedFilters |
Kelas ini menyediakan akses bisa-tulis ke atribut tertentu sehingga pengguna dapat memodifikasi properti baca-saja dari objek utama "dummy" yang diteruskan ke PrincipalSearcher objek saat menggunakan Kueri Menurut Contoh. |
| AuthenticablePrincipal |
Merangkum akun dan menghubungi data yang umum untuk prinsipal yang dapat diautentikasi. |
| ComputerPrincipal |
Merangkum prinsipal yang merupakan akun komputer. |
| DirectoryObjectClassAttribute |
Mewakili objek skema yang digunakan untuk membuat objek jenis ini dalam direktori. Atribut ini diperlukan untuk ekstensi utama dan hanya dapat diatur pada kelas. |
| DirectoryPropertyAttribute |
Berisi data yang diperlukan oleh penyimpanan untuk memetakan properti utama ke atribut direktori. Atribut ini diperlukan untuk ekstensi utama dan hanya dapat diatur pada properti . Ini harus ditentukan pada setiap properti yang mewakili atribut direktori di kelas yang diperluas. |
| DirectoryRdnPrefixAttribute |
Awalan RDN yang digunakan untuk membuat RDN untuk objek baru yang dimasukkan ke dalam penyimpanan. Awalan RDN default "CN" digunakan oleh API Manajemen Akun jika atribut ini tidak diatur. Atribut ini bersifat opsional dan hanya dapat diatur pada kelas ekstensi utama. |
| GroupPrincipal |
Merangkum akun grup. Akun grup dapat menjadi kumpulan arbitrer objek atau akun utama yang dibuat untuk tujuan administratif. |
| MultipleMatchesException |
Pengecualian ini dilemparkan oleh metode yang mengharapkan untuk mencocokkan satu objek utama ketika ada beberapa kecocokan dengan kueri pencarian. |
| NoMatchingPrincipalException |
Pengecualian ini dilemparkan ketika tidak ada objek utama yang cocok yang dapat ditemukan dengan parameter yang ditentukan. |
| PasswordException |
Pengecualian ini dilemparkan ketika kata sandi tidak memenuhi persyaratan kompleksitas. |
| Principal |
Merangkum data akun dan operasi yang umum untuk semua prinsip keamanan. Ini adalah kelas dasar abstrak dari mana semua prinsip keamanan berasal. |
| PrincipalCollection |
Kumpulan objek yang dapat diubah berasal dari Principal kelas . Kelas ini dirancang untuk digunakan untuk properti multinilai yang berisi Principal objek. Memanipulasi isi koleksi ini mengubah isi properti penyimpanan yang sesuai, yang dibuat permanen ketika Save() dipanggil pada objek utama yang sesuai. |
| PrincipalContext |
Merangkum server atau domain tempat semua operasi dilakukan, kontainer yang digunakan sebagai dasar operasi tersebut, dan kredensial yang digunakan untuk melakukan operasi. |
| PrincipalException |
Kelas dasar pengecualian yang dilemparkan oleh System.DirectoryServices.AccountManagement objek. |
| PrincipalExistsException |
Dilemparkan oleh Add metode ketika upaya dilakukan untuk menyisipkan prinsipal yang sudah ada dalam koleksi, atau dengan Save() ketika upaya dilakukan untuk menyimpan prinsipal baru yang sudah ada di penyimpanan. |
| PrincipalOperationException |
Dilemparkan saat ADSI mengembalikan kesalahan selama operasi untuk memperbarui penyimpanan. |
| PrincipalSearcher |
Merangkum metode dan pola pencarian yang digunakan untuk menjalankan kueri terhadap penyimpanan utama yang mendasarinya. |
| PrincipalSearchResult<T> |
Mengembalikan kumpulan Principal objek yang dikembalikan oleh pencarian. |
| PrincipalServerDownException |
Pengecualian ini dilemparkan ketika API tidak dapat terhubung ke server. |
| PrincipalValueCollection<T> |
Properti multinilai, seperti PermittedWorkstations, memiliki nilai jenis PrincipalValueCollection<T>. Kelas ini menyediakan metode untuk menghitung dan memanipulasi nilai-nilai tersebut. |
| UserPrincipal |
Merangkum prinsipal yang merupakan akun pengguna. |
Enum
| ContextOptions |
Menentukan opsi yang digunakan untuk mengikat ke server. Aplikasi dapat mengatur beberapa opsi yang ditautkan dengan operasi OR bitwise. |
| ContextType |
Menentukan jenis penyimpanan tempat utama berada. |
| GroupScope |
Menentukan cakupan prinsipal grup. |
| IdentityType |
Menentukan format identitas. |
| MatchType |
Enumerasi MatchType menentukan jenis perbandingan yang digunakan dalam pencarian. |
Keterangan
Aplikasi layanan direktori terkelola dapat memanfaatkan System.DirectoryServices.AccountManagement API untuk menyederhanakan manajemen prinsipal pengguna, komputer, dan grup. Solusi yang sebelumnya memerlukan pengetahuan rumit tentang penyimpanan atau kode panjang, seperti menemukan semua grup tempat pengguna berada, dicapai dalam beberapa baris kode dengan System.DirectoryServices.AccountManagement API.
Fitur berikut tersedia di System.DirectoryServices.AccountManagement API:
Operasi direktori dasar seperti membuat dan memperbarui prinsip keamanan disederhanakan. Aplikasi ini membutuhkan lebih sedikit pengetahuan tentang penyimpanan yang mendasar untuk melakukan operasi ini.
Aplikasi dapat memperluas model objek untuk menyertakan jenis objek direktori baru.
Tugas manajemen akun, seperti mengaktifkan dan menonaktifkan akun pengguna, disederhanakan.
Dukungan lintas toko memungkinkan objek grup dalam database Active Directory Domain Services (AD DS), Active Directory Lightweight Directory Services (AD LDS), dan Machine SAM (MSAM) berisi anggota dari berbagai jenis toko.
Kueri dengan contoh pencarian, tersedia di PrincipalSearcher kelas, memungkinkan aplikasi untuk mengatur properti pada objek utama dan mencari penyimpanan yang dipilih untuk objek lain yang berisi nilai properti yang cocok.
Pencarian yang disempurnakan pada objek utama komputer, pengguna, dan grup memungkinkan aplikasi mencari penyimpanan yang dipilih untuk mencocokkan objek utama.
Pencarian rekursif, tersedia pada objek utama grup, memungkinkan aplikasi untuk mencari grup secara rekursif dan hanya mengembalikan objek utama yang merupakan simpul daun.
Validasi kredensial terhadap penyimpanan SAM Mesin, AD DS, dan AD LS disederhanakan.
Kecepatan koneksi ditingkatkan dengan menggunakan fitur Fast Concurrent Bind (FSB) saat tersedia. Penembolokan koneksi mengurangi jumlah port yang digunakan.
Lihat juga
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk