SAMBA-TOOL(8) System Administration tools SAMBA-TOOL(8)

samba-tool - ابزار اصلی مدیریت و پیکربندی سامبا (Samba)

samba-tool [-h] [-W myworkgroup] [-U user] [-d debuglevel] [-V]

این ابزار بخشی از مجموعهٔ نرم‌افزاری samba(7) است.

ابزار samba-tool از دستورات فرعی متعددی تشکیل شده است که هر یک مجموعه‌ای از گزینه‌های اختصاصی خود را دارند. گزینه‌های فهرست‌شده در این بخش میان چندین دستور فرعی مشترک هستند.

-h|--help

نمایش پیام راهنما و خروج.

-r|--realm=REALM

قلمرو (realm) را برای دامنه تعیین می‌کند.

توجه داشته باشید که تعیین این پارامتر در اینجا بر پارامتر realm در فایل /etc/samba/smb.conf اولویت خواهد داشت.

--simple-bind-dn=DN

شناسهٔ DN مورد استفاده برای اتصال ساده (simple bind).

--password

گذرواژه را در خط فرمان مشخص می‌کند.

در مورد قرار دادن گذرواژه‌ها در اسکریپت‌ها یا ارسال مقادیر عرضه‌شده توسط کاربر در خط فرمان محتاط باشید. برای حفظ امنیت بهتر است اجازه دهید ابزار کلاینت سامبا در صورت نیاز گذرواژه را درخواست کند، یا اینکه گذرواژه را یک‌بار با kinit. دریافت کنید.

اگر --password مشخص نشده باشد، این ابزار ابتدا متغیر محیطی PASSWD و سپس متغیر PASSWD_FD را بررسی می‌کند که انتظار می‌رود حاوی شمارهٔ توصیف‌کنندهٔ فایل (FD) باز باشد.

در نهایت متغیر PASSWD_FILE (حاوی مسیر فایلی که باید باز شود) را بررسی خواهد کرد. فایل باید فقط حاوی گذرواژه باشد. اطمینان حاصل کنید که مجوزهای دسترسی فایل، آن را از دسترس کاربران غیرمجاز محافظت می‌کند!

اگرچه سامبا تلاش می‌کند تا گذرواژه را از عنوان فرایند (همان‌طور که در ps دیده می‌شود) پاک کند، اما این کار پس از راه‌اندازی انجام شده و بنابراین در معرض شرایط رقابتی (race condition) قرار دارد.

-U|--user=[DOMAIN\]USERNAME[%PASSWORD]

نام کاربری SMB یا نام کاربری و گذرواژه را تنظیم می‌کند.

اگر %PASSWORD مشخص نشده باشد، از کاربر درخواست گذرواژه خواهد شد. کلاینت ابتدا متغیر محیطی USER (که مجاز است حاوی گذرواژه جداشده با % نیز باشد)، سپس متغیر LOGNAME (که مجاز به داشتن گذرواژه نیست) را بررسی می‌کند و در صورت وجود هر یک، مقدار آن استفاده می‌شود. اگر این متغیرهای محیطی یافت نشوند، ممکن است از نام کاربری موجود در حافظهٔ نهان اعتبارسنجی کربروس (Kerberos Credentials cache) استفاده شود.

گزینهٔ سوم استفاده از یک فایل اعتبارسنجی است که حاوی متن سادهٔ نام کاربری و گذرواژه است. این گزینه عمدتاً برای اسکریپت‌هایی فراهم شده است که در آن‌ها مدیر سیستم مایل نیست اطلاعات احراز هویت را در خط فرمان یا از طریق متغیرهای محیطی ارسال کند. در صورت استفاده از این روش، اطمینان حاصل کنید که مجوزهای فایل، دسترسی کاربران غیرمجاز را محدود می‌سازد. برای جزئیات بیشتر به گزینهٔ -A مراجعه کنید.

در مورد قرار دادن گذرواژه‌ها در اسکریپت‌ها یا ارسال مقادیر عرضه‌شده توسط کاربر در خط فرمان محتاط باشید. برای حفظ امنیت بهتر است اجازه دهید ابزار کلاینت سامبا در صورت نیاز گذرواژه را بپرسد، یا گذرواژه را یک‌بار با kinit. دریافت نمایید.

اگرچه سامبا تلاش می‌کند تا گذرواژه را از عنوان فرایند (آن‌طور که در ps دیده می‌شود) پاک کند، اما این کار پس از شروع به کار رخ می‌دهد و بنابراین در معرض شرایط رقابتی است.

-W|--workgroup=WORKGROUP

دامنهٔ SMB نام کاربری را تنظیم می‌کند. این گزینه دامنهٔ پیش‌فرضی را که در smb.conf تعریف شده است لغو می‌کند. اگر دامنه‌ی مشخص‌شده با نام NetBIOS سرور یکسان باشد، باعث می‌شود کلاینت با استفاده از SAM محلی سرورها (برخلاف SAM دامنه) وارد سیستم شود.

توجه داشته باشید که تعیین این پارامتر در اینجا بر پارامتر workgroup در فایل /etc/samba/smb.conf اولویت خواهد داشت.

-N|--no-pass

در صورت تعیین، این پارامتر از اعلان معمول گذرواژه از کلاینت به کاربر جلوگیری می‌کند. این گزینه هنگام دسترسی به سرویسی که نیاز به گذرواژه ندارد کاربرد دارد.

مگر اینکه گذرواژه‌ای در خط فرمان مشخص شده باشد یا این پارامتر تعیین گردد، کلاینت درخواست گذرواژه خواهد کرد.

اگر یک گذرواژه در خط فرمان مشخص شده باشد و این گزینه نیز تعریف شود، گذرواژهٔ خط فرمان نادیده گرفته شده و هیچ گذرواژه‌ای استفاده نخواهد شد.

--use-kerberos=desired|required|off

این پارامتر مشخص می‌کند که آیا ابزارهای کلاینت سامبا تلاش خواهند کرد با استفاده از Kerberos احراز هویت کنند یا خیر. برای احراز هویت کربروس باید هنگام اتصال به سرویس به‌جای آدرس‌های IP از نام‌های DNS استفاده کنید. به‌طور پیش‌فرض، ابزارهای کلاینت سامبا سعی می‌کنند از حافظهٔ نهان پیش‌فرض اعتبارنامه کربروس (ccache) استفاده کنند. در صورتی که ccache وجود نداشته باشد یا گزینهٔ -U|--user مشخص شده باشد، کلاینت‌ها درخواست ورود گذرواژه کرده و یک بلیت کربروس (kinit) برای شما دریافت خواهند کرد. اگر می‌خواهید از یک حافظهٔ نهان اعتبارنامهٔ جایگزین برای کربروس استفاده کنید، از گزینهٔ --use-krb5-ccache استفاده نمایید.

توجه داشته باشید که تعیین این پارامتر در اینجا بر پارامتر client use kerberos در فایل /etc/samba/smb.conf اولویت خواهد داشت.

--use-krb5-ccache=CCACHE

محل حافظهٔ نهان اعتبارنامه را برای احراز هویت کربروس مشخص می‌کند.

این گزینه باعث اعمال الزامی --use-kerberos=required می‌شود.

-A|--authentication-file=filename

این گزینه به شما امکان می‌دهد فایلی را مشخص کنید که نام کاربری و گذرواژهٔ مورد استفاده در اتصال از آن خوانده شود. قالب فایل به صورت زیر است:
username = <value>
password = <value>
domain   = <value>

اطمینان حاصل کنید که مجوزهای دسترسی فایل، دسترسی کاربران غیرمجاز را مسدود می‌کند!

-H URL, --URL=URL

نشانی LDB URL برای پایگاه‌داده یا سرور مقصد.

نشانی می‌تواند یک مسیر فایل ساده باشد یا از یکی از طرح‌های فهرست‌شده در اینجا استفاده کند. اگر از یک مسیر ساده استفاده شود، به گونه‌ای رفتار می‌شود که گویی از 'tdb://' استفاده شده است.

tdb://PATH

شناسهٔ PATH مکان یک پایگاه‌داده TDB است.

mdb://PATH

شناسهٔ PATH مکان یک پایگاه‌داده LMDB است.

ldb://PATH

شناسهٔ PATH مکان یک پایگاه‌داده LDB در قالب‌های LMDB یا TDB است. قالب‌ها یکی پس از دیگری امتحان می‌شوند تا یکی موفق شود یا همه با شکست مواجه شوند. اگر از قالب فایل اطلاعی ندارید، استفاده از این گزینه ایمن است.

ldap://HOSTNAME, ldaps://HOSTNAME

بک‌اند LDB سرور ldap مشخص‌شده است. طرح ldaps:// اتصال را در پوشش TLS رمزگذاری می‌کند.

ldapi://SOCKET

سرور بک‌اند یک سرور ldap محلی با استفاده از سوکت دامنهٔ یونیکس است.

--color=always|never|auto

استفاده از رنگ در صورت در دسترس بودن (پیش‌فرض: auto)

--ipaddress=IPADDRESS

آدرس IP سرور

-s FILE, --configfile=FILE

استفاده از این فایل پیکربندی smb.conf.

--color=always|never|auto

مشخص می‌کند که آیا samba-tool باید از کدهای رنگی ANSI در خروجی خود استفاده کند یا خیر. در صورت تنظیم روی 'auto' (پیش‌فرض)، samba-tool در صورتی که خروجی آن به سمت یک ترمینال هدایت شود از رنگ استفاده می‌کند، مگر اینکه متغیر محیطی NO_COLOR مقداردهی شده و خالی نباشد.

مقادیر 'yes' و 'force' به عنوان مترادف 'always'؛ مقادیر 'no' و 'none' برای 'never'؛ و مقادیر 'tty' و 'if-tty' برای 'auto' پذیرفته می‌شوند.

توجه داشته باشید که درخواست رنگ لزوماً به این معنی نیست که خروجی samba-tool بسیار رنگارنگ خواهد بود. بسیاری از دستورات به‌ویژه در صورت موفقیت‌آمیز بودن، کاملاً تک‌رنگ هستند.

-V, --version

نمایش شمارهٔ نسخه و خروج.

-d|--debuglevel=level

مقدار level یک عدد صحیح از 0 تا 10 است. مقدار پیش‌فرض در صورت مشخص نشدن این پارامتر برای برنامه‌های کلاینت برابر 1 است.

هرچه این مقدار بالاتر باشد، جزئیات بیشتری دربارهٔ فعالیت‌های سرور در فایل‌های گزارش (log) ثبت خواهد شد. در سطح 0، فقط خطاهای حیاتی و هشدارهای جدی ثبت می‌شوند. سطح 1 سطحی معقول برای استفادهٔ روزمره است - اطلاعات کمی دربارهٔ عملیات انجام‌شده تولید می‌کند.

سطوح بالاتر از 1 مقادیر قابل توجهی داده‌های گزارش تولید می‌کنند و فقط باید هنگام عیب‌یابی یک مشکل استفاده شوند. سطوح بالاتر از 3 فقط برای استفاده توسط توسعه‌دهندگان طراحی شده‌اند و مقادیر عظیمی از داده‌های لاگ را تولید می‌کنند که بیشتر آن‌ها بسیار مبهم هستند.

توجه داشته باشید که تعیین این پارامتر در اینجا بر پارامتر log level در فایل /etc/samba/smb.conf اولویت خواهد داشت.

--debug-stdout

این گزینه خروجی اشکال‌زدایی را به STDOUT هدایت می‌کند. به‌طور پیش‌فرض تمام کلاینت‌ها وقایع را در STDERR ثبت می‌کنند.

مدیریت حساب‌های کاربری رایانه.

افزودن یک رایانه جدید به دامنه اکتیو دایرکتوری.

نام رایانه جدید مشخص‌شده در دستور همان sAMAccountName با یا بدون علامت دلار پایانی است.

--computerou=COMPUTEROU

شناسهٔ DN مکان جایگزین (با یا بدون بخش domainDN) به‌جای مکان پیش‌فرض CN=Computers که شیء رایانه جدید در آن ایجاد خواهد شد؛ مانند 'OU=OUname'.

--description=DESCRIPTION

توضیحات رایانه جدید.

--ip-address=IP_ADDRESS_LIST

آدرس IPv4 برای رکورد A رایانه یا آدرس IPv6 برای رکورد AAAA؛ می‌تواند چندین بار ارائه شود.

--service-principal-name=SERVICE_PRINCIPAL_NAME_LIST

نام اصلی سرویس (SPN) رایانه؛ می‌تواند چندین بار ارائه شود.

--prepare-oldjoin

آماده‌سازی حساب ماشین فعال برای سازوکار اتصال قدیمی (oldjoin).

افزودن یک رایانه جدید. این یک مترادف برای دستور samba-tool computer add است و صرفاً به دلایل سازگاری ارائه شده است. لطفاً به‌جای آن از samba-tool computer add استفاده کنید.

حذف یک حساب کاربری موجود رایانه.

نام رایانه مشخص‌شده در دستور همان sAMAccountName با یا بدون علامت دلار پایانی است.

ویرایش یک شیء AD رایانه.

نام رایانه مشخص‌شده در دستور همان sAMAccountName با یا بدون علامت دلار پایانی است.

--editor=EDITOR

ویرایشگر مورد استفاده را به‌جای پیش‌فرض سیستم یا 'vi' در صورت تنظیم نبودن پیش‌فرض سیستم مشخص می‌کند.

فهرست کردن تمام رایانه‌ها.

این دستور یک حساب رایانه را به واحد سازمانی (OU) یا ظرف مشخص‌شده منتقل می‌کند.

نام رایانه مشخص‌شده در دستور همان sAMAccountName با یا بدون علامت دلار پایانی است.

نام واحد سازمانی یا ظرف می‌تواند به‌صورت DN کامل یا بدون جزء domainDN مشخص شود.

نمایش یک شیء AD رایانه.

نام رایانه مشخص‌شده در دستور همان sAMAccountName با یا بدون علامت دلار پایانی است.

--attributes=USER_ATTRS

فهرستی از ویژگی‌ها با کاما جدا شده که چاپ خواهند شد.

مدیریت پیوندهای اطلاعات کاربری کلید (Key Credential Links) برای یک رایانه.

این ابزار می‌تواند ویژگی‌های msDS-KeyCredentialLink را مقداردهی، توصیف یا حذف کند.

افزودن یک key-credential-link که یک ویژگی پیوندی حاوی کلید عمومی در یک فیلد باینری است.

آرگومان دوم نام فایلی است که باید به یک کلید RSA با اندازهٔ ۲۰۴۸ بیت (یا گواهی حاوی آن کلید) در قالب PEM یا DER اشاره کند. به‌طور پیش‌فرض قالب کدگذاری به‌صورت خودکار تشخیص داده می‌شود، اما می‌توانید با گزینهٔ --encoding آن را مشخص کنید. انواع دیگر کلید عمومی پشتیبانی نمی‌شوند، اگرچه گزینهٔ --force می‌تواند برای افزودن کلیدهای با اندازهٔ غیر از ۲۰۴۸ بیت استفاده شود.

--link-target=DN

پیوند به این DN (پیش‌فرض: DN رایانه)

--encoding=ENCODING

قالب کلید، یکی از مقادیر pem، der، یا auto. مقدار پیش‌فرض auto است که در بیشتر شرایط قالب صحیح را به‌درستی تشخیص می‌دهد.

--force

ادامهٔ عملیات حتی اگر ناموفق به نظر برسد

حذف یک key-credential-link.

پیوند مورد نظر برای حذف می‌تواند به چندین روش انتخاب شود. گزینهٔ --all تمام پیوندهای اطلاعات کاربری کلید را برای رایانه حذف می‌کند (اغلب تنها یک مورد وجود دارد). گزینهٔ --link-target یک پیوند اطلاعات کاربری کلید را بر اساس DN هدف پیوند انتخاب می‌کند. گزینهٔ --fingerprint پیوندی را برای حذف بر اساس اثر انگشت کلید انتخاب می‌کند. این اثر انگشت مقدار SHA256 داده‌های کلید کدگذاری‌شده با DER است که به‌صورت جفت‌های هگزادسیمال جداشده با دونقطه نمایش داده می‌شود. برای دریافت فهرستی از پیوندها و اثر انگشت آن‌ها، بخش computer keytrust view را ببینید.

اگر بیش از یکی از گزینه‌های --link-target، --fingerprint و --all استفاده شوند، پیوندهایی که با هر یک از آن‌ها مطابقت داشته باشند حذف خواهند شد.

گزینهٔ --dry-run از حذف پیوندها جلوگیری کرده و در عوض نشان می‌دهد که در صورت حذف آن چه اتفاقی می‌افتاد.

--link-target=DN

حذف این پیوند اطلاعات کاربری کلید (یک DN)

--fingerprint=HH:HH:..

حذف پیوند اطلاعات کاربری کلید با این اثر انگشت کلید

--all

حذف تمام پیوندهای اطلاعات کاربری کلید

-n, --dry-run

هیچ کاری انجام ندهد و فقط آنچه رخ خواهد داد را چاپ کند

مشاهدهٔ پیوندهای اطلاعات کاربری کلید یک رایانه. این گزینه می‌تواند برای یافتن اثر انگشت و DN هدف یک پیوند استفاده شود. گزینهٔ --verbose شامل اطلاعات بیشتر و جزئیات دقیق‌تر است.

-h, --help

نمایش این پیام راهنما و خروج

-v, --verbose

نمایش با جزئیات کامل

subject_name private_key_filename output_filename [options]"

تولید یک درخواست امضای گواهی (CSR) با کدگذاری PEM برای یک رایانه.

--private-key-encoding

مشخص می‌کند که کلید خصوصی از چه کدگذاری استفاده می‌کند. مقدار پیش‌فرض 'auto' است.

--private-key-pass

ارائهٔ گذرواژه برای رمزگشایی کلید خصوصی.

مدیریت مخاطبین (contacts).

افزودن یک مخاطب جدید به دامنهٔ اکتیو دایرکتوری.

نام مخاطب جدید می‌تواند با آرگومان اول 'contactname' یا آرگومان‌های --given-name، --initial و --surname مشخص شود. اگر هیچ 'contactname' داده نشود، نام مخاطب از آرگومان‌های ارائه‌شده با ترکیب نام کوچک، حروف اول و نام خانوادگی ساخته می‌شود. هر آرگومان اختیاری است. یک نقطه ('.') به‌طور خودکار به انتهای حروف اول اضافه می‌شود.

--ou=OU

شناسهٔ DN مکان جایگزین (با یا بدون بخش domainDN) که مخاطب جدید در آن ایجاد خواهد شد؛ مانند 'OU=OUname'. مقدار پیش‌فرض پایهٔ دامنه است.

--description=DESCRIPTION

توضیحات مخاطب جدید.

--surname=SURNAME

نام خانوادگی مخاطب.

--given-name=GIVEN_NAME

نام کوچک مخاطب.

--initials=INITIALS

حروف اول نام مخاطب.

--display-name=DISPLAY_NAME

نام نمایشی مخاطب.

--job-title=JOB_TITLE

عنوان شغلی مخاطب.

--department=DEPARTMENT

دپارتمان یا بخش مخاطب.

--company=COMPANY

شرکت مخاطب.

--mail-address=MAIL_ADDRESS

آدرس ایمیل مخاطب.

--internet-address=INTERNET_ADDRESS

صفحهٔ اینترنتی مخاطب.

--telephone-number=TELEPHONE_NUMBER

شماره تلفن مخاطب.

--mobile-number=MOBILE_NUMBER

شماره تلفن همراه مخاطب.

--physical-delivery-office=PHYSICAL_DELIVERY_OFFICE

محل دفتر فیزیکی مخاطب.

افزودن یک مخاطب جدید. این یک مترادف برای دستور samba-tool contact add است و صرفاً برای سازگاری در دسترس است. لطفاً به‌جای آن از samba-tool contact add استفاده کنید.

حذف یک مخاطب موجود.

نام مخاطب مشخص‌شده در دستور، نام مشترک یا نام مشخص (DN) شیء مخاطب است. نام مشخص مخاطب می‌تواند با یا بدون جزء domainDN مشخص شود.

ویرایش یک شیء AD مخاطب.

نام مخاطب مشخص‌شده در دستور، نام مشترک یا نام مشخص شیء مخاطب است. نام مشخص مخاطب می‌تواند با یا بدون جزء domainDN مشخص شود.

--editor=EDITOR

ویرایشگر مورد استفاده را به‌جای پیش‌فرض سیستم یا 'vi' در صورت تنظیم نبودن پیش‌فرض سیستم مشخص می‌کند.

فهرست کردن تمام مخاطبین.

--full-dn

نمایش DN کامل مخاطب به‌جای نام آن.

این دستور یک مخاطب را به واحد سازمانی یا ظرف مشخص‌شده منتقل می‌کند.

نام مخاطب مشخص‌شده در دستور، نام مشترک یا نام مشخص شیء مخاطب است. نام مشخص مخاطب می‌تواند با یا بدون جزء domainDN مشخص شود.

نمایش یک شیء AD مخاطب.

نام مخاطب مشخص‌شده در دستور، نام مشترک یا نام مشخص شیء مخاطب است. نام مشخص مخاطب می‌تواند با یا بدون جزء domainDN مشخص شود.

--attributes=CONTACT_ATTRS

فهرستی از ویژگی‌ها با کاما جدا شده که چاپ خواهند شد.

تغییر نام مخاطب و ویژگی‌های مرتبط.

این دستور امکان تنظیم ویژگی‌های مربوط به نام مخاطب را فراهم می‌کند. شناسهٔ CN مخاطب به‌طور خودکار تغییر نام خواهد یافت. شناسهٔ جدید CN مخاطب با ترکیب نام کوچک، حروف اول و نام خانوادگی ساخته می‌شود. در صورت نیاز، یک نقطه ('.') به‌طور خودکار به حروف اول اضافه خواهد شد. از گزینهٔ --force-new-cn برای تعیین دستی CN جدید و از --reset-cn برای بازنشانی این تغییر استفاده کنید.

از یک مقدار ویژگی خالی برای حذف ویژگی مشخص‌شده استفاده کنید.

نام مخاطب مشخص‌شده در دستور، همان CN است.

--surname=SURNAME

نام خانوادگی جدید.

--given-name=GIVEN_NAME

نام کوچک جدید.

--initials=INITIALS

حروف اول نام جدید.

--force-new-cn=NEW_CN

تعیین یک CN (RDN) جدید به‌جای استفاده از ترکیب نام کوچک، حروف اول و نام خانوادگی.

--reset-cn

تنظیم CN روی ترکیب پیش‌فرض نام کوچک، حروف اول و نام خانوادگی.

--display-name=DISPLAY_NAME

نام نمایشی جدید.

--mail-address=MAIL_ADDRESS

آدرس ایمیل جدید.

بررسی پایگاه دادهٔ AD محلی برای یافتن خطاها.

مدیریت تفویض اختیارات (Delegations).

افزودن یک شناسهٔ اصلی (principal) به msDS-AllowedToActOnBehalfOfOtherIdentity که می‌تواند به یک حساب کاربری تفویض اختیار کند.

حذف یک شناسهٔ اصلی از msDS-AllowedToActOnBehalfOfOtherIdentity به‌طوری که دیگر نتواند به یک حساب تفویض اختیار نماید.

افزودن یک شناسهٔ اصلی سرویس به‌عنوان msDS-AllowedToDelegateTo.

حذف یک شناسهٔ اصلی سرویس از msDS-AllowedToDelegateTo.

تنظیم یا لغو UF_TRUSTED_TO_AUTHENTICATE_FOR_DELEGATION (پروتکل S4U2Proxy) برای یک حساب کاربری.

تنظیم یا لغو UF_TRUSTED_FOR_DELEGATION برای یک حساب کاربری.

نمایش تنظیمات تفویض اختیار یک حساب کاربری.

مدیریت سرویس نام دامنه (DNS).

افزودن یک رکورد DNS.

--allow-existing

وجود یک رکورد از قبل با این نام و نوع را به عنوان خطا در نظر نگیرد. این گزینه تغییر عملکردی ایجاد نمی‌کند (رکورد DNS جدید اضافه نمی‌شود) اما پیام و کد بازگشتی samba-tool خطایی را نشان نخواهند داد.

پاک‌سازی رکوردهای DNS برای یک میزبان، به‌گونه‌ای که پرس‌وجوهای DNS دیگر پاسخی بازنگردانند. معمولاً این کار با علامت‌گذاری رکوردها به عنوان حذف‌شده در پایگاه داده انجام می‌شود.

مثال: samba-tool dns cleanup dc1 computer.samdom.test.site

حذف یک رکورد DNS.

پرس‌وجوی یک نام.

پرس‌وجوی نکات ریشه (root hints).

پرس‌وجوی اطلاعات سرور.

به‌روزرسانی یک رکورد DNS.

ایجاد یک زون (منطقهٔ DNS).

حذف یک زون.

پرس‌وجوی اطلاعات زون.

فهرست کردن زون‌ها.

دستکاری گزینه‌های فرسودگی (aging). این گزینه در زون‌هایی که از DNS پویا استفاده می‌کنند کاربردی است.

گزینه‌هایی برای تغییر رکوردها از ایستا به پویا بر اساس عبارات باقاعده یا سن رکورد وجود دارد که در مواردی که مقادیر در نسخه‌های قدیمی سامبا با هم تداخل پیدا کرده بودند مفید است.

-n, --dry-run

در عمل چیزی تغییر نکند، اما آنچه رخ خواهد داد نشان داده شود.

--client-version=w2k|dotnet|longhorn

نسخهٔ پروتکل کلاینت ویندوز. پیش‌فرض longhorn است که احتمالاً همان چیزی است که نیاز دارید.

--mark-old-records-static=YYYY-MM-DD

علامت‌گذاری رکوردهای قدیمی‌تر از تاریخ مشخص‌شده به عنوان ایستا (static).

--mark-records-static-regex=REGEXP

علامت‌گذاری رکوردهایی که با عبارت باقاعدهٔ سازگار با پرل تطابق دارند به عنوان ایستا.

--mark-records-dynamic-regex=REGEXP

علامت‌گذاری رکوردهایی که با عبارت باقاعدهٔ سازگار با پرل تطابق دارند به عنوان پویا (dynamic).

--aging=0|1

--aging=1 برای فعال‌سازی فرسودگی (aging) در این زون.

--aging=0 برای غیرفعال‌سازی فرسودگی در این زون.

--norefreshinterval=HOURS

جلوگیری از به‌روزرسانی‌های مجدد برای این مدت زمان پس از یک به‌روزرسانی پویا. برای استفاده از پیش‌فرض آن را روی صفر تنظیم کنید.

--refreshinterval=HOURS

فاصلهٔ زمانی به‌روزرسانی پویا به ساعت (0: استفاده از پیش‌فرض)

مدیریت دامنه.

ایجاد یا بازیابی نسخهٔ پشتیبان از دامنه.

پشتیبان‌گیری (با قفل‌گذاری مناسب) از دایرکتوری‌های محلی دامنه در یک فایل tar.

کپی کردن پایگاه‌داده جاری یک کنترل‌کنندهٔ دامنه (DC) در حال اجرا در یک فایل پشتیبان tar.

کپی کردن پایگاه‌داده کنترل‌کنندهٔ دامنهٔ در حال اجرا در فایل پشتیبان و تغییر نام دامنه در طول این فرایند.

بازیابی پایگاه‌داده دامنه از یک فایل پشتیبان.

مدیریت خط‌مشی‌های احراز هویت.

فهرست کردن خط‌مشی‌های احراز هویت در دامنه.

-H, --URL

نشانی LDB URL برای پایگاه‌داده یا سرور مقصد.

--json

مشاهدهٔ خط‌مشی‌های احراز هویت به‌صورت JSON به‌جای فهرست.

مشاهدهٔ یک خط‌مشی احراز هویت در دامنه.

-H, --URL

نشانی LDB URL برای پایگاه‌داده یا سرور مقصد.

--name

نام خط‌مشی احراز هویت برای مشاهده (الزامی).

ایجاد خط‌مشی‌های احراز هویت در دامنه.

-H, --URL

نشانی LDB URL برای پایگاه‌داده یا سرور مقصد.

--name

نام خط‌مشی احراز هویت (الزامی).

--description

توضیحات اختیاری برای خط‌مشی احراز هویت.

--protect

محافظت از خط‌مشی احراز هویت در برابر حذف تصادفی.

نمی‌تواند همراه با --unprotect استفاده شود.

--unprotect

لغو محافظت خط‌مشی احراز هویت در برابر حذف تصادفی.

نمی‌تواند همراه با --protect استفاده شود.

--audit

فقط حسابرسی (audit) خط‌مشی احراز هویت.

نمی‌تواند همراه با --enforce استفاده شود.

--enforce

اعمال اجباری خط‌مشی احراز هویت.

نمی‌تواند همراه با --audit استفاده شود.

--strong-ntlm-policy

خط‌مشی سخت‌گیرانهٔ NTLM (شامل Disabled، Optional، Required).

--user-tgt-lifetime-mins

طول عمر بلیت بلیت‌ساز (TGT) برای حساب‌های کاربری (بر حسب دقیقه).

--user-allow-ntlm-auth

اجازه دادن به احراز هویت NTLM و Interactive NETLOGON SamLogon با وجود اینکه allowed-to-authenticate-from در حال استفاده است و در حالت عادی کاربر را به دستگاه‌های انتخابی محدود می‌کرد.

--user-allowed-to-authenticate-from

شرایطی که یک دستگاه باید برآورده کند تا کاربران تحت پوشش این خط‌مشی مجاز به احراز هویت باشند. اگرچه این یک محدودیت روی دستگاه است، هر قاعدهٔ شرطی ACE به‌گونه‌ای بیان می‌شود که گویی دستگاه یک کاربر است.

باید یک رشتهٔ معتبر SDDL بدون اشاره به کلیدواژه‌های Device باشد.

مثال: O:SYG:SYD:(XA;OICI;CR;;;WD;(Member_of {SID(AU)}))

--user-allowed-to-authenticate-to=SDDL

این خط‌مشی، که برای یک حساب کاربری ارائه‌دهندهٔ سرویس (مانند یک وب‌سرور با حساب کاربری) اعمال می‌شود، دسترسی حساب‌ها به آن را محدود می‌کند.

باید یک رشتهٔ معتبر SDDL باشد. رشتهٔ SDDL می‌تواند به هر دو شرط کاربر ساده و Device اشاره کند.

مثال SDDL: O:SYG:SYD:(XA;OICI;CR;;;WD;(Member_of {SID(AO)}))

--service-tgt-lifetime-mins

طول عمر بلیت بلیت‌ساز (TGT) برای حساب‌های سرویس (بر حسب دقیقه).

--service-allow-ntlm-auth

اجازه دادن به احراز هویت شبکه‌ای NTLM هنگامی که سرویس به دستگاه‌های انتخابی محدود شده است.

--service-allowed-to-authenticate-from

شرایطی که یک دستگاه باید برآورده کند تا حساب‌های سرویس تحت پوشش این خط‌مشی مجاز به احراز هویت باشند. اگرچه این یک محدودیت روی دستگاه است، هر قاعدهٔ شرطی ACE به‌گونه‌ای بیان می‌شود که گویی دستگاه یک کاربر است.

باید یک رشتهٔ معتبر SDDL بدون اشاره به کلیدواژه‌های Device باشد.

مثال SDDL: O:SYG:SYD:(XA;OICI;CR;;;WD;(Member_of {SID(AU)}))

--service-allowed-to-authenticate-to=SDDL

این خط‌مشی، که برای یک حساب سرویس (مانند یک Managed Service Account یا Group Managed Service Account) اعمال می‌شود، دسترسی حساب‌ها به آن را محدود می‌کند.

باید یک رشتهٔ معتبر SDDL باشد. رشتهٔ SDDL می‌تواند به هر دو شرط کاربر ساده و Device اشاره کند.

مثال SDDL: O:SYG:SYD:(XA;OICI;CR;;;WD;(Member_of {SID(AO)}))

--computer-tgt-lifetime-mins

طول عمر بلیت بلیت‌ساز (TGT) برای حساب‌های رایانه (بر حسب دقیقه).

--computer-allowed-to-authenticate-to=SDDL

این خط‌مشی، که برای یک حساب رایانه (مانند یک سرور یا ایستگاه کاری) اعمال می‌شود، دسترسی حساب‌ها به آن را محدود می‌کند.

باید یک رشتهٔ معتبر SDDL باشد. رشتهٔ SDDL می‌تواند به هر دو شرط کاربر ساده و Device اشاره کند.

مثال SDDL: O:SYG:SYD:(XA;OICI;CR;;;WD;(Member_of {SID(AO)}))

تغییر خط‌مشی‌های احراز هویت در دامنه. همان گزینه‌های مربوط به domain auth policy create در اینجا نیز اعمال می‌شوند.

حذف خط‌مشی‌های احراز هویت در دامنه.

-H, --URL

نشانی LDB URL برای پایگاه‌داده یا سرور مقصد.

--name

نام خط‌مشی احراز هویت برای حذف (الزامی).

--force

اجبار به حذف خط‌مشی احراز هویت حتی اگر محافظت‌شده باشد.

تنظیم ویژگی user-allowed-to-authenticate-from بر اساس سناریو.

-H, --URL

نشانی LDB URL برای پایگاه‌داده یا سرور مقصد.

--name

نام خط‌مشی احراز هویت.

--by-group=GROUP

کاربر مجاز به احراز هویت است، در صورتی که دستگاهی که از آن احراز هویت می‌کند، عضو گروه مشخص‌شدهٔ GROUP باشد.

--silo=SILO

کاربر مجاز به احراز هویت است، در صورتی که دستگاهی که از آن احراز هویت می‌کند، عضو سیلوی مشخص‌شدهٔ SILO باشد.

تنظیم ویژگی user-allowed-to-authenticate-to بر اساس سناریو.

-H, --URL

نشانی LDB URL برای پایگاه‌داده یا سرور مقصد.

--name

نام خط‌مشی احراز هویت.

--group=GROUP

حساب کاربری، ارائه‌دهندهٔ یک سرویس شبکه‌ای، تحت پوشش این خط‌مشی، تنها توسط حساب‌های دیگری قابل دسترسی خواهد بود که عضو گروه مشخص‌شدهٔ GROUP باشند.

--silo=SILO

حساب کاربری، ارائه‌دهندهٔ یک سرویس شبکه‌ای، تحت پوشش این خط‌مشی، تنها توسط حساب‌های دیگری قابل دسترسی خواهد بود که به سیلوی مشخص‌شدهٔ SILO اختصاص داده شده و عضو آن باشند (و شرایط احراز هویت آن را برآورده کنند).

تنظیم ویژگی service-allowed-to-authenticate-from بر اساس سناریو.

-H, --URL

نشانی LDB URL برای پایگاه‌داده یا سرور مقصد.

--name

نام خط‌مشی احراز هویت.

--group=GROUP

حساب سرویس (مانند یک Managed Service Account یا Group Managed Service Account) مجاز به احراز هویت است، اگر دستگاهی که از آن احراز هویت می‌کند عضو گروه مشخص‌شدهٔ GROUP باشد.

--silo=SILO

حساب سرویس (مانند یک Managed Service Account یا Group Managed Service Account) مجاز به احراز هویت است، اگر دستگاهی که از آن احراز هویت می‌کند عضو سیلوی مشخص‌شدهٔ SILO باشد.

تنظیم ویژگی service-allowed-to-authenticate-to بر اساس سناریو.

-H, --URL

نشانی LDB URL برای پایگاه‌داده یا سرور مقصد.

--name

نام خط‌مشی احراز هویت.

--group=GROUP

حساب سرویس (مانند یک Managed Service Account یا Group Managed Service Account)، فقط توسط حساب‌های دیگری قابل دسترسی خواهد بود که عضو گروه مشخص‌شدهٔ GROUP باشند.

--silo=SILO

حساب سرویس (مانند یک Managed Service Account یا Group Managed Service Account)، فقط توسط حساب‌های دیگری قابل دسترسی خواهد بود که به سیلوی مشخص‌شدهٔ SILO اختصاص داده شده و عضو آن باشند (و شرایط احراز هویت آن را برآورده کنند).

تنظیم ویژگی computer-allowed-to-authenticate-to بر اساس سناریو.

-H, --URL

نشانی LDB URL برای پایگاه‌داده یا سرور مقصد.

--name

نام خط‌مشی احراز هویت.

--group=GROUP

حساب رایانه (مانند یک سرور یا ایستگاه کاری)، فقط توسط حساب‌های دیگری قابل دسترسی خواهد بود که عضو گروه مشخص‌شدهٔ GROUP باشند.

--silo=SILO

حساب رایانه (مانند یک سرور یا ایستگاه کاری)، فقط توسط حساب‌های دیگری قابل دسترسی خواهد بود که به سیلوی مشخص‌شدهٔ SILO اختصاص داده شده و عضو آن باشند (و شرایط احراز هویت آن را برآورده کنند).

مدیریت سیلوهای احراز هویت (Authentication Silos).

فهرست کردن سیلوهای احراز هویت در دامنه.

-H, --URL

نشانی LDB URL برای پایگاه‌داده یا سرور مقصد.

--json

مشاهدهٔ سیلوهای احراز هویت به‌صورت JSON به‌جای یک فهرست.

مشاهدهٔ یک سیلوی احراز هویت در دامنه.

-H, --URL

نشانی LDB URL برای پایگاه‌داده یا سرور مقصد.

--name

نام سیلوی احراز هویت برای مشاهده (الزامی).

ایجاد سیلوهای احراز هویت در دامنه.

-H, --URL

نشانی LDB URL برای پایگاه‌داده یا سرور مقصد.

--name

نام سیلوی احراز هویت (الزامی).

--description

توضیحات اختیاری برای سیلوی احراز هویت.

--user-authentication-policy

خط‌مشی احراز هویت حساب کاربری.

--service-authentication-policy

خط‌مشی احراز هویت حساب سرویس مدیریت‌شده.

--computer-authentication-policy

خط‌مشی احراز هویت حساب رایانه.

--protect

محافظت از سیلوی احراز هویت در برابر حذف تصادفی.

نمی‌تواند همراه با --unprotect استفاده شود.

--unprotect

لغو محافظت سیلوی احراز هویت در برابر حذف تصادفی.

نمی‌تواند همراه با --protect استفاده شود.

--audit

فقط حسابرسی خط‌مشی‌های سیلو.

نمی‌تواند همراه با --enforce استفاده شود.

--enforce

اعمال اجباری خط‌مشی‌های سیلو.

نمی‌تواند همراه با --audit استفاده شود.

تغییر سیلوهای احراز هویت در دامنه.

-H, --URL

نشانی LDB URL برای پایگاه‌داده یا سرور مقصد.

--name

نام سیلوی احراز هویت (الزامی).

--description

توضیحات اختیاری برای سیلوی احراز هویت.

--user-authentication-policy

خط‌مشی احراز هویت حساب کاربری.

--service-authentication-policy

خط‌مشی احراز هویت حساب سرویس مدیریت‌شده.

--computer-authentication-policy

خط‌مشی احراز هویت حساب رایانه.

--protect

محافظت از سیلوی احراز هویت در برابر حذف تصادفی.

نمی‌تواند همراه با --unprotect استفاده شود.

--unprotect

لغو محافظت سیلوی احراز هویت در برابر حذف تصادفی.

نمی‌تواند همراه با --protect استفاده شود.

--audit

فقط حسابرسی خط‌مشی‌های سیلو.

نمی‌تواند همراه با --enforce استفاده شود.

--enforce

اعمال اجباری خط‌مشی‌های سیلو.

نمی‌تواند همراه با --audit استفاده شود.

حذف سیلوهای احراز هویت در دامنه.

-H, --URL

نشانی LDB URL برای پایگاه‌داده یا سرور مقصد.

--name

نام سیلوی احراز هویت برای حذف (الزامی).

--force

اجبار به حذف سیلوی احراز هویت حتی اگر محافظت‌شده باشد.

اعطای دسترسی به یک عضو در یک سیلوی احراز هویت.

-H, --URL

نشانی LDB URL برای پایگاه‌داده یا سرور مقصد.

--name

نام سیلوی احراز هویت (الزامی).

--member

عضو مورد نظر برای اعطای دسترسی به سیلو (DN یا نام حساب کاربری).

فهرست کردن اعضای موجود در یک سیلوی احراز هویت.

-H, --URL

نشانی LDB URL برای پایگاه‌داده یا سرور مقصد.

--name

نام سیلوی احراز هویت (الزامی).

--json

مشاهدهٔ اعضا به‌صورت JSON به‌جای فهرست.

لغو عضویت یک عضو از یک سیلوی احراز هویت.

-H, --URL

نشانی LDB URL برای پایگاه‌داده یا سرور مقصد.

--name

نام سیلوی احراز هویت (الزامی).

--member

عضو مورد نظر برای لغو عضویت از سیلو (DN یا نام حساب کاربری).

فهرست کردن انواع ادعا (claim types) در دامنه.

-H, --URL

نشانی LDB URL برای پایگاه‌داده یا سرور مقصد.

--json

مشاهدهٔ انواع ادعا به‌صورت JSON به‌جای فهرست.

مشاهدهٔ یک نوع ادعا در دامنه.

-H, --URL

نشانی LDB URL برای پایگاه‌داده یا سرور مقصد.

--name

نام نمایشی نوع ادعا برای مشاهده (الزامی).

ایجاد انواع ادعا در دامنه.

-H, --URL

نشانی LDB URL برای پایگاه‌داده یا سرور مقصد.

--attribute

ویژگی نوع ادعا برای ایجاد (الزامی).

--class

کلاس‌های شیء برای تنظیم نوع ادعا روی آن‌ها.

مثال: --class=user --class=computer

--name

نام نمایشی اختیاری یا استفاده از نام ویژگی.

--description

توضیحات اختیاری یا استفاده از توضیحات ویژگی.

--enable

فعال‌سازی نوع ادعا.

نمی‌تواند همراه با --disable استفاده شود.

--disable

غیرفعال‌سازی نوع ادعا.

نمی‌تواند همراه با --enable استفاده شود.

--protect

محافظت از نوع ادعا در برابر حذف تصادفی.

نمی‌تواند همراه با --unprotect استفاده شود.

--unprotect

لغو محافظت نوع ادعا در برابر حذف تصادفی.

نمی‌تواند همراه با --protect استفاده شود.

تغییر انواع ادعا در دامنه.

-H, --URL

نشانی LDB URL برای پایگاه‌داده یا سرور مقصد.

--name

نام نمایشی نوع ادعا برای تغییر (الزامی).

--class

کلاس‌های شیء برای تنظیم نوع ادعا روی آن‌ها.

مثال: --class=user --class=computer

--description

تنظیم توضیحات نوع ادعا.

--enable

فعال‌سازی نوع ادعا.

نمی‌تواند همراه با --disable استفاده شود.

--disable

غیرفعال‌سازی نوع ادعا.

نمی‌تواند همراه با --enable استفاده شود.

--protect

محافظت از نوع ادعا در برابر حذف تصادفی.

نمی‌تواند همراه با --unprotect استفاده شود.

--unprotect

لغو محافظت نوع ادعا در برابر حذف تصادفی.

نمی‌تواند همراه با --protect استفاده شود.

حذف انواع ادعا در دامنه.

-H, --URL

نشانی LDB URL برای پایگاه‌داده یا سرور مقصد.

--name

نام نمایشی نوع ادعا برای حذف (الزامی).

--force

اجبار به حذف نوع ادعا حتی در صورت محافظت شدن.

فهرست کردن انواع مقدار ادعا (claim value types) در دامنه.

-H, --URL

نشانی LDB URL برای پایگاه‌داده یا سرور مقصد.

--json

مشاهدهٔ انواع مقدار ادعا به‌صورت JSON به‌جای فهرست.

مشاهدهٔ یک نوع مقدار ادعای منفرد در دامنه.

-H, --URL

نشانی LDB URL برای پایگاه‌داده یا سرور مقصد.

--name

نام نمایشی نوع مقدار ادعا برای مشاهده (الزامی).

ارتقا از پایگاه‌داده کلاسیک سامبا (مشابه NT4) به پایگاه‌داده Samba AD DC.

ارتقای یک عضو دامنهٔ موجود یا یک NT4 PDC به یک AD DC.

تنزل رتبهٔ سرور جاری از نقش کنترل‌کنندهٔ دامنه (DC).

استخراج کلیدهای کربروس دامنه در یک فایل keytab.

آماده‌سازی یک دامنه برای ارتقای سطح عملکردی (functional level). اگر --functional-level استفاده نشود، آخرین نسخهٔ پشتیبانی‌شده (در حال حاضر 2016) استفاده خواهد شد.

این آماده‌سازی شامل دو جنبهٔ مربوط به جنگل (forest) و دامنه (domain) است. به‌طور پیش‌فرض هر دو اجرا می‌شوند. اگر از هر یک از گزینه‌های --forest-prep یا --domain-prep استفاده شود، فقط آماده‌سازی متناظر انجام می‌شود. در صورت استفادهٔ همزمان از هر دو آرگومان، تمام آماده‌سازی‌ها انجام خواهد شد، دقیقاً مانند حالتی که هیچ‌یک از آن‌ها مشخص نشده باشد.

-H, --URL

نشانی LDB URL برای پایگاه‌داده یا سرور مقصد.

--functional-level [2008_R2|2012|2012_R2|2016]

سطح عملکردی مورد نظر برای آماده‌سازی. مقدار پیش‌فرض 2016 است.

--forest-prep

اجرای فقط آماده‌سازی جنگل (مگر اینکه --domain-prep نیز استفاده شود).

--domain-prep

اجرای فقط آماده‌سازی دامنه (مگر اینکه --forest-prep نیز استفاده شود).

چاپ اطلاعات پایه دربارهٔ یک دامنه و کنترل‌کنندهٔ دامنهٔ (DC) مشخص‌شده.

پیوستن به یک دامنه به‌عنوان عضو یا کنترل‌کنندهٔ دامنه‌ی پشتیبان.

مدیریت کلیدهای ریشهٔ سرویس توزیع کلید (KDS).

ایجاد کلیدهای ریشهٔ KDS

-H, --URL

نشانی LDB URL برای پایگاه‌داده یا سرور مقصد.

--use-start-time=["now"|iso8601 or LDIF time string]

کلید از این زمان معتبر خواهد بود.

قالب‌های زمانی معتبر عبارتند از رشتهٔ "now"، قالب LDIF به‌صورت YYYYmmddHHMMSS.0Z، یا قالب ISO به‌صورت YYYY-mm-dd[*HH[:MM[:SS[.fff[fff]]]][+HH:MM[:SS[.ffffff]]]] که در آن '*' می‌تواند هر کاراکتری باشد، و بخش اختیاری پایانی '[+HH:MM[:SS[.ffffff]]]' اختلاف منطقهٔ زمانی است (مانند '+00:00' برای UTC).

--json

خروجی نتایج در قالب JSON.

حذف کلید ریشهٔ KDS نام‌گذاری‌شده. از دستور samba-tool domain kds root-key list برای یافتن نام کلید استفاده کنید.

-H, --URL

نشانی LDB URL برای پایگاه‌داده یا سرور مقصد.

--name=NAME

نام کلیدی که باید حذف شود. این مقدار یک GUID خواهد بود.

-v, --verbose

چاپ تمام ویژگی‌ها (به‌جز موارد مخفی، مگر اینکه از --show secrets استفاده شود).

--json

خروجی نتایج در قالب JSON.

فهرست کردن کلیدهای ریشهٔ KDS. جدیدترین کلیدها در ابتدا فهرست می‌شوند.

-H, --URL

نشانی LDB URL برای پایگاه‌داده یا سرور مقصد.

--show-secrets

چاپ ویژگی‌های مخفی یا بالقوه حساس، به‌ویژه msKds-RootKeyData و msKds-SecretAgreementParam.

-v, --verbose

چاپ ویژگی‌های بیشتر (اما نه موارد مخفی، مگر اینکه --show secrets نیز استفاده شود).

--json

خروجی نتایج در قالب JSON.

مشاهدهٔ یک کلید ریشهٔ KDS. خروجی پیش‌فرض مشابه خروجی دستور samba-tool domain kds root-key list --verbose است، اما تنها یک کلید نمایش داده می‌شود. کلید را می‌توان با استفاده از --latest برای جدیدترین کلید، یا --name برای انتخاب کلید با نام انتخاب کرد.

-H, --URL

نشانی LDB URL برای پایگاه‌داده یا سرور مقصد.

--latest

مشاهدهٔ جدیدترین کلید ریشه.

--name=NAME

نام کلید برای مشاهده. این مقدار یک GUID خواهد بود.

-v, --verbose

چاپ تمام ویژگی‌ها (به‌جز موارد مخفی، مگر اینکه از --show secrets استفاده شود). این شامل ویژگی‌هایی است که فقط برای نگهداری داخلی LDB کاربرد دارند.

--json

خروجی نتایج در قالب JSON.

اجرای این دستور روی یک عضو دامنه باعث خروج آن از دامنه خواهد شد.

برای حذف یک سرور دامنه از دامنه، ابتدا به دستور samba-tool domain demote نیاز دارید.

--keep-account

غیرفعال کردن حساب ماشین به‌جای حذف آن.

نمایش یا ارتقای سطوح عملکردی دامنه و جنگل.

تنظیم پارامترهای گذرواژه، شامل الزامات پیچیدگی، خط‌مشی قفل شدن، طول تاریخچه، حداقل طول گذرواژه، و حداقل و حداکثر عمر گذرواژه در یک سرور Samba AD DC.

استفاده در برابر Windows DC امکان‌پذیر است، اما group policy آن را بازنویسی خواهد کرد.

-H URL, --URL=URL

نشانی LDB URL برای پایگاه‌داده یا سرور مقصد

-q, --quiet

حالت بی‌صدا

--complexity=COMPLEXITY

پیچیدگی گذرواژه (on | off | default). مقدار پیش‌فرض 'on' است

--store-plaintext=STORE_PLAINTEXT

ذخیرهٔ گذرواژه‌ها به‌صورت متن آشکار در شرایطی که گزینهٔ 'store passwords with reversible encryption' برای حساب تنظیم شده باشد (on | off | default). مقدار پیش‌فرض 'off' است

--history-length=HISTORY_LENGTH

طول تاریخچهٔ گذرواژه (عدد صحیح | default). مقدار پیش‌فرض 24 است.

--min-pwd-length=MIN_PWD_LENGTH

حداقل طول مجاز گذرواژه (عدد صحیح | default). مقدار پیش‌فرض 7 است.

--min-pwd-age=MIN_PWD_AGE

حداقل سن گذرواژه (تعداد روز | default). مقدار پیش‌فرض 1 است.

--max-pwd-age=MAX_PWD_AGE

حداکثر سن مجاز گذرواژه (تعداد روز | default). مقدار پیش‌فرض 43 است.

--account-lockout-duration=ACCOUNT_LOCKOUT_DURATION

مدت زمانی که یک حساب پس از فراتر رفتن از حد مجاز تلاش‌های ناموفق ورود قفل می‌ماند (تعداد دقیقه | default). مقدار پیش‌فرض 30 دقیقه است.

--account-lockout-threshold=ACCOUNT_LOCKOUT_THRESHOLD

تعداد تلاش‌های ناموفق مجاز پیش از قفل شدن حساب کاربری (عدد صحیح | default). مقدار پیش‌فرض 0 است (هرگز قفل نشود).

--reset-account-lockout-after=RESET_ACCOUNT_LOCKOUT_AFTER

پس از سپری شدن این مدت زمان، تعداد تلاش‌های ناموفق ثبت‌شده از صفر آغاز می‌شود (عدد صحیح | default). مقدار پیش‌فرض 30 است.

نمایش تنظیمات جاری گذرواژه برای دامنه.

-H URL, --URL=URL

نشانی LDB URL برای پایگاه‌داده یا سرور مقصد

مدیریت اشیای تنظیمات ریزدانه‌ای گذرواژه (PSOs).

اعمال خط‌مشی گذرواژهٔ یک PSO به یک کاربر یا گروه.

ایجاد یک شیء تنظیمات گذرواژه (PSO) جدید.

حذف یک شیء تنظیمات گذرواژه (PSO).

فهرست کردن تمام اشیای تنظیمات گذرواژه (PSOs).

ویرایش یک شیء تنظیمات گذرواژه (PSO).

نمایش یک شیء تنظیمات گذرواژه (PSO).

نمایش تنظیمات گذرواژه‌ای که برای یک کاربر اعمال می‌شود.

به‌روزرسانی یک PSO به‌گونه‌ای که دیگر برای یک کاربر یا گروه اعمال نشود.

راه‌اندازی دامنه یا ارتقای یک عضو دامنهٔ موجود یا NT4 PDC به AD DC.

ارتقای اسکیمای اکتیو دایرکتوری (schema).

-H, --URL

نشانی LDB URL برای پایگاه‌داده یا سرور مقصد.

--schema [2012|2012_R2|2016|2019]

ارتقا به این سطح اسکیمای ویندوز. مقدار پیش‌فرض 2019 است.

--ldf-file

اعمال تغییرات اسکیما موجود در این فایل LDIF، به‌جای به‌روزرسانی به یک سطح استاندارد اسکیما.

--base-dir

تعیین یک مکان جایگزین برای یافتن فایل‌های LDIF اسکیما.

-H URL, --URL=URL

نشانی LDB URL برای پایگاه‌داده یا سرور مقصد

--current-time=YYYY-MM-DD

زمان جاری برای ارزیابی طول عمر tombstone، به‌صورت YYYY-MM-DD

--tombstone-lifetime=DAYS

تعداد روزهایی که یک tombstone باید نگهداری شود

مدیریت پیوندهای اعتماد (trust) دامنه و جنگل.

ایجاد یک پیوند اعتماد دامنه یا جنگل.

تغییر یک پیوند اعتماد دامنه یا جنگل.

حذف یک پیوند اعتماد دامنه.

فهرست کردن پیوندهای اعتماد دامنه.

مدیریت فضاهای نام پیوند اعتماد جنگل.

نمایش جزئیات دامنهٔ مورد اعتماد.

اعتبارسنجی یک پیوند اعتماد دامنه.

مدیریت سرویس‌های همانندسازی دایرکتوری (DRS).

نمایش قابلیت‌های DRS یک سرور.


--targetdir=DIR [options]"

همانندسازی یک کلون اولیه از دامنه، بدون پیوستن به آن (DO NOT JOIN).

--server=DC

کلون کردن این DC.

--targetdir=TARGETDIR

محل ذخیرهٔ داده‌های راه‌اندازی (الزامی).

-q, --quiet

حالت بی‌صدا.

--include-secrets

همانندسازی مقادیر محرمانه (secrets).

--backend-store=BACKENDSTORE

تعیین بک‌اند پایگاه داده مورد استفاده (پیش‌فرض tdb است).

--backend-store-size=SIZE

تعیین اندازهٔ پایگاه دادهٔ بک‌اند؛ در حال حاضر فقط در بک‌اندهای lmdb پشتیبانی می‌شود (پیش‌فرض 8 گیگابایت است).

نمایش وضعیت به‌روز بودن (uptodateness).

-H URL, --URL=URL

نشانی LDB URL برای پایگاه‌داده یا سرور مقصد

-p PARTITION, --partition=PARTITION

محدود کردن به این پارتیشن

--json

چاپ داده‌ها در قالب json

--maximum

چاپ فقط حداکثر میزان قدیمی بودن داده‌ها

--median

چاپ فقط میانهٔ میزان قدیمی بودن داده‌ها

--full

چاپ تمام داده‌های قدیمی بودن

اجرای بررسی یکپارچگی دانش (KCC).

پرس‌وجو یا تغییر options برای شیء NTDS Settings یک کنترل‌کنندهٔ دامنه.

همانندسازی یک بافت نام‌گذاری (naming context) میان دو DC.

نمایش وضعیت همانندسازی. گزینهٔ [--json] منجر به تولید خروجی JSON شده، و همراه با گزینهٔ [--summary] در صورت سالم بودن وضعیت همانندسازی، خروجی بسیار کمی تولید می‌کند.

مدیریت فهرست‌های کنترل دسترسی دایرکتوری سرویس (DS ACLs)

حذف یک مدخل فهرست دسترسی روی یک شیء دایرکتوری.

چاپ فهرست دسترسی روی یک شیء دایرکتوری.

ویرایش فهرست دسترسی روی یک شیء دایرکتوری.

مدیریت پیکربندی جنگل (Forest).

مدیریت رفتار directory_service برای جنگل.

ویرایش پیکربندی dsheuristics در directory_service برای جنگل.

نمایش پیکربندی فعلی directory_service برای جنگل.

مدیریت نقش‌های FSMO (Flexible Single Master Operations).

تصاحب نقش (seize).

نمایش نقش‌ها.

انتقال نقش (transfer).

مدیریت اشیای خط‌مشی گروهی (GPO).

بررسی تطابق ACLهای LDAP و DS در تمام GPOها.

-H URL, --URL=URL

نشانی LDB URL برای پایگاه‌داده یا سرور مقصد

بارگذاری فایل‌های admx سامبا در sysvol

-H URL, --URL=URL

نشانی LDB URL برای پایگاه‌داده یا سرور مقصد

--admx-dir=ADMX_DIR

پوشه‌ای که الگوهای admx در آن نگهداری می‌شوند

پشتیبان‌گیری از یک GPO.

-H H

نشانی LDB URL برای پایگاه‌داده یا سرور مقصد

--tmpdir=TMPDIR

پوشهٔ موقت برای کپی کردن فایل‌های خط‌مشی

--generalize

عمومی‌سازی موجودیت‌های XML برای بازیابی

--entities=ENT_FILE

فایل برای صدور موجودیت‌های XML تعریف‌شده برای بازیابی

ایجاد یک GPO خالی.

فهرست کردن افزونه‌های سمت کلاینت (CSE) ثبت‌شده در میزبان فعلی.

ثبت یک افزونهٔ سمت کلاینت (CSE) در میزبان فعلی.

این دستور نام فایل یک CSE را به‌عنوان آرگومان دریافت کرده و آن را برای اعمال خط‌مشی روی میزبان فعلی ثبت می‌کند. این کار برای CSEهایی که همراه با نسخهٔ فعلی سامبا توزیع می‌شوند لازم نیست، اما برای نصب CSEهای آزمایشی یا سفارشی مفید است.

آرگومان cse_file باید یک مسیر دائمی برای CSE باشد. دستور register فایل را به پوشهٔ دیگری کپی نمی‌کند. دستور samba-gpupdate افزونهٔ CSE را دقیقاً از مکانی که با این دستور مشخص شده است اجرا خواهد کرد.

--machine

آیا CSE به‌عنوان خط‌مشی Machine ثبت شود یا خیر

--user

آیا CSE به‌عنوان خط‌مشی User ثبت شود یا خیر

لغو ثبت یک افزونهٔ سمت کلاینت (CSE) از میزبان جاری.

این دستور یک شناسهٔ GUID یکتا را به‌عنوان آرگومان دریافت می‌کند (که نمایانگر یک CSE ثبت‌شده است) و ثبت آن را برای اعمال خط‌مشی روی میزبان جاری لغو می‌کند. برای یافتن شناسه‌های یکتای GUID افزونه‌ها از دستور `samba-tool gpo cse list` استفاده کنید.

حذف GPO.

حذف پیوند GPO از یک ظرف (container).

دانلود یک GPO.

دریافت پرچم وراثت برای یک ظرف.

فهرست کردن پیوندهای GPO برای یک ظرف.

فهرست کردن GPOها برای یک حساب کاربری.

فهرست کردن تمام GPOها.

فهرست کردن تمام ظرف‌های پیوندخورده برای یک GPO.

بارگذاری خط‌مشی‌ها روی یک GPO.

داده‌های json را از ورودی استاندارد تا پایان فایل (EOF) می‌خواند، مگر اینکه فایلی در قالب json از طریق --content ارائه شود.

نمونه json_input:

[
    {
        "keyname": "Software\Policies\Mozilla\Firefox\Homepage",
        "valuename": "StartPage",
        "class": "USER",
        "type": "REG_SZ",
        "data": "homepage"
    },
    {
        "keyname": "Software\Policies\Mozilla\Firefox\Homepage",
        "valuename": "URL",
        "class": "USER",
        "type": "REG_SZ",
        "data": "google.com"
    },
    {
        "keyname": "Software\Microsoft\Internet Explorer\Toolbar",
        "valuename": "IEToolbar",
        "class": "USER",
        "type": "REG_BINARY",
        "data": [0]
    },
    {
        "keyname": "Software\Policies\Microsoft\InputPersonalization",
        "valuename": "RestrictImplicitTextCollection",
        "class": "USER",
        "type": "REG_DWORD",
        "data": 1
    }
    ]

ویژگی‌های کلاس معتبر: MACHINE|USER|BOTH آرایه‌های داده به‌صورت بایت تفسیر می‌شوند.

گزینه‌های --machine-ext-name و --user-ext-name ورودی‌های چندمقداری هستند که به ترتیب ویژگی‌های ldap با نام gPCMachineExtensionNames و gPCUserExtensionNames را روی GPO تنظیم می‌کنند. این ویژگی‌ها باید روی نام‌های GUID صحیح تنظیم شوند تا خط‌مشی گروهی ویندوز به‌درستی کار کند. این GUIDها نمایانگر افزونه‌های سمت کلاینت برای اعمال روی ماشین هستند. خط‌مشی گروهی لینوکس این محدودیت را تحمیل نمی‌کند. مقدار {35378EAC-683F-11D2-A89A-00C04FBBCFA2} به‌طور پیش‌فرض ارائه می‌شود که بیشتر خط‌مشی‌های رجیستری را فعال می‌سازد.

-H H

نشانی LDB URL برای پایگاه‌داده یا سرور مقصد

--content=CONTENT

فایل JSON ورودی‌های خط‌مشی

--machine-ext-name=MACHINE_EXTS

نام افزونهٔ ماشین برای افزودن به gPCMachineExtensionNames

--user-ext-name=USER_EXTS

نام افزونهٔ کاربر برای افزودن به gPCUserExtensionNames

--replace

جایگزینی خط‌مشی‌های گروهی موجود، به‌جای ادغام آن‌ها

فهرست کردن خط‌مشی گروهی امنیتی سامبا از sysvol.

این دستور تنظیمات امنیتی را از sysvol که برای کلاینت‌های winbind اعمال خواهد شد فهرست می‌کند. این تنظیمات فقط روی AD DC اعمال می‌شوند.

مثال:

samba-tool gpo manage security list {31B2F340-016D-11D2-945F-00C04FB984F9}

-H URL, --URL=URL

نشانی LDB URL برای پایگاه‌داده یا سرور مقصد

تنظیم خط‌مشی گروهی امنیتی سامبا در sysvol.

این دستور یک تنظیم امنیتی را در sysvol برای اعمال روی کلاینت‌های winbind تنظیم می‌کند. عدم ارائهٔ مقدار باعث لغو تنظیم این خط‌مشی خواهد شد. این تنظیمات فقط روی AD DC اعمال می‌شوند.

مثال:

samba-tool gpo manage security set {31B2F340-016D-11D2-945F-00C04FB984F9} MaxTicketAge 10

خط‌مشی‌های ممکن:

MaxTicketAge

حداکثر طول عمر بلیت کاربر (ساعت).

MaxServiceAge

حداکثر طول عمر بلیت سرویس بر حسب دقیقه.

MaxRenewAge

حداکثر طول عمر تمدید بلیت کاربر، بر حسب دقیقه.

MinimumPasswordAge

حداقل سن گذرواژه، بر حسب روز.

MaximumPasswordAge

حداکثر سن گذرواژه، بر حسب روز.

MinimumPasswordLength

حداقل طول گذرواژه، بر حسب کاراکتر.

PasswordComplexity

گذرواژه باید شرایط پیچیدگی را برآورده کند. 1 فعال و 0 غیرفعال است.

-H URL, --URL=URL

نشانی LDB URL برای پایگاه‌داده یا سرور مقصد

فهرست کردن خط‌مشی گروهی امنیتی سامبا از sysvol.

این دستور تنظیمات امنیتی را از sysvol که برای کلاینت‌های winbind اعمال خواهد شد فهرست می‌کند. این تنظیمات فقط روی AD DC اعمال می‌شوند.

مثال:

samba-tool gpo manage security list {31B2F340-016D-11D2-945F-00C04FB984F9}

-H URL, --URL=URL

نشانی LDB URL برای پایگاه‌داده یا سرور مقصد

فهرست کردن تنظیمات smb.conf از sysvol که برای کلاینت‌های winbind اعمال می‌شوند.

مثال:

samba-tool gpo manage smb_conf list {31B2F340-016D-11D2-945F-00C04FB984F9}

-H URL, --URL=URL

نشانی LDB URL برای پایگاه‌داده یا سرور مقصد

تنظیم یا لغو تنظیم smb.conf در sysvol برای اعمال روی کلاینت‌های winbind.

اگر مقداری ارائه شود، از همان مقدار smb.conf استفاده می‌شود؛ اگر مقداری ارائه نشود، خط‌مشی حذف خواهد شد.

مثال:

samba-tool gpo manage smb_conf set {31B2F340-016D-11D2-945F-00C04FB984F9} 'apply gpo policies' yes

-H URL, --URL=URL

نشانی LDB URL برای پایگاه‌داده یا سرور مقصد

تنظیم پرچم وراثت روی یک ظرف.

افزودن یا به‌روزرسانی پیوند GPO به یک ظرف.

نمایش اطلاعات یک GPO.

حذف خط‌مشی‌ها از یک GPO.

داده‌های json را از ورودی استاندارد تا پایان فایل (EOF) می‌خواند، مگر اینکه فایلی در قالب json از طریق --content ارائه شود.

Example json_input:
[
    {
        "keyname": "Software\Policies\Mozilla\Firefox\Homepage",
        "valuename": "StartPage",
        "class": "USER",
    },
    {
        "keyname": "Software\Policies\Mozilla\Firefox\Homepage",
        "valuename": "URL",
        "class": "USER",
    },
    {
        "keyname": "Software\Microsoft\Internet Explorer\Toolbar",
        "valuename": "IEToolbar",
        "class": "USER"
    },
    {
        "keyname": "Software\Policies\Microsoft\InputPersonalization",
        "valuename": "RestrictImplicitTextCollection",
        "class": "USER"
    }
]

ویژگی‌های کلاس معتبر: MACHINE|USER|BOTH

-H H

نشانی LDB URL برای پایگاه‌داده یا سرور مقصد

--content=CONTENT

فایل JSON ورودی‌های خط‌مشی

--machine-ext-name=MACHINE_EXTS

نام یک افزونهٔ ماشین برای حذف از gPCMachineExtensionNames

--user-ext-name=USER_EXTS

نام یک افزونهٔ کاربر برای حذف از gPCUserExtensionNames

--color=always|never|auto

استفاده از رنگ در صورت در دسترس بودن (پیش‌فرض: auto)

بازیابی یک GPO به یک ظرف جدید.

-H H

نشانی LDB URL برای پایگاه‌داده یا سرور مقصد

--tmpdir=TMPDIR

پوشهٔ موقت برای کپی کردن فایل‌های خط‌مشی

--entities=ENTITIES

فایل تعریف موجودیت‌های XML برای درج در هدر DOCTYPE

--restore-metadata

نگهداری فایل قدیمی GPT.INI و شماره نسخهٔ مرتبط

نمایش اطلاعات یک GPO.

فهرست کردن خط‌مشی گروهی پیوند نمادین VGP از sysvol

افزودن خط‌مشی گروهی پیوند نمادین VGP به sysvol

حذف یک خط‌مشی گروهی پیوند نمادین VGP از sysvol

فهرست کردن خط‌مشی گروهی پرونده‌های VGP از sysvol

افزودن خط‌مشی گروهی پرونده‌های VGP به sysvol

حذف خط‌مشی گروهی پرونده‌های VGP از sysvol

فهرست کردن خط‌مشی گروهی OpenSSH در VGP از sysvol

تنظیم یک خط‌مشی گروهی OpenSSH در VGP روی sysvol

افزودن یک خط‌مشی گروهی Sudoers سامبا به sysvol.

فهرست کردن خط‌مشی گروهی Sudoers سامبا از sysvol.

حذف یک خط‌مشی گروهی Sudoers سامبا از sysvol.

فهرست کردن خط‌مشی گروهی اسکریپت راه‌اندازی VGP از sysvol

افزودن خط‌مشی گروهی اسکریپت راه‌اندازی VGP به sysvol

حذف خط‌مشی گروهی اسکریپت راه‌اندازی VGP از sysvol

فهرست کردن خط‌مشی گروهی MOTD در VGP از sysvol.

تنظیم خط‌مشی گروهی MOTD در VGP در sysvol

فهرست کردن خط‌مشی گروهی Issue در VGP از sysvol.

تنظیم خط‌مشی گروهی Issue در VGP در sysvol

افزودن خط‌مشی گروهی دسترسی میزبان VGP به sysvol

فهرست کردن خط‌مشی گروهی دسترسی میزبان VGP از sysvol

حذف یک خط‌مشی گروهی دسترسی میزبان VGP از sysvol

مدیریت گروه‌ها.

ایجاد یک گروه جدید در AD.

افزودن یک گروه جدید AD. این یک مترادف برای دستور samba-tool group add است و صرفاً به دلایل سازگاری در دسترس است. لطفاً به‌جای آن از samba-tool group add استفاده کنید.

افزودن اعضا به یک گروه AD.

افزودن ویژگی‌های یونیکس RFC2307 به یک حساب گروه در دامنهٔ اکتیو دایرکتوری. نام گروه مشخص‌شده در دستور همان sAMaccountName است.

ویژگی‌های یونیکس (RFC2307) به حساب گروه اضافه خواهند شد.

عبارت 'idmap_ldb:use rfc2307 = Yes' را به smb.conf اضافه کنید تا از این ویژگی‌ها برای نگاشت UID/GID استفاده شود.

این دستور ممکن است از شناسهٔ کاربری ریشه یا کاربر مجاز دیگری اجرا شود. گزینهٔ -H یا --URL= می‌تواند برای اجرای دستور روی یک سرور راه دور استفاده شود.

مثال ۱:

samba-tool group addunixattrs Group1 10000

مثال ۱ نحوهٔ افزودن ویژگی‌های RFC2307 به یک حساب گروه فعال در دامنه را نشان می‌دهد.

شناسهٔ یونیکس گروه روی '10000' تنظیم خواهد شد، به شرطی که این شناسه از قبل استفاده نشده باشد.

-H URL, --URL=URL

نشانی LDB URL برای پایگاه‌داده یا سرور مقصد

حذف یک گروه AD.

ویرایش یک شیء AD گروه.

--editor=EDITOR

ویرایشگر مورد استفاده را به‌جای پیش‌فرض سیستم یا 'vi' در صورت تنظیم نبودن پیش‌فرض سیستم مشخص می‌کند.

فهرست کردن تمام گروه‌ها.

فهرست کردن تمام اعضای گروه AD مشخص‌شده.

به‌طور پیش‌فرض sAMAccountNameها فهرست می‌شوند. اگر هیچ sAMAccountName در دسترس نباشد، CN به‌جای آن استفاده خواهد شد.

--full-dn

فهرست کردن نام‌های مشخص (DN) به‌جای sAMAccountNameها.

--hide-expired

عدم نمایش اعضای منقضی‌شدهٔ گروه.

--hide-disabled

عدم نمایش اعضای غیرفعال گروه.

این دستور یک گروه را به واحد سازمانی یا ظرف مشخص‌شده منتقل می‌کند.

نام گروه مشخص‌شده در دستور همان sAMAccountName است.

نام واحد سازمانی یا ظرف می‌تواند به‌صورت DN کامل یا بدون جزء domainDN مشخص شود.

حذف اعضا از گروه AD مشخص‌شده.

نمایش شیء گروه و ویژگی‌های آن.

نمایش آمار برای کل گروه‌ها و عضویت‌های گروهی.

تغییر نام یک گروه و ویژگی‌های مرتبط.

این دستور امکان تنظیم ویژگی‌های مرتبط با نام گروه را فراهم می‌کند. شناسهٔ CN گروه به‌طور خودکار تغییر نام خواهد یافت. شناسهٔ CN گروه همان sAMAccountName خواهد بود. از گزینهٔ --force-new-cn برای تعیین دستی CN جدید و از --reset-cn برای بازنشانی این تغییر استفاده کنید.

از یک مقدار ویژگی خالی برای حذف ویژگی مشخص‌شده استفاده کنید.

نام گروه مشخص‌شده در دستور همان sAMAccountName است.

--force-new-cn=NEW_CN

تعیین یک CN (RDN) جدید به‌جای استفاده از sAMAccountName.

--reset-cn

تنظیم CN روی sAMAccountName.

--mail-address=MAIL_ADDRESS

آدرس ایمیل جدید

--samaccountname=SAMACCOUNTNAME

نام حساب کاربری جدید (sAMAccountName/logon name)

مقایسهٔ دو پایگاه‌داده LDAP.

مدیریت NT ACLها.

تغییر SID دامنه برای ACLها. می‌تواند برای تغییر تمام مدخل‌ها در acl_xattr استفاده شود هنگامی که SID ماشین به‌طور تصادفی تغییر کرده یا مجموعه‌داده از طریق پشتیبان‌گیری/بازیابی یا rsync به ماشین دیگری کپی شده است.

--use-ntvfs

تنظیم مستقیم ACLها روی TDB یا xattr. دسترسی‌های POSIX تغییر نخواهند کرد و فقط NT ACL ذخیره خواهد شد.

--service=SERVICE

تعیین نام سرویس smb.conf برای استفاده. این گزینه در ترکیب با گزینهٔ --use-s3fs الزامی است.

--use-s3fs

تنظیم ACLها برای استفاده با سرور فایل پیش‌فرض s3fs از طریق لایهٔ VFS. این گزینه به یک سرویس smb.conf نیاز دارد که با گزینهٔ --service=SERVICE مشخص می‌شود.

--xattr-backend=[native|tdb]

تعیین نوع بک‌اند xattr (سیستم‌فایل بومی یا tdb).

--eadb-file=EADB_FILE

نام فایل tdb که ویژگی‌ها در آن ذخیره می‌شوند.

--recursive

تنظیم بازگشتی ACLها برای پوشه‌ها و محتویات آن‌ها.

--follow-symlinks

دنبال کردن پیوندهای نمادین هنگامی که --recursive مشخص شده است.

--verbose

فهرست کردن پرونده‌ها و ACLهایی که در حال پردازش هستند با جزئیات کامل.

دریافت اطلاعات DOS یک پرونده از xattr.

دریافت ACLهای یک پرونده.

تنظیم ACLهای یک پرونده.

بررسی مطابقت ACLهای sysvol با مقادیر پیش‌فرض (شامل ACLهای صحیح روی GPOها).

بازنشانی ACLهای sysvol به مقادیر پیش‌فرض (شامل ACLهای صحیح روی GPOها).

مدیریت واحدهای سازمانی (OUs).

افزودن یک واحد سازمانی جدید.

نام واحد سازمانی می‌تواند به‌صورت یک DN کامل یا بدون جزء domainDN مشخص شود.

--description=DESCRIPTION

تعیین توضیحات OU.

افزودن یک واحد سازمانی جدید. این یک مترادف برای دستور samba-tool ou add است و صرفاً به دلایل سازگاری ارائه شده است. لطفاً به‌جای آن از samba-tool ou add استفاده کنید.

حذف یک واحد سازمانی.

نام واحد سازمانی می‌تواند به‌صورت DN کامل یا بدون جزء domainDN مشخص شود.

--force-subtree-delete

حذف واحد سازمانی و تمام زیرشاخه‌های آن به‌صورت بازگشتی.

فهرست کردن تمام واحدهای سازمانی.

--full-dn

نمایش DNها شامل DN پایه.

فهرست کردن تمام اشیاء در یک واحد سازمانی.

نام واحد سازمانی می‌تواند به‌صورت یک DN کامل یا بدون جزء domainDN مشخص شود.

--full-dn

نمایش DNها شامل DN پایه.

-r|--recursive

فهرست کردن اشیاء به‌صورت بازگشتی.

انتقال یک واحد سازمانی.

نام واحدهای سازمانی می‌تواند به‌صورت یک DN کامل یا بدون جزء domainDN مشخص شود.

تغییر نام یک واحد سازمانی.

نام واحدهای سازمانی می‌تواند به‌صورت یک DN کامل یا بدون جزء domainDN مشخص شود.

فهرست کردن فرایندهای سرور سامبا.

اگر هیچ فرایندی نشان داده نشود اما سامبا در حال اجرا باشد، ممکن است samba-tool نتوانسته باشد smb.conf صحیح را پیدا کند، و استفاده از -s/--configfile لازم است.

--name=NAME

نمایش فرایندهای مرتبط با نام داده‌شده.

--pid=PID

نمایش نام‌های مرتبط با این PID.

مدیریت کنترل‌کنندهٔ دامنهٔ فقط‌خواندنی (RODC).

پیش‌بارگذاری یک حساب برای یک RODC.

مدیریت و پرس‌وجوی اسکیما (schema).

تغییر رفتار یک ویژگی در اسکیما.

نمایش تعریف اسکیمای یک ویژگی.

نمایش کلاس‌های شیء (objectclasses) که ممکن است یا باید این ویژگی را در بر داشته باشند.

نمایش تعریف اسکیمای یک کلاس شیء.

مدیریت حساب‌های سرویس (Service Accounts).

فهرست کردن حساب‌های سرویس در دامنه.

-H, --URL

نشانی LDB URL برای پایگاه‌داده یا سرور مقصد.

--json

مشاهدهٔ حساب‌های سرویس به‌صورت JSON به‌جای فهرست.

مشاهدهٔ یک حساب سرویس منفرد در دامنه.

-H, --URL

نشانی LDB URL برای پایگاه‌داده یا سرور مقصد.

--name

نام حساب سرویس برای مشاهده (الزامی).

ایجاد یک حساب سرویس جدید در دامنه.

-H, --URL

نشانی LDB URL برای پایگاه‌داده یا سرور مقصد.

--name

نام حساب سرویس (الزامی).

--dns-host-name

نام میزبان DNS این حساب سرویس (الزامی).

--group-msa-membership

رشتهٔ اختیاری SDDL عضویت در Group MSA.

--managed-password-interval

فاصلهٔ زمانی تازه‌سازی گذرواژهٔ مدیریت‌شده بر حسب روز.

ویرایش یک حساب سرویس موجود در دامنه.

-H, --URL

نشانی LDB URL برای پایگاه‌داده یا سرور مقصد.

--name

نام حساب سرویس (الزامی).

--dns-host-name

به‌روزرسانی نام میزبان DNS این حساب سرویس.

--group-msa-membership

به‌روزرسانی SDDL عضویت در Group MSA.

حذف یک حساب سرویس در دامنه.

-H, --URL

نشانی LDB URL برای پایگاه‌داده یا سرور مقصد.

--name

نام حساب سرویس برای حذف.

مدیریت عضویت Group MSA حساب سرویس.

نمایش عضویت Group MSA برای یک حساب سرویس.

-H, --URL

نشانی LDB URL برای پایگاه‌داده یا سرور مقصد.

--name

نام حساب سرویس (الزامی).

--json

بازگرداندن به‌صورت JSON به‌جای فهرست.

افزودن یک شناسهٔ اصلی (principal) به عضویت Group MSA برای یک حساب سرویس.

-H, --URL

نشانی LDB URL برای پایگاه‌داده یا سرور مقصد.

--name

نام حساب سرویس (الزامی).

--principal

نام، DN یا SID شناسهٔ اصلی برای افزودن.

حذف یک شناسهٔ اصلی از عضویت Group MSA برای یک حساب سرویس.

-H, --URL

نشانی LDB URL برای پایگاه‌داده یا سرور مقصد.

--name

نام حساب سرویس (الزامی).

--principal

نام، DN یا SID شناسهٔ اصلی برای حذف.

باز کردن پوستهٔ تعاملی پایتون سامبا.

باز کردن یک پوستهٔ تعاملی پایتون برای اتصال ldb سامبا.

-H, --URL

نشانی LDB URL برای پایگاه‌داده یا سرور مقصد.

مدیریت سایت‌ها (Sites).

فهرست کردن سایت‌ها.

--json

خروجی به‌صورت JSON به‌جای فهرست

مشاهدهٔ جزئیات سایت.

ایجاد یک سایت جدید.

حذف یک سایت موجود.

فهرست کردن زیرشبکه‌های یک سایت.

--json

خروجی به‌صورت JSON به‌جای فهرست

مشاهدهٔ جزئیات زیرشبکه.

ایجاد یک زیرشبکهٔ جدید.

حذف یک زیرشبکهٔ موجود.

اختصاص یک زیرشبکه به یک سایت.

مدیریت نام‌های اصلی سرویس (SPN).

ایجاد یک SPN جدید.

حذف یک SPN موجود.

فهرست کردن SPNهای یک کاربر مشخص.

بررسی نحو (سینتکس) فایل پیکربندی.

دریافت زمان از یک سرور.

مدیریت کاربران.

افزودن یک کاربر جدید به دامنهٔ اکتیو دایرکتوری.

افزودن ویژگی‌های RFC2307 به یک کاربر.

این دستور ویژگی‌های یونیکس را به یک حساب کاربری در دامنهٔ اکتیو دایرکتوری اضافه می‌کند.

نام کاربری مشخص‌شده در دستور همان sAMaccountName است.

شما باید یک uid یکتا ارائه دهید.

ویژگی‌های یونیکس (RFC2307) به حساب کاربری اضافه خواهند شد.

اگر یک شناسهٔ گروه را با '--gid-number' ارائه دهید، این مقدار برای ویژگی 'gidNumber' یونیکس کاربر استفاده خواهد شد.

اگر '--gid-number' ارائه نشود، gidNumber یونیکس کاربر روی مقدار موجود در 'Domain Users' تنظیم خواهد شد؛ این بدان معناست که Domain Users باید ویژگی gidNumber را داشته باشد.

اگر '--unix-home' ارائه نشود، دایرکتوری خانگی یونیکس کاربر روی /home/DOMAIN/username تنظیم خواهد شد.

اگر '--login-shell' ارائه نشود، پوستهٔ ورود یونیکس کاربر روی '/bin/sh' تنظیم خواهد شد.

اگر '--gecos' ارائه نشود، فیلد gecos یونیکس کاربر روی ویژگی 'CN' کاربر تنظیم خواهد شد.

عبارت 'idmap_ldb:use rfc2307 = Yes' را به smb.conf در کنترل‌کننده‌های دامنه اضافه کنید تا از این ویژگی‌ها برای نگاشت UID/GID استفاده شود.

این دستور ممکن است از شناسهٔ کاربری ریشه یا کاربر مجاز دیگری اجرا شود. گزینهٔ -H یا --URL= می‌تواند برای اجرای دستور روی یک سرور راه دور استفاده شود.

مثال ۱:

samba-tool user addunixattrs User1 10001

مثال ۱ نحوهٔ افزودن ویژگی‌های RFC2307 به یک حساب کاربری فعال دامنه را نشان می‌دهد؛ Domain Users به‌عنوان gidNumber کاربر تنظیم خواهد شد.

شناسهٔ یونیکس کاربر روی '10001' تنظیم خواهد شد، به شرطی که این شناسه از قبل استفاده نشده باشد.

مثال ۲:

samba-tool user addunixattrs User2 10002 --gid-number=10001 --unix-home=/home/User2

مثال ۲ نحوهٔ افزودن ویژگی‌های RFC2307 به یک حساب کاربری فعال دامنه را نشان می‌دهد.

شناسهٔ یونیکس کاربر روی '10002' تنظیم خواهد شد، به شرطی که این شناسه از قبل استفاده نشده باشد.

ویژگی gidNumber کاربر روی '10001' تنظیم خواهد شد.

دایرکتوری خانگی یونیکس کاربر روی '/home/user2' تنظیم خواهد شد.

مثال ۳:

samba-tool user addunixattrs User3 10003 --gid-number=10001 --login-shell=/bin/false --gecos='User3 test'

مثال ۳ نحوهٔ افزودن ویژگی‌های RFC2307 به یک حساب کاربری فعال دامنه را نشان می‌دهد.

شناسهٔ یونیکس کاربر روی '10003' تنظیم خواهد شد، به شرطی که این شناسه از قبل استفاده نشده باشد. ویژگی gidNumber کاربر روی '10001' تنظیم خواهد شد. پوستهٔ ورود یونیکس کاربر روی '/bin/false' تنظیم خواهد شد. فیلد gecos کاربر روی 'User3 test' تنظیم خواهد شد.

-H URL, --URL=URL

نشانی LDB URL برای پایگاه‌داده یا سرور مقصد

--gid-number=GROUP_ID

شناسهٔ GID یونیکس/RFC2307 کاربر

--unix-home=DIR

پوشهٔ خانگی یونیکس/RFC2307 کاربر

--login-shell=SHELL

پوستهٔ ورود یونیکس/RFC2307 کاربر

--gecos=GECOS

فیلد GECOS یونیکس/RFC2307 کاربر

--uid=USER_ID

شناسهٔ کاربری (UID) یونیکس/RFC2307 کاربر

افزودن یک کاربر جدید. این یک مترادف برای دستور samba-tool user add است و صرفاً به دلایل سازگاری ارائه شده است. لطفاً به‌جای آن از samba-tool user add استفاده کنید.

حذف یک حساب کاربری موجود.

غیرفعال کردن یک حساب کاربری.

--remove-supplemental-groups

حذف کاربر از تمام گروه‌ها، با حفظ گروه اصلی.

ویرایش شیء AD یک حساب کاربری.

--editor=EDITOR

ویرایشگر مورد استفاده را به‌جای پیش‌فرض سیستم یا 'vi' در صورت تنظیم نبودن پیش‌فرض سیستم مشخص می‌کند.

فعال کردن یک حساب کاربری.

فهرست کردن تمام کاربران.

به‌طور پیش‌فرض sAMAccountNameهای کاربران فهرست می‌شوند.

--full-dn

فهرست کردن نام‌های مشخص (DN) کاربر به‌جای sAMAccountNameها.

-b BASE_DN|--base-dn=BASE_DN

تعیین DN پایه برای استفاده. فقط کاربرانی که زیر این DN پایه قرار دارند فهرست خواهند شد.

--hide-expired

عدم نمایش حساب‌های کاربری منقضی‌شده.

--hide-disabled

عدم نمایش حساب‌های کاربری غیرفعال.

--locked-only

فهرست کردن فقط حساب‌های کاربری قفل‌شده.

تنظیم گروه اصلی یک حساب کاربری.

دریافت عضویت‌های مستقیم گروهی یک حساب کاربری.

نمایش شیء AD یک کاربر.

--attributes=USER_ATTRS

فهرستی از ویژگی‌ها با کاما جدا شده که چاپ خواهند شد.

این دستور یک حساب کاربری را به واحد سازمانی یا ظرف مشخص‌شده منتقل می‌کند.

نام کاربری مشخص‌شده در دستور همان sAMAccountName است.

نام واحد سازمانی یا ظرف می‌تواند به‌صورت DN کامل یا بدون جزء domainDN مشخص شود.

تغییر گذرواژه برای یک حساب کاربری (حسابی که در احراز هویت ارائه شده است).

تغییر نام یک کاربر و ویژگی‌های مرتبط.

این دستور امکان تنظیم ویژگی‌های مرتبط با نام کاربر را فراهم می‌کند. شناسهٔ CN کاربر به‌طور خودکار تغییر نام خواهد یافت. شناسهٔ جدید CN کاربر با ترکیب نام کوچک، حروف اول و نام خانوادگی ساخته می‌شود. در صورت نیاز، یک نقطه ('.') به‌طور خودکار به انتهای حروف اول اضافه خواهد شد. از گزینهٔ --force-new-cn برای تعیین دستی CN جدید و از --reset-cn برای بازنشانی این تغییر استفاده کنید.

از یک مقدار ویژگی خالی برای حذف ویژگی مشخص‌شده استفاده کنید.

نام کاربری مشخص‌شده در دستور همان sAMAccountName است.

--surname=SURNAME

نام خانوادگی جدید

--given-name=GIVEN_NAME

نام کوچک جدید

--initials=INITIALS

حروف اول جدید

--force-new-cn=NEW_CN

تعیین یک CN (RDN) جدید به‌جای استفاده از ترکیب نام کوچک، حروف اول و نام خانوادگی.

--reset-cn

تنظیم CN روی ترکیب پیش‌فرض نام کوچک، حروف اول و نام خانوادگی.

--display-name=DISPLAY_NAME

نام نمایشی جدید

--mail-address=MAIL_ADDRESS

آدرس ایمیل جدید

--samaccountname=SAMACCOUNTNAME

نام حساب کاربری جدید (sAMAccountName/نام ورود)

--upn=UPN

نام اصلی کاربر (UPN) جدید

تنظیم، لغو تنظیم یا نمایش ویژگی UF_NOT_DELEGATED برای یک حساب کاربری.

-H URL, --URL=URL

نشانی LDB URL برای پایگاه‌داده یا سرور مقصد

تنظیم انقضای یک حساب کاربری.

تنظیم یا بازنشانی گذرواژهٔ یک حساب کاربری.

این دستور قفل یک حساب کاربری را در دامنهٔ اکتیو دایرکتوری باز می‌کند.

دریافت گذرواژهٔ یک حساب کاربری.

دریافت بلیت بلیت‌ساز (TGT) کربروس به عنوان این حساب کاربری.

همگام‌سازی گذرواژه‌های تمام حساب‌های کاربری، با استفاده از یک اسکریپت اختیاری.

توجه داشته باشید که این دستور فقط باید روی یک کنترل‌کنندهٔ دامنه اجرا شود (معمولاً شبیه‌ساز PDC).

تنظیم خط‌مشی احراز هویت اختصاص‌یافته برای کاربر.

--policy

نام خط‌مشی احراز هویت برای اختصاص دادن، یا خالی گذاشتن برای حذف آن.

حذف خط‌مشی احراز هویت اختصاص‌یافته از کاربر.

مشاهدهٔ خط‌مشی احراز هویت اختصاص‌یافته برای کاربر.

تنظیم سیلوی احراز هویت اختصاص‌یافته برای کاربر.

--silo

نام سیلوی احراز هویت برای اختصاص دادن، یا خالی گذاشتن برای حذف آن.

حذف سیلوی احراز هویت اختصاص‌یافته از کاربر.

مشاهدهٔ سیلوی احراز هویت اختصاص‌یافته برای کاربر.

مدیریت پیوندهای اطلاعات کاربری کلید (Key Credential Links) برای یک کاربر.

این می‌تواند ویژگی‌های msDS-KeyCredentialLink را مقداردهی، توصیف یا حذف کند.

افزودن یک key-credential-link که یک ویژگی پیوندی حاوی یک کلید عمومی در یک فیلد باینری است.

آرگومان دوم نام فایلی است که باید به یک کلید RSA با اندازهٔ ۲۰۴۸ بیت (یا گواهی حاوی آن کلید) در قالب PEM یا DER اشاره کند. به‌طور پیش‌فرض قالب کدگذاری به‌صورت خودکار تشخیص داده می‌شود، اما می‌توانید با گزینهٔ --encoding آن را مشخص کنید. انواع دیگر کلید عمومی پشتیبانی نمی‌شوند، اگرچه گزینهٔ --force می‌تواند برای افزودن کلید غیر ۲۰۴۸ بیتی استفاده شود.

--link-target=DN

پیوند به این DN (پیش‌فرض: DN کاربر)

--encoding=ENCODING

قالب کلید، یکی از مقادیر pem، der، یا auto. مقدار پیش‌فرض auto است که در بیشتر شرایط قالب صحیح را به‌درستی تشخیص می‌دهد.

--force

ادامهٔ عملیات حتی اگر ناموفق به نظر برسد

حذف یک key-credential-link.

پیوند مورد نظر برای حذف می‌تواند به چندین روش انتخاب شود. گزینهٔ --all تمام پیوندهای اطلاعات کاربری کلید را برای کاربر حذف می‌کند (اغلب تنها یک مورد وجود دارد). گزینهٔ --link-target یک پیوند اطلاعات کاربری کلید را بر اساس DN هدف پیوند انتخاب می‌کند. گزینهٔ --fingerprint پیوندی را برای حذف بر اساس اثر انگشت کلید انتخاب می‌کند. این اثر انگشت مقدار SHA256 داده‌های کلید کدگذاری‌شده با DER است که به‌صورت جفت‌های هگزادسیمال جداشده با دونقطه بیان می‌شود. برای دریافت فهرستی از پیوندها و اثر انگشت آن‌ها، بخش user keytrust view را ببینید.

اگر بیش از یکی از گزینه‌های --link-target، --fingerprint و --all استفاده شوند، پیوندهایی که با هر یک از آن‌ها مطابقت داشته باشند حذف خواهند شد.

گزینهٔ --dry-run از حذف پیوندها جلوگیری کرده و در عوض نشان می‌دهد که در صورت حذف آن چه اتفاقی می‌افتاد.

--link-target=DN

حذف این پیوند اطلاعات کاربری کلید (یک DN)

--fingerprint=HH:HH:..

حذف پیوند اطلاعات کاربری کلید با این اثر انگشت کلید

--all

حذف تمام پیوندهای اطلاعات کاربری کلید

-n, --dry-run

هیچ کاری انجام ندهد و فقط آنچه رخ خواهد داد را چاپ کند

مشاهدهٔ پیوندهای اطلاعات کاربری کلید یک کاربر. این گزینه می‌تواند برای یافتن اثر انگشت و DN هدف یک پیوند استفاده شود. گزینهٔ --verbose اطلاعات بیشتر و جزئیات دقیق‌تری را در بر می‌گیرد.

-h, --help

نمایش این پیام راهنما و خروج

-v, --verbose

نمایش با جزئیات کامل

subject_name private_key_filename output_filename [options]"

تولید یک درخواست امضای گواهی (CSR) با کدگذاری PEM برای یک کاربر.

--private-key-encoding

مشخص می‌کند که کلید خصوصی از چه کدگذاری استفاده می‌کند. مقدار پیش‌فرض 'auto' است.

--private-key-pass

ارائهٔ گذرواژه برای رمزگشایی کلید خصوصی.

پیوستن و همگام‌سازی یک دامنهٔ دوردست AD با سرور محلی. لطفاً توجه داشته باشید که samba-tool vampire منسوخ شده است؛ لطفاً به‌جای آن از samba-tool domain join استفاده کنید.

ایجاد بازنمایی‌های گرافیکی از وضعیت شبکهٔ سامبا. برای درک آنچه در یک گراف همانندسازی رخ می‌دهد، گاهی استفاده از بصری‌سازی‌ها مفید است.

دو دستور فرعی، دو حالت گرافیکی و (تقریباً) دو حالت عملکردی در رابطه با محل مرجعیت وجود دارد.

samba-tool visualize ntdsconn

بررسی اتصالات NTDS.

samba-tool visualize reps

بررسی اشیای repsTo و repsFrom.

samba-tool visualize uptodateness

بررسی تأخیر همانندسازی طبق آنچه توسط بردارهای به‌روز بودن نشان داده می‌شود.

--distance

فاصله‌های میان DCها در یک ماتریس در ترمینال نمایش داده می‌شوند.

--dot

تولید خروجی dot از Graphviz (برای حالت‌های ntdsconn و reps). هنگام مشاهده با استفاده از dot یا xdot، شبکه را به‌صورت یک گراف با DCها به‌عنوان رأس‌ها و اتصالات به‌عنوان یال‌ها نشان می‌دهد. انواع خاصی از یال‌های تحلیل‌رفته با رنگ‌ها یا سبک‌های خطوط متفاوتی نمایش داده می‌شوند.

--xdot

تولید خروجی dot از Graphviz مشابه [--dot] و تلاش برای مشاهدهٔ فوری آن با استفاده از /usr/bin/xdot.

-r

معمولاً samba-tool با یک پایگاه داده ارتباط برقرار می‌کند؛ با گزینهٔ [-r] تلاش می‌شود تا با تمام DCهای شناخته‌شده برای پایگاه‌دادهٔ اول تماس گرفته شود. این کار برای samba-tool visualize uptodateness و برای samba-tool visualize reps ضروری است چرا که اشیای repsFrom/To همانندسازی نمی‌شوند، و می‌تواند مشکلات همانندسازی را در حالت‌های دیگر آشکار سازد.

اطلاعات نحوهٔ استفاده از دستور را ارائه می‌دهد.

این صفحهٔ راهنما برای نسخهٔ 4.24.6 از مجموعه نرم‌افزاری سامبا کامل است.

نرم‌افزار اصلی سامبا و ابزارهای مرتبط با آن توسط اندرو تریجل (Andrew Tridgell) ساخته شده است. سامبا اکنون توسط تیم سامبا (Samba Team) به‌عنوان یک پروژهٔ منبع‌باز مشابه شیوهٔ توسعهٔ هستهٔ لینوکس توسعه داده می‌شود.

08/16/2026 Samba 4.24.6