| NET(8) | ابزارهای مدیریت سیستم | NET(8) |
نام (NAME)
net - ابزار خط فرمان مدیریت سرویسهای شبکه سامبا و ویندوز
خلاصه دستور (SYNOPSIS)
net {<ads|rap|rpc>} [-h|--help] [-d|--debuglevel=DEBUGLEVEL] [--debug-stdout] [--configfile=CONFIGFILE] [--option=name=value] [-l|--log-basename=LOGFILEBASE] [--leak-report] [--leak-report-full] [-R|--name-resolve=NAME-RESOLVE-ORDER] [-O|--socket-options=SOCKETOPTIONS] [-m|--max-protocol=MAXPROTOCOL] [-n|--netbiosname=NETBIOSNAME] [--netbios-scope=SCOPE] [-W|--workgroup=WORKGROUP] [--realm=REALM] [-U|--user=[DOMAIN/]USERNAME[%PASSWORD]] [-N|--no-pass] [--password=STRING] [--pw-nt-hash] [-A|--authentication-file=FILE] [-P|--machine-pass] [--simple-bind-dn=DN] [--use-kerberos=desired|required|off] [--use-krb5-ccache=CCACHE] [--use-winbind-ccache] [--client-protection=sign|encrypt|off] [-V|--version] [-w|--target-workgroup workgroup] [-I|--ipaddress ip-address] [-p|--port port] [--myname] [-S|--server server] [--long] [-v|--verbose] [-f|--force] [--request-timeout seconds] [-t|--timeout seconds] [--dns-ttl TTL-IN-SECONDS] [-i|--stdin] [--witness-registration=REGISTRATION_UUID] [--witness-net-name=REGEX] [--witness-share-name=REGEX] [--witness-ip-address=REGEX] [--witness-client-computer-name=REGEX] [--witness-apply-to-all] [--witness-new-node=NODEID] [--witness-new-ip=IPADDRESS] [--witness-forced-response=JSON]
توضیحات (DESCRIPTION)
این ابزار بخشی از مجموعهٔ samba(7) است.
ابزار net سامبا بهمنظور عملکردی مشابه ابزار net در ویندوز و DOS طراحی شده است. آرگومان اول برای تعیین پروتکل مورد استفاده هنگام اجرای دستوری خاص به کار میرود. پروتکل ADS برای اکتیو دایرکتوری، RAP برای کلاینتهای قدیمی (Win9x/NT3) و RPC میتواند برای NT4 و Windows 2000 استفاده شود. اگر این آرگومان حذف شود، net سعی میکند پروتکل را به صورت خودکار تشخیص دهد. همهٔ دستورها روی تمام پروتکلها در دسترس نیستند.
گزینهها (OPTIONS)
-w|--target-workgroup target-workgroup
-I|--ipaddress ip-address
-p|--port port
-S|--server server
--long
-v|--verbose
-f|--force
--request-timeout 30
-t|--timeout 30
-i|--stdin
-T|--test
-F|--flags FLAGS
-C|--comment COMMENT
--myname MYNAME
-c|--container CONTAINER
-M|--maxusers MAXUSERS
-r|--reboot
--force-full-repl
--single-obj-repl
--clean-old-entries
--db
--lock
-a|--auto
--repair
--acls
--attrs
--timestamps
-X|--exclude DIRECTORY
--destination SERVERNAME
-L|--local
-D|--domain
-N|--ntname NTNAME
--rid RID
--reg-version REG_VERSION
-o|--output FILENAME
--wipe
--precheck PRECHECK_DB_FILENAME
--no-dns-updates
--keep-account
--json
--recursive
--continue
--follow-symlinks
--dns-ttl TTL-IN-SECONDS
--witness-registration=REGISTRATION_UUID
--witness-net-name=REGEX
--witness-share-name=REGEX
--witness-ip-address=REGEX
--witness-client-computer-name=REGEX
--witness-apply-to-all
--witness-new-node=NODEID
--witness-new-ip=IPADDRESS
--witness-forced-response=JSON
-d|--debuglevel=level
هرچه این مقدار بالاتر باشد، جزئیات بیشتری درباره فعالیتهای سرور در فایلهای لاگ ثبت میشود. در سطح 0، فقط خطاهای حیاتی و هشدارهای جدی ثبت میشوند. سطح 1 سطحی منطقی برای کاربری روزمره است - مقدار کمی اطلاعات درباره عملیاتهای انجامشده تولید میکند.
سطوح بالاتر از 1 مقادیر قابل توجهی دادههای لاگ تولید میکنند و فقط باید هنگام بررسی یک مشکل استفاده شوند. سطوح بالاتر از 3 تنها برای استفاده توسعهدهندگان طراحی شدهاند و حجم عظیمی از دادههای لاگ را تولید میکنند که بیشتر آنها بسیار پیچیده و مبهم هستند.
توجه داشته باشید که تعیین این پارامتر در اینجا بر پارامتر log level در فایل /etc/samba/smb.conf اولویت دارد.
--debug-stdout
--configfile=<configuration file>
--option=<name>=<value>
-l|--log-basename=logdirectory
--leak-report
--leak-report-full
-V|--version
-R|--name-resolve=NAME-RESOLVE-ORDER
گزینهها عبارتند از: "lmhosts" و "host" و "wins" و "bcast". آنها باعث میشوند نامها به صورت زیر حل شوند:
ترتیب پیشفرض lmhosts, host, wins, bcast است. بدون این پارامتر یا هر ورودی در پارامتر name resolve order از فایل /etc/samba/smb.conf، روشهای تفکیک نام با این ترتیب امتحان خواهند شد.
-O|--socket-options=SOCKETOPTIONS
-m|--max-protocol=MAXPROTOCOL
توجه داشته باشید که تعیین این پارامتر در اینجا بر پارامتر client max protocol در فایل /etc/samba/smb.conf اولویت دارد.
-n|--netbiosname=NETBIOSNAME
--netbios-scope=SCOPE
-W|--workgroup=WORKGROUP
توجه داشته باشید که تعیین این پارامتر در اینجا بر پارامتر workgroup در فایل /etc/samba/smb.conf اولویت دارد.
-r|--realm=REALM
توجه داشته باشید که تعیین این پارامتر در اینجا بر پارامتر realm در فایل /etc/samba/smb.conf اولویت دارد.
-U|--user=[DOMAIN\]USERNAME[%PASSWORD]
اگر %PASSWORD مشخص نشود، از کاربر درخواست خواهد شد. کلاینت ابتدا متغیر محیطی USER (که مجاز است شامل گذرواژه جداشده با % نیز باشد)، سپس متغیر LOGNAME (که مجاز به داشتن گذرواژه نیست) را بررسی میکند و در صورت وجود هر یک، مقدار آن استفاده میشود. اگر این متغیرهای محیطی یافت نشوند، ممکن است از نام کاربری موجود در کش اعتبارسنجی Kerberos استفاده شود.
گزینه سوم استفاده از یک فایل اعتبارسنجی است که شامل متن ساده نام کاربری و گذرواژه است. این گزینه عمدتاً برای اسکریپتهایی فراهم شده که در آنها مدیر مایل نیست اطلاعات کاربری را در خط فرمان یا از طریق متغیرهای محیطی ارسال کند. اگر از این روش استفاده میشود، مطمئن شوید که مجوزهای روی فایل، دسترسی کاربران غیرمجاز را محدود میکند. برای جزئیات بیشتر به -A مراجعه کنید.
در مورد گنجاندن گذرواژهها در اسکریپتها یا ارسال مقادیر فراهمشده توسط کاربر در خط فرمان محتاط باشید. از نظر امنیتی بهتر است اجازه دهید ابزار کلاینت سامبا در صورت نیاز گذرواژه را درخواست کند، یا گذرواژه را یکبار با kinit به دست آورید.
اگرچه سامبا تلاش میکند گذرواژه را از عنوان فرایند (همانطور که در ps دیده میشود) پاک کند، این کار پس از راهاندازی است و بنابراین در معرض رقابت (race) قرار دارد.
-N|--no-pass
مگر اینکه گذرواژهای در خط فرمان مشخص شده باشد یا این پارامتر تعیین گردد، کلاینت درخواست گذرواژه خواهد کرد.
اگر گذرواژهای در خط فرمان مشخص شود و این گزینه نیز تعریف شده باشد، گذرواژه روی خط فرمان بدون اعلان نادیده گرفته میشود و هیچ گذرواژهای استفاده نخواهد شد.
--password
در مورد گنجاندن گذرواژهها در اسکریپتها یا ارسال مقادیر فراهمشده توسط کاربر در خط فرمان محتاط باشید. از نظر امنیتی بهتر است اجازه دهید ابزار کلاینت سامبا در صورت نیاز گذرواژه را درخواست کند، یا گذرواژه را یکبار با kinit به دست آورید.
اگر --password مشخص نشود، این ابزار متغیر محیطی PASSWD و سپس PASSWD_FD را که انتظار میرود حاوی یک شماره توصیفگر فایل (FD) باز باشد بررسی خواهد کرد.
در نهایت متغیر PASSWD_FILE (شامل مسیر فایلی که باید باز شود) را بررسی میکند. این فایل باید فقط حاوی گذرواژه باشد. اطمینان حاصل کنید که مجوزهای روی فایل دسترسی کاربران غیرمجاز را محدود میکند!
اگرچه سامبا تلاش میکند گذرواژه را از عنوان فرایند (همانطور که در ps دیده میشود) پاک کند، این کار پس از راهاندازی است و بنابراین در معرض رقابت قرار دارد.
--pw-nt-hash
-A|--authentication-file=filename
username = <value> password = <value> domain = <value>
اطمینان حاصل کنید که مجوزهای روی فایل دسترسی کاربران غیرمجاز را محدود میکند!
-P|--machine-pass
--simple-bind-dn=DN
--use-kerberos=desired|required|off
توجه داشته باشید که تعیین این پارامتر در اینجا بر پارامتر client use kerberos در فایل /etc/samba/smb.conf اولویت دارد.
--use-krb5-ccache=CCACHE
این گزینه --use-kerberos=required را اعمال خواهد کرد.
--use-winbind-ccache
--client-protection=sign|encrypt|off
توجه داشته باشید که تعیین این پارامتر در اینجا بر پارامتر client protection در فایل /etc/samba/smb.conf اولویت دارد.
در صورتی که به کنترل دقیقتری نیاز دارید میتوانید از این موارد استفاده کنید: --option=clientsmbencrypt=OPTION، --option=clientipcsigning=OPTION، --option=clientsigning=OPTION.
دستورها (COMMANDS)
CHANGESECRETPW
این دستور اجازه میدهد گذرواژه حساب ماشین سامبا از یک برنامه خارجی روی یک گذرواژه حساب ماشین که قبلاً در Active Directory ذخیره شده است تنظیم شود. از این دستور استفاده نکنید مگر اینکه دقیقاً بدانید چه کار میکنید. استفاده از این دستور مستلزم این است که فلگ اجبار (-f) نیز استفاده شود. هیچ اعلان فرمانی وجود نخواهد داشت. هر اطلاعاتی که به stdin لولهکشی (pipe) شود، چه با تایپ در خط فرمان یا روشهای دیگر، به عنوان گذرواژه تحتاللفظی ماشین ذخیره خواهد شد. بدون دقت و توجه از این دستور استفاده نکنید زیرا یک گذرواژه مشروع ماشین را بدون هشدار بازنویسی خواهد کرد. به شما هشدار داده شد.
TIME
دستور NET TIME به شما اجازه میدهد زمان را روی یک سرور راه دور مشاهده کنید یا زمان روی سرور محلی را با زمان روی سرور راه دور همگامسازی نمایید.
TIME
بدون هیچ گزینهای، دستور NET TIME زمان روی سرور راه دور را نمایش میدهد. سرور راه دور باید با گزینه -S مشخص شود.
TIME SYSTEM
زمان روی سرور راه دور را در قالبی آماده برای /bin/date نمایش میدهد. سرور راه دور باید با گزینه -S مشخص شود.
TIME SET
تلاش میکند تاریخ و زمان سرور محلی را با استفاده از /bin/date روی مقدار سرور راه دور تنظیم کند. سرور راه دور باید با گزینه -S مشخص شود.
TIME ZONE
منطقه زمانی را بر حسب ساعت نسبت به GMT در سرور راه دور نمایش میدهد. سرور راه دور باید با گزینه -S مشخص شود.
[RPC|ADS] JOIN [TYPE] [--no-dns-updates] [-U username[%password]] [dnshostname=FQDN] [createupn=UPN] [createcomputer=OU] [machinepass=PASS] [osName=string osVer=string] [options]
پیوستن به یک دامنه. اگر حساب از قبل روی سرور وجود داشته باشد و [TYPE] برابر MEMBER باشد، ماشین تلاش میکند به طور خودکار ملحق شود. (با فرض اینکه ماشین در server manager ایجاد شده باشد) در غیر این صورت، برای یک گذرواژه درخواست خواهد شد و ممکن است حساب جدیدی ایجاد گردد.
مقدار [TYPE] میتواند PDC، BDC یا MEMBER باشد تا نوع سرور در حال پیوستن به دامنه را مشخص کند.
مقدار [FQDN] (فقط در ADS) صفت dnsHostName را در حین پیوستن تنظیم میکند. قالب پیشفرض netbiosname.dnsdomain است.
مقدار [UPN] (فقط در ADS) صفت principalname را در حین پیوستن تنظیم میکند. قالب پیشفرض host/netbiosname@REALM است.
مقدار [OU] (فقط در ADS) از پیش ایجاد کردن حساب رایانه در یک واحد سازمانی (OU) خاص. رشته OU از بالا به پایین بدون RDN خوانده میشود و با یک '/' جدا میگردد. لطفاً توجه داشته باشید که '\' هم توسط شل و هم توسط ldap برای گریز (escape) استفاده میشود، بنابراین ممکن است لازم باشد دو یا چهار بار تکرار شود تا عبور کند، و به عنوان جداکننده استفاده نمیشود.
مقدار [PASS] (فقط در ADS) تنظیم یک گذرواژه خاص روی حساب رایانهای که با پیوستن ایجاد میشود.
مقدار [osName=string osVer=String] (فقط در ADS) تنظیم صفت operatingSystem و operatingSystemVersion در حین پیوستن. هر دو پارامتر باید مشخص شوند تا اثرگذار باشند.
[RPC] OLDJOIN [options]
پیوستن به یک دامنه. از گزینه OLDJOIN برای پیوستن به دامنه با استفاده از سبک قدیمی پیوستن به دامنه استفاده کنید - ابتدا باید یک حساب اعتماد در server manager ایجاد کنید.
[RPC|ADS] USER
[RPC|ADS] USER
فهرست کردن تمام کاربران.
[RPC|ADS] USER DELETE target
حذف کاربر مشخصشده.
[RPC|ADS] USER INFO target
فهرست کردن گروههای دامنهٔ کاربر مشخصشده.
[RPC|ADS] USER RENAME oldname newname
تغییر نام کاربر مشخصشده.
[RPC|ADS] USER ADD name [password] [-F user flags] [-C comment]
افزودن کاربر مشخصشده.
[RPC|ADS] GROUP
[RPC|ADS] GROUP [misc options] [targets]
فهرست کردن گروههای کاربری.
[RPC|ADS] GROUP DELETE name [misc. options]
حذف گروه مشخصشده.
[RPC|ADS] GROUP ADD name [-C comment]
ایجاد گروه مشخصشده.
[ADS] LOOKUP
جستجوی نزدیکترین کنترلکنندهٔ دامنه در دامنهٔ ما و بازیابی اطلاعات سرور دربارهٔ آن.
[RAP|RPC] SHARE
[RAP|RPC] SHARE [misc. options] [targets]
شمارش و فهرست کردن تمام منابع به اشتراک گذاشتهشده (اشتراکهای شبکه) در سرور مقصد.
[RAP|RPC] SHARE ADD name=serverpath [-C comment] [-M maxusers] [targets]
افزودن یک اشتراک از یک سرور (فعال کردن اشتراکگذاری). مقدار Maxusers تعداد کاربرانی را که میتوانند به طور همزمان به این اشتراک متصل شوند مشخص میکند.
SHARE DELETE sharename
حذف اشتراک مشخصشده.
[RPC|RAP] FILE
[RPC|RAP] FILE
فهرست کردن تمام فایلهای باز روی سرور راه دور.
[RPC|RAP] FILE CLOSE fileid
بستن فایل با fileid مشخصشده روی سرور راه دور.
[RPC|RAP] FILE INFO fileid
چاپ اطلاعات دربارهٔ fileid مشخصشده. موارد فهرستشده در حال حاضر عبارتند از: file-id، نام کاربری، قفلها، مسیر، مجوزها.
[RAP|RPC] FILE USER user
فهرست کردن فایلهای بازشده توسط user مشخصشده. لطفاً توجه داشته باشید که net rap file user در برابر سرورهای سامبا کار نمیکند.
SESSION
RAP SESSION
بدون هیچ گزینه دیگری، SESSION تمام نشستهای فعال SMB/CIFS را روی سرور مقصد فهرست میکند.
RAP SESSION DELETE|CLOSE CLIENT_NAME
بستن نشستهای مشخصشده.
RAP SESSION INFO CLIENT_NAME
ارائه یک فهرست با تمام فایلهای باز در نشست مشخصشده..SS "RAP SERVER DOMAIN"
فهرست کردن تمام سرورها در دامنه یا گروه کاری مشخصشده. پیشفرض دامنه محلی است.
RAP DOMAIN
فهرست کردن تمام دامنهها و گروههای کاری قابل مشاهده در شبکه فعلی.
RAP PRINTQ
RAP PRINTQ INFO QUEUE_NAME
فهرست کردن صف چاپ مشخصشده و کارهای چاپی روی سرور. اگر QUEUE_NAME حذف شود، تمام صفها فهرست میشوند.
RAP PRINTQ DELETE JOBID
حذف کار چاپ با شناسه مشخصشده.
RAP VALIDATE user [password]
اعتبارسنجی اینکه آیا کاربر مشخصشده میتواند به سرور راه دور وارد شود یا خیر. اگر گذرواژه در خط فرمان مشخص نشود، درخواست خواهد شد.
نکته
در حال حاضر پیادهسازی نشده است.
RAP GROUPMEMBER
RAP GROUPMEMBER LIST GROUP
فهرست کردن تمام اعضای گروه مشخصشده.
RAP GROUPMEMBER DELETE GROUP USER
حذف عضو از گروه.
RAP GROUPMEMBER ADD GROUP USER
افزودن عضو به گروه.
RAP ADMIN command
اجرای command مشخصشده روی سرور راه دور. فقط با سرورهای OS/2 کار میکند.
نکته
در حال حاضر پیادهسازی نشده است.
RAP SERVICE
RAP SERVICE START NAME [arguments...]
شروع سرویس مشخصشده روی سرور راه دور. هنوز پیادهسازی نشده است.
نکته
در حال حاضر پیادهسازی نشده است.
RAP SERVICE STOP
توقف سرویس مشخصشده روی سرور راه دور.
نکته
در حال حاضر پیادهسازی نشده است.
RAP PASSWORD USER OLDPASS NEWPASS
تغییر گذرواژه USER از OLDPASS به NEWPASS.
LOOKUP
LOOKUP HOST HOSTNAME [TYPE]
جستجوی نشانی IP میزبان دادهشده با نوع مشخصشده (پسوند NetBIOS). نوع به طور پیشفرض 0x20 (ایستگاه کاری) است.
LOOKUP LDAP [DOMAIN]
ارائه نشانی IP سرور LDAP برای DOMAIN مشخصشده. پیشفرض دامنه محلی است.
LOOKUP KDC [REALM]
ارائه نشانی IP سرور KDC برای REALM مشخصشده. پیشفرض قلمرو محلی است.
LOOKUP DC [DOMAIN]
ارائه نشانیهای IP کنترلکنندههای دامنه برای DOMAIN مشخصشده. پیشفرض دامنه محلی است.
LOOKUP MASTER DOMAIN
ارائه نشانی IP مرورگر اصلی برای DOMAIN یا گروه کاری مشخصشده. پیشفرض دامنه محلی است.
LOOKUP NAME [NAME]
جستجوی sid و نوع نام کاربری برای NAME مشخصشده.
LOOKUP SID [SID]
ارائه نام و نوع برای SID مشخصشده.
LOOKUP DSGETDCNAME [NAME] [FLAGS] [SITENAME]
ارائه اطلاعات کنترلکننده دامنه برای NAME دامنه مشخصشده.
CACHE
سامبا از یک رابط حافظه نهان عمومی به نام 'gencache' استفاده میکند. این رابط با استفاده از 'NET CACHE' قابل کنترل است.
تمام پارامترهای مهلت زمانی از پسوندهای زیر پشتیبانی میکنند:
CACHE ADD key data time-out
افزودن کلید+داده مشخصشده به حافظه نهان با مهلت زمانی دادهشده.
CACHE DEL key
حذف کلید از حافظه نهان.
CACHE SET key data time-out
بهروزرسانی دادههای ورودی موجود در حافظه نهان.
CACHE SEARCH PATTERN
جستجو برای الگوی مشخصشده در دادههای حافظه نهان.
CACHE LIST
فهرست کردن تمام موارد فعلی در حافظه نهان.
CACHE FLUSH
حذف تمام موارد فعلی از حافظه نهان.
GETLOCALSID [DOMAIN]
چاپ SID دامنه مشخصشده، یا اگر پارامتر حذف شود، SID سرور محلی.
SETLOCALSID S-1-5-21-x-y-z
تنظیم SID سرور محلی روی SID مشخصشده.
GETDOMAINSID
چاپ SID ماشین محلی و SID دامنه جاری.
SETDOMAINSID
تنظیم SID دامنه جاری.
GROUPMAP
مدیریت نگاشتهای بین SIDهای گروه ویندوز و گروههای یونیکس. گزینههای رایج عبارتند از:
GROUPMAP ADD
افزودن یک ورودی نگاشت گروه جدید:
net groupmap add {rid=int|sid=string} unixgroup=string \
[type={domain|local}] [ntgroup=string] [comment=string]
GROUPMAP DELETE
حذف یک ورودی نگاشت گروه. اگر بیش از یک نام گروه مطابقت داشته باشد، اولین ورودی یافتشده حذف میشود.
net groupmap delete {ntgroup=string|sid=SID}
GROUPMAP MODIFY
بهروزرسانی یک ورودی گروه موجود.
net groupmap modify {ntgroup=string|sid=SID} [unixgroup=string] \
[comment=string] [type={domain|local}]
GROUPMAP LIST
فهرست کردن ورودیهای موجود نگاشت گروه.
net groupmap list [verbose] [ntgroup=string] [sid=SID]
MAXRID
چاپ بالاترین RID در حال حاضر مورد استفاده در سرور محلی (توسط 'passdb backend' فعال).
RPC INFO
چاپ اطلاعات درباره دامنه سرور راه دور، مانند نام دامنه، sid دامنه و تعداد کاربران و گروهها.
[RPC|ADS] TESTJOIN
بررسی اینکه آیا پیوستن به یک دامنه هنوز معتبر است یا خیر.
[RPC|ADS] CHANGETRUSTPW
اجبار به تغییر گذرواژه اعتماد دامنه.
RPC TRUSTDOM
RPC TRUSTDOM ADD DOMAIN
افزودن یک حساب اعتماد بیندامنهای برای DOMAIN. این در واقع یک حساب سامبا به نام DOMAIN$ با فلگ حساب 'I' (حساب اعتماد بیندامنهای) است. این مورد برای کارکرد اعتمادهای ورودی لازم است. این کار سامبا را به یک دامنه معتمد برای دامنه خارجی (اعتمادکننده) تبدیل میکند. کاربران دامنه سامبا در دامنه خارجی در دسترس قرار خواهند گرفت. اگر این دستور در برابر localhost استفاده شود اثری مشابه با smbpasswd -a -i DOMAIN دارد. لطفاً توجه داشته باشید که هر دو دستور انتظار یک حساب یونیکس مناسب را دارند.
RPC TRUSTDOM DEL DOMAIN
حذف حساب اعتماد بیندامنهای برای DOMAIN. اگر در برابر localhost استفاده شود اثری مشابه با smbpasswd -x DOMAIN$ دارد.
RPC TRUSTDOM ESTABLISH DOMAIN
برقراری رابطه اعتماد با یک دامنه معتمد. حساب بیندامنهای باید از قبل در PDC راه دور ایجاد شده باشد. این مورد برای کارکرد اعتمادهای خروجی الزامی است. این کار سامبا را به یک دامنه اعتمادکننده به دامنه خارجی (معتمد) تبدیل میکند. کاربران دامنه خارجی در دامنه ما در دسترس قرار خواهند گرفت. برای اینکه آنها در سیستم شما ظاهر شوند به winbind و یک پیکربندی idmap کارآمد نیاز دارید.
RPC TRUSTDOM REVOKE DOMAIN
فسخ رابطه با دامنه معتمد.
RPC TRUSTDOM LIST
فهرست کردن تمام روابط اعتماد بیندامنهای.
RPC TRUST
RPC TRUST CREATE
ایجاد یک شیء اعتماد با فراخوانی lsaCreateTrustedDomainEx2. این کار را میتوان روی یک سرور منفرد یا روی دو سرور همزمان با امکان استفاده از یک گذرواژه تصادفی اعتماد انجام داد.
گزینهها:
otherserver
otheruser
otherdomainsid
other_netbios_domain
otherdomain
trustpw
مثالها:
ایجاد یک شیء اعتماد روی srv1.dom1.dom برای دامنهٔ dom2
net rpc trust create \
otherdomainsid=S-x-x-xx-xxxxxxxxxx-xxxxxxxxxx-xxxxxxxxx \
other_netbios_domain=dom2 \
otherdomain=dom2.dom \
trustpw=12345678 \
-S srv1.dom1.dom
ایجاد یک رابطه اعتماد بین dom1 و dom2
net rpc trust create \
otherserver=srv2.dom2.test \
otheruser=dom2adm \
-S srv1.dom1.dom
RPC TRUST DELETE
حذف یک شیء اعتماد با فراخوانی lsaDeleteTrustedDomain. این کار را میتوان روی یک سرور منفرد یا روی دو سرور به صورت همزمان انجام داد.
گزینهها:
otherserver
otheruser
otherdomainsid
مثالها:
حذف یک شیء اعتماد روی srv1.dom1.dom برای دامنهٔ dom2
net rpc trust delete \
otherdomainsid=S-x-x-xx-xxxxxxxxxx-xxxxxxxxxx-xxxxxxxxx \
-S srv1.dom1.dom
حذف یک رابطه اعتماد بین dom1 و dom2
net rpc trust delete \
otherserver=srv2.dom2.test \
otheruser=dom2adm \
-S srv1.dom1.dom
RPC RIGHTS
این زیردستور برای مشاهده و مدیریت تخصیصهای حقوق سامبا (که با عنوان امتیازات یا privileges نیز شناخته میشوند) به کار میرود. در حال حاضر سه گزینه در دسترس است: list، grant، و revoke. جزئیات بیشتر درباره مدل امتیازات سامبا و کاربرد آن را میتوان در Samba-HOWTO-Collection یافت.
RPC ABORTSHUTDOWN
لغو خاموشسازی یک سرور راه دور.
RPC SHUTDOWN [-t timeout] [-r] [-f] [-C message]
خاموش کردن سرور راه دور.
-r
-f
-t timeout
-C message
RPC SAMDUMP
چاپ پایگاه داده sam سرور راه دور. شما باید این دستور را در برابر PDC، از یک ماشین سامبا که به عنوان BDC ملحق شده اجرا کنید.
RPC VAMPIRE
برونبری کاربران، نامهای مستعار و گروهها از سرور راه دور به سرور محلی. شما باید این دستور را در برابر PDC، از یک ماشین سامبا که به عنوان BDC ملحق شده اجرا کنید. این دستور vampire را نمیتوان در برابر Active Directory استفاده کرد، فقط در برابر کنترلکننده دامنه NT4 قابل استفاده است.
RPC VAMPIRE KEYTAB
تخلیه پایگاه داده SAM راه دور در یک فایل keytab محلی Kerberos.
RPC VAMPIRE LDIF
تخلیه پایگاه داده SAM راه دور در یک فایل LDIF محلی یا خروجی استاندارد.
RPC GETSID
واکشی SID دامنه و ذخیره آن در secrets.tdb محلی.
ADS GPO
ADS GPO APPLY <USERNAME|MACHINENAME>
اعمال GPOها برای یک نام کاربری یا نام ماشین. یا نام کاربری یا نام ماشین باید به دستور داده شود، نه هر دو.
ADS GPO GETGPO [GPO]
فهرست کردن GPO مشخصشده.
ADS GPO LINKADD [LINKDN] [GPODN]
پیوند دادن یک ظرف (container) به یک GPO. LINKDN ظرف برای پیوند دادن به یک GPO. GPODN شناسهٔ GPO برای پیوند دادن ظرف به آن. شناسههای DN باید به طور مناسب اسکیپ شوند. برای جزئیات RFC 4514 را ببینید.
ADS GPO LINKGET [CONTAINER]
فهرست کردن gPLink یک ظرف.
ADS GPO LIST <USERNAME|MACHINENAME>
فهرست کردن تمام GPOها برای یک نام کاربری یا نام ماشین. یا نام کاربری یا نام ماشین باید به دستور داده شود، نه هر دو.
ADS GPO LISTALL
فهرست کردن تمام GPOها روی یک DC.
ADS GPO REFRESH [USERNAME] [MACHINENAME]
فهرست کردن تمام GPOهای اختصاصیافته به یک حساب و بارگیری آنها. USERNAME کاربر برای نوسازی GPOهای آن. MACHINENAME ماشین برای نوسازی GPOهای آن.
ADS DNS
ADS DNS REGISTER [FQDN [IP [IP.....]]]
افزودن رکورد dns به Active Directory. اگر FQDN وجود نداشته باشد، dns hostname استفاده میشود. اگر IP وجود نداشته باشد، IPهای تمام رابطهای شبکه اضافه میشوند.
ADS DNS UNREGISTER <FQDN>
حذف ورودی dns مربوط به FQDN از Active Directory.
ADS LEAVE [--keep-account]
خروج میزبان راه دور از دامنهای که عضو آن است.
ADS STATUS
چاپ وضعیت حساب ماشینِ ماشین محلی در ADS. اطلاعات اشکالزدایی قابل توجهی را چاپ میکند. با هدف استفاده توسعهدهندگان، کاربران عادی باید از NET ADS TESTJOIN استفاده کنند.
ADS PRINTER
ADS PRINTER INFO [PRINTER] [SERVER]
جستجوی اطلاعات برای PRINTER روی SERVER. نام چاپگر به طور پیشفرض "*"، و نام سرور به طور پیشفرض میزبان محلی است.
ADS PRINTER PUBLISH PRINTER
انتشار چاپگر مشخصشده با استفاده از ADS.
ADS PRINTER REMOVE PRINTER
حذف چاپگر مشخصشده از دایرکتوری ADS.
ADS SEARCH EXPRESSION ATTRIBUTES...
انجام یک جستجوی خام LDAP روی یک سرور ADS و نمایش نتایج. عبارت یک عبارت جستجوی استاندارد LDAP است و صفات فهرستی از فیلدهای LDAP برای نمایش در نتایج هستند.
مثال: net ads search '(objectCategory=group)' sAMAccountName
ADS DN DN (attributes)
انجام یک جستجوی خام LDAP روی یک سرور ADS و نمایش نتایج. شناسهٔ DN یک DN استاندارد LDAP است و صفات فهرستی از فیلدهای LDAP برای نمایش در نتیجه هستند.
مثال: net ads dn 'CN=administrator,CN=Users,DC=my,DC=domain' SAMAccountName
ADS KEYTAB CREATE
از سامبا 4.21.0، فایل keytab همانطور که در sync machine password to keytab مشخص شده ایجاد میشود. فایل keytab تنها زمانی میتواند ایجاد شود که گذرواژه ماشین در secrets.tdb در دسترس باشد، یعنی فقط برای kerberos method = secrets only و kerberos method = secrets and keytab. با مقادیر پیشفرض smb.conf برای kerberos method = secrets only و sync machine password to keytab (پیشفرض خالی است)، keytab اصلاً تولید نمیشود. یک keytab با نام پیشفرض شامل: SPNهای همگامشده از AD، نام حساب $COMPUTER و پرینسیپال host/dns_hostname برای kerberos method = secrets and keytab ایجاد میشود اگر sync machine password to keytab وجود نداشته باشد.
تا نسخه سامبا 4.20، این ورودیها به صورت پیشفرض ایجاد میشدند: نام حساب $COMPUTER، پرینسیپال 'host' و SPNهای همگامشده از AD. مثال زیر چنین keytabای تولید میکند:
sync machine password to keytab = /etc/krb5.keytab:spn_prefixes=host:account_name:sync_spns:sync_kvno:machine_password
هیچ تغییری در حساب رایانهٔ AD ایجاد نمیشود.
(Removed!) ADS KEYTAB ADD (principal | machine | serviceclass | windows SPN)
این دستور دیگر در سامبا 4.21.0 و جدیدتر در دسترس نیست. برای جایگزین به sync machine password to keytab مراجعه کنید.
برای جایگزینی به عنوان مثال فراخوانی
net ads keytab add wurst/brot@REALM
به smb.conf اضافه کنید:
sync machine password to keytab = /path/to/keytab1:spns=wurst/brot@REALM:machine_password
و اجرا کنید:
net ads keytab create
توضیحات اصلی این دستور:
یک ورودی جدید keytab اضافه میکند، ورودی میتواند یکی از موارد زیر باشد:
kerberos principal
machinename
serviceclass
Windows SPN
برخلاف نسخههای قدیمی، هیچ شیء رایانهٔ AD توسط این دستور اصلاح نمیشود. برای حفظ رفتار کلاینتهای قدیمیتر، دستور 'net ads keytab ad_update_ads' در دسترس است.
ADS KEYTAB LIST [keytab]
این دستور محتویات یک keytab را فهرست میکند. اگر هیچ keytabای مشخص نشود، keytab پیشفرض پیکربندیشده توسط KRB5 را نمایش میدهد.
(Removed!) ADS KEYTAB DELETE (principal | machine | serviceclass | windows SPN)
این دستور دیگر در سامبا 4.21.0 و جدیدتر در دسترس نیست. برای جایگزین به sync machine password to keytab مراجعه کنید.
برای جایگزینی به عنوان مثال فراخوانی
net ads keytab delete wurst/brot@REALM
از sync machine password to keytab پرینسیپال "wurst/brot@REALM" را حذف کرده و اجرا کنید:
net ads keytab create
(Removed!) ADS KEYTAB ADD_UPDATE_ADS (principal | machine | serviceclass | windows SPN)
این دستور دیگر در سامبا 4.21.0 و جدیدتر در دسترس نیست. برای جایگزین به sync machine password to keytab مراجعه کنید.
برای جایگزینی به عنوان مثال فراخوانی
net ads keytab add_update_ads wurst/brot@REALM
به smb.conf اضافه کنید:
sync machine password to keytab = /path/to/keytab2:sync_spns:machine_password
و اجرا کنید:
net ads setspn add wurst/brot@REALM net ads keytab create
توضیحات اصلی این دستور:
یک ورودی جدید keytab اضافه میکند (بخش net ads keytab add را ببینید). علاوه بر افزودن ورودیها به فایل keytab، SPNهای ویندوزی متناظر از ورودی ارائهشده به این دستور ایجاد میشوند. این SPN(ها) به شیء حساب رایانهٔ AD مرتبط با ماشین کلاینت اجراکننده این دستور برای انواع ورودیهای زیر اضافه میشوند:
serviceclass
Windows SPN
ADS SETSPN LIST [machine]
فهرست کردن SPNهای ویندوزی ذخیرهشده در شیء رایانهٔ AD ویندوز 'machine'. اگر 'machine' مشخص نشود، حساب رایانهٔ این کلاینت استفاده میشود.
مثال: net ads setspn list --machine-pass
ADS SETSPN ADD [machine] SPN
افزودن SPN ویندوزی مشخصشده به شیء رایانهٔ AD ویندوز 'machine'. اگر 'machine' مشخص نشود، حساب رایانهٔ این کلاینت استفاده میشود.
مثال: net ads setspn add computername host/computername.example.com -U Administrator%Passw0rd
ADS SETSPN DELETE [machine] SPN
حذف SPN ویندوزی مشخصشده از شیء رایانهٔ AD ویندوز 'machine'. اگر 'machine' مشخص نشود، حساب رایانهٔ این کلاینت استفاده میشود.
مثال: net ads setspn delete computername host/computername.example.com -U Administrator%Passw0rd
ADS WORKGROUP
چاپ نام گروه کاری برای قلمرو (realm) کربروس مشخصشده.
ADS ENCTYPES
فهرست کردن، تغییر یا حذف مقدار صفت "msDS-SupportedEncryptionTypes" یک حساب در AD.
این صفت امکان کنترل اینکه کدام انواع رمزنگاری Kerberos برای تولید بلیتهای اولیه و سرویس استفاده شوند را فراهم میکند. این مقدار شامل یک ماسک بیتی عدد صحیح با مقادیر زیر است:
0x00000001 DES-CBC-CRC
0x00000002 DES-CBC-MD5
0x00000004 RC4-HMAC
0x00000008 AES128-CTS-HMAC-SHA1-96
0x00000010 AES256-CTS-HMAC-SHA1-96
0x00000020 AES256-CTS-HMAC-SHA1-96-SK
0x00080000 RESOURCE-SID-COMPRESSION-DISABLED
ADS ENCTYPES LIST <ACCOUNTNAME>
فهرست کردن مقدار صفت "msDS-SupportedEncryptionTypes" یک حساب مشخص. حساب رایانه در انتها به '$' نیاز دارد.
مثال: net ads enctypes list Computername$ --machine-pass
ADS ENCTYPES SET <ACCOUNTNAME> [enctypes]
تنظیم مقدار صفت "msDS-SupportedEncryptionTypes" شیء LDAP مربوط به ACCOUNTNAME روی یک مقدار دادهشده. اگر مقدار حذف شود، روی 28 تنظیم میشود که انواع رمزنگاری RC4-HMAC، AES128-CTS-HMAC-SHA1-96 و AES256-CTS-HMAC-SHA1-96 را فعال میکند.
مثال: net ads enctypes set Computername$ 24 --machine-pass
ADS ENCTYPES DELETE <ACCOUNTNAME>
حذف صفت "msDS-SupportedEncryptionTypes" از شیء LDAP مربوط به ACCOUNTNAME.
مثال: net ads enctypes delete Computername$ --machine-pass
ADS KERBEROS
صدور عملیاتهای Kerberos در برابر یک KDC اکتیو دایرکتوری.
ADS KERBEROS KINIT
صدور یک درخواست kinit برای کاربر مشخصشده. روشهای زیر میتوانند برای تعیین محل ذخیرهٔ بلیت اعطای بلیت (TGT) استفاده شوند (به ترتیب اولویت):
مثالها:
استفاده از کش مبتنی بر فایل (FILE:/tmp/krb5cache)
net ads kerberos kinit -P --use-krb5-ccache=/tmp/krb5cache
استفاده از کش حافظه (MEMORY:net) برای تأیید احراز هویت
net ads kerberos kinit -P --use-krb5-ccache=MEMORY:net
ADS KERBEROS RENEW
تمدید یک بلیت اعطای بلیت (TGT) که قبلاً دریافت شده است.
مثال: net ads kerberos renew
ADS KERBEROS PAC
درخواست یک Kerberos PAC هنگام احراز هویت در یک KDC اکتیو دایرکتوری.
دستورهای زیر ارائه شدهاند:
تمام دستورها امکان تعریف یک پرینسیپال جعل هویت را برای انجام عملیات Kerberos Service for User (S4U2SELF) از طریق گزینهٔ impersonate=STRING فراهم میکنند. پرینسیپال جعل هویت میتواند چندین قالب مختلف داشته باشد:
این قالب پیشفرض است.
سرویس Kerberos Service for User (S4U2SELF) همچنین از پرینسیپالهای سازمانی (Enterprise Principals) پشتیبانی میکند.
پرینسیپال سازمانی با استفاده از پسوند upn تعریفشده.
پرینسیپال سازمانی با نام دامنه NetBIOS. این قالب در حال حاضر توسط Samba AD پشتیبانی نمیشود.
بهطور پیشفرض net یک بلیت سرویس برای سرویس محلی ماشین ملحقشده درخواست میکند. یک سرویس دیگر میتواند از طریق local_service=STRING تعریف شود.
ADS KERBEROS PAC DUMP [impersonate=string] [local_service=string] [pac_buffer_type=int]
درخواست یک Kerberos PAC هنگام احراز هویت در یک KDC اکتیو دایرکتوری. مقدار PAC در stdout چاپ خواهد شد.
هنگامی که هیچ pac_buffer خاصی انتخاب نشود، تمام بافرها چاپ خواهند شد. امکان انتخاب یک بافر خاص از طریق pac_buffer_type=INT از این فهرست وجود دارد:
مثال: net ads kerberos pac dump -P impersonate=anyuser@MY.REALM.COM
ADS KERBEROS PAC SAVE [impersonate=string] [local_service=string] [filename=string]
درخواست یک Kerberos PAC هنگام احراز هویت در یک KDC اکتیو دایرکتوری. مقدار PAC در یک فایل ذخیره خواهد شد.
نام فایل برای ذخیره PAC میتواند از طریق گزینهٔ filename=STRING تنظیم شود.
مثال: net ads kerberos pac save -U user%password filename=/tmp/pacstore
SAM CREATEBUILTINGROUP <NAME>
ایجاد (مجدد) یک گروه BUILTIN. تنها مجموعهٔ شناختهشدهای از گروههای BUILTIN را میتوان با این دستور ایجاد کرد. این فهرست نام گروههای در حال حاضر شناختهشده است: Administrators، Users، Guests، Power Users، Account Operators، Server Operators، Print Operators، Backup Operators، Replicator، RAS Servers، Pre-Windows 2000 compatible Access. این دستور نیازمند یک Winbindd در حال اجرا با تخصیص idmap به درستی پیکربندیشده است. شناسهٔ gid گروه از محدوده winbindd تخصیص داده خواهد شد.
SAM CREATELOCALGROUP <NAME>
ایجاد یک گروه LOCAL (همچنین با نام مستعار یا Alias شناخته میشود). این دستور نیازمند یک Winbindd در حال اجرا با تخصیص idmap به درستی پیکربندیشده است. شناسهٔ gid گروه از محدوده winbindd تخصیص داده خواهد شد.
SAM DELETELOCALGROUP <NAME>
حذف یک گروه LOCAL موجود (همچنین با نام مستعار یا Alias شناخته میشود).
SAM MAPUNIXGROUP <NAME>
نگاشت یک گروه یونیکس موجود و تبدیل آن به یک گروه دامنه، گروه دامنه همان نام را خواهد داشت.
SAM UNMAPUNIXGROUP <NAME>
حذف یک ورودی نگاشت گروه موجود.
SAM ADDMEM <GROUP> <MEMBER>
افزودن یک عضو به یک گروه محلی. گروه فقط میتواند با نام مشخص شود، عضو میتواند با نام یا SID مشخص گردد.
SAM DELMEM <GROUP> <MEMBER>
حذف یک عضو از یک گروه محلی. گروه و عضو باید با نام مشخص شوند.
SAM LISTMEM <GROUP>
فهرست کردن اعضای گروه محلی. گروه باید با نام مشخص شود.
SAM LIST <users|groups|localgroups|builtin|workstations> [verbose]
فهرست کردن مجموعه مشخصشده از حسابها بر اساس نام. اگر verbose مشخص شود، rid و توضیحات نیز برای هر حساب ارائه میشود.
SAM RIGHTS LIST
فهرست کردن تمام امتیازات موجود.
SAM RIGHTS GRANT <NAME> <PRIVILEGE>
اعطای یک یا چند امتیاز به یک کاربر.
SAM RIGHTS REVOKE <NAME> <PRIVILEGE>
لغو یک یا چند امتیاز از یک کاربر.
SAM SHOW <NAME>
نمایش کامل DOMAIN\\NAME، شناسهٔ SID و نوع برای حساب متناظر.
SAM SET HOMEDIR <NAME> <DIRECTORY>
تنظیم پوشه خانگی برای یک حساب کاربری.
SAM SET PROFILEPATH <NAME> <PATH>
تنظیم مسیر نمایه برای یک حساب کاربری.
SAM SET COMMENT <NAME> <COMMENT>
تنظیم توضیح برای یک حساب کاربری یا گروهی.
SAM SET FULLNAME <NAME> <FULL NAME>
تنظیم نام کامل برای یک حساب کاربری.
SAM SET LOGONSCRIPT <NAME> <SCRIPT>
تنظیم اسکریپت ورود به سیستم برای یک حساب کاربری.
SAM SET HOMEDRIVE <NAME> <DRIVE>
تنظیم درایو خانگی برای یک حساب کاربری.
SAM SET WORKSTATIONS <NAME> <WORKSTATIONS>
تنظیم ایستگاههای کاری مجاز برای ورود یک حساب کاربری.
SAM SET DISABLE <NAME>
تنظیم پرچم "غیرفعال" برای یک حساب کاربری.
SAM SET PWNOTREQ <NAME>
تنظیم پرچم "عدم نیاز به گذرواژه" برای یک حساب کاربری.
SAM SET AUTOLOCK <NAME>
تنظیم پرچم "قفل خودکار" برای یک حساب کاربری.
SAM SET PWNOEXP <NAME>
تنظیم پرچم "عدم انقضای گذرواژه" برای یک حساب کاربری.
SAM SET PWDMUSTCHANGENOW <NAME> [yes|no]
تنظیم یا حذف پرچم "گذرواژه باید فوراً تغییر کند" برای یک حساب کاربری.
SAM POLICY LIST
فهرست کردن خطمشیهای حساب موجود.
SAM POLICY SHOW <account policy>
نمایش مقدار خطمشی حساب.
SAM POLICY SET <account policy> <value>
تنظیم یک مقدار برای خطمشی حساب. مقادیر معتبر میتوانند عبارت باشند از: "forever"، "never"، "off"، یا یک عدد.
SAM PROVISION
فقط در صورتی در دسترس است که ldapsam:editposix تنظیم شده باشد و winbindd در حال اجرا باشد. درخت ldap را با حسابهای پایه (Administrator) و گروهها (Domain Users، Domain Admins، Domain Guests) روی درخت ldap به درستی پر میکند.
IDMAP DUMP <local tdb file name>
نگاشتهای موجود در فایل tdb محلی مشخصشده را تخلیه میکند. این دستور برای تخلیهٔ فقط نگاشتهای تولیدشده توسط بکاند idmap_tdb مفید است.
IDMAP RESTORE [input file]
بازیابی نگاشتها از فایل مشخصشده یا ورودی استاندارد (stdin).
IDMAP SET SECRET <DOMAIN> <secret>
ذخیره یک رمز برای دامنهٔ مشخصشده، که در درجه اول برای دامنههایی استفاده میشود که از idmap_ldap به عنوان یک بکاند استفاده میکنند. در این حالت از رمز به عنوان گذرواژه برای DN کاربری که برای اتصال به سرور ldap استفاده میشود استفاده میگردد.
IDMAP SET RANGE <RANGE> <SID> [index] [--db=<DB>]
ذخیره نگاشت domain-range برای یک دامنه معین (و اندیس) در پایگاه داده autorid.
IDMAP SET CONFIG <config> [--db=<DB>]
بهروزرسانی ورودی CONFIG در پایگاه داده autorid.
IDMAP GET RANGE <SID> [index] [--db=<DB>]
دریافت محدوده برای یک دامنه و اندیس معین از پایگاه داده autorid.
IDMAP GET RANGES [<SID>] [--db=<DB>]
دریافت محدودهها برای تمام دامنهها یا برای دامنهای که با SID دادهشده مشخص میشود.
IDMAP GET CONFIG [--db=<DB>]
دریافت ورودی CONFIG از پایگاه داده autorid.
IDMAP DELETE MAPPING [-f] [--db=<DB>] <ID>
حذف یک نگاشت sid <-> gid یا sid <-> uid از پایگاه داده IDMAP. نگاشت با <ID> مشخص میشود که ممکن است یک sid: S-x-...، یک gid: "شماره GID" یا یک uid: "شماره UID" باشد. از -f برای حذف یک نگاشت ناقص نامعتبر <ID> -> xx استفاده کنید.
از "smbcontrol all idmap ..." برای اطلاع دادن به نمونههای در حال اجرای smbd استفاده کنید. برای جزئیات به صفحه راهنمای smbcontrol(1) مراجعه کنید.
IDMAP DELETE RANGE [-f] [--db=<TDB>] <RANGE>|(<SID> [<INDEX>])
حذف یک نگاشت محدوده دامنه مشخصشده با 'RANGE' یا "domain SID and INDEX" از پایگاه داده autorid. از -f برای حذف نگاشتهای نامعتبر استفاده کنید.
IDMAP DELETE RANGES [-f] [--db=<TDB>] <SID>
حذف تمام نگاشتهای محدوده دامنه برای یک دامنه مشخصشده با SID. از -f برای حذف نگاشتهای نامعتبر استفاده کنید.
IDMAP CHECK [-v] [-r] [-a] [-T] [-f] [-l] [--db=<DB>]
بررسی و تعمیر پایگاه داده IDMAP. اگر هیچ گزینهای داده نشود، یک بررسی فقطخواندنی از پایگاه داده انجام میشود. در میان موارد دیگر، یک حالت تعمیر تعاملی یا خودکار را میتوان با یکی از گزینههای زیر انتخاب کرد:
-r|--repair
-a|--auto
-v|--verbose
-f|--force
-T|--test
-l|--lock
--db <DB>
Missing reverse mapping:
Invalid mapping:
Missing or invalid HWM:
Invalid record:
USERSHARE
از نسخه 3.0.23، سرور سامبا اکنون از این قابلیت پشتیبانی میکند که کاربران غیرریشه بتوانند اشتراکهای تعریفشده توسط کاربر را با استفاده از دستورهای "net usershare" اضافه و صادر کنند.
برای راهاندازی این مورد، ابتدا /etc/samba/smb.conf خود را با افزودن این خط به بخش [global] تنظیم کنید: usershare path = /usr/local/samba/lib/usershares سپس دایرکتوری /usr/local/samba/lib/usershares را ایجاد کنید، مالک آن را به root تغییر دهید و مالک گروه را روی گروه یونیکسی تنظیم کنید که باید توانایی ایجاد اشتراکهای کاربری را داشته باشد، مثلاً گروهی به نام "serverops". مجوزهای /usr/local/samba/lib/usershares را روی 01770 تنظیم کنید (دسترسی کامل برای مالک و گروه، بدون دسترسی برای دیگران، به علاوه بیت چسبنده (sticky bit) که یعنی یک فایل در آن دایرکتوری تنها توسط مالک فایل میتواند تغییر نام داده یا حذف شود). در نهایت، با افزودن خطی مانند: usershare max shares = 100 به بخش [global] از /etc/samba/smb.conf به smbd بگویید چه تعداد اشتراک کاربری را مجاز میدانید تا ۱۰۰ تعریف اشتراک کاربری مجاز شود. اکنون، اعضای گروه یونیکس "serverops" میتوانند با استفاده از دستورهای زیر اشتراکهای تعریفشده توسط کاربر را در صورت نیاز ایجاد کنند.
دستورهای usershare عبارتند از:
USERSHARE ADD sharename path [comment] [acl] [guest_ok=[y|n]]
افزودن یا جایگزینی یک اشتراک جدید تعریفشده توسط کاربر با نام "sharename".
مقدار "path" مسیر مطلق سیستم را برای صادر شدن مشخص میکند. ممکن است محدودیتهایی روی این اعمال شود، پارامترهای سراسری /etc/samba/smb.conf را ببینید: "usershare owner only"، "usershare prefix allow list"، و "usershare prefix deny list".
پارامتر اختیاری "comment" توضیحی است که هنگام مرور توسط کلاینت روی اشتراک ظاهر میشود.
فیلد اختیاری "acl" مشخص میکند کدام کاربران دسترسی خواندن و نوشتن به کل اشتراک را دارند. توجه داشته باشید که اتصالات مهمان مجاز نیستند مگر اینکه پارامتر /etc/samba/smb.conf به نام "usershare allow guests" تنظیم شده باشد. تعریف acl یک اشتراک تعریفشده توسط کاربر به صورت "user:permission" است، که در آن user یک نام کاربری معتبر در سیستم است و permission میتواند "F"، "R" یا "D" باشد. مقدار "F" به معنای "مجوز کامل"، یعنی دسترسی خواندن و نوشتن است. مقدار "D" مخفف "انکار" (deny) برای یک کاربر است، یعنی جلوگیری از دسترسی این کاربر به این اشتراک. مقدار "R" به معنای "فقطخواندنی"، یعنی فقط اجازه دسترسی خواندن به این اشتراک (بدون ایجاد فایلها یا دایرکتوریهای جدید یا نوشتن در فایلها).
پیشفرض در صورت عدم تعیین "acl" برابر "Everyone:R" است، که یعنی هر کاربر احراز هویتشده دسترسی فقطخواندنی دارد.
پارامتر اختیاری "guest_ok" اثری مشابه با پارامتر همنام خود در /etc/samba/smb.conf دارد، از این نظر که اجازه دسترسی مهمان به این اشتراک تعریفشده توسط کاربر را میدهد. این پارامتر تنها در صورتی مجاز است که پارامتر سراسری "usershare allow guests" در /etc/samba/smb.conf روی true تنظیم شده باشد.
دستور جداگانهای برای تغییر یک اشتراک کاربری موجود وجود ندارد، کافیست از دستور "net usershare add [sharename]" با همان نام اشتراک مورد نظر برای اصلاح استفاده کرده و گزینههای جدید مورد نظرتان را مشخص کنید. دیمن smbd سامبا تغییرات اشتراکهای کاربری را در زمان اتصال متوجه میشود بنابراین فوراً تغییر را میبیند، نیازی به راهاندازی مجدد smbd هنگام افزودن، حذف یا تغییر اشتراک کاربری نیست.
USERSHARE DELETE sharename
حذف اشتراک تعریفشده توسط کاربر با نام آن. دیمن smbd سامبا فوراً متوجه این تغییر میشود، هرچند کاربرانی را که در حال حاضر به اشتراک حذفشده متصل هستند قطع نخواهد کرد.
USERSHARE INFO [--long] [wildcard sharename]
دریافت اطلاعات درباره اشتراکهای کاربری متعلق به کاربر جاری که با الگوی دادهشده مطابقت دارند، یا همه کاربران.
دستور net usershare info به تنهایی اطلاعات مربوط به اشتراکهای کاربری ایجادشده توسط کاربر جاری را نمایش میدهد، یا آنها را به نامهای اشتراکی که با الگوی wildcard دادهشده مطابقت دارند محدود میکند ('*' یک یا چند نویسه را مطابقت میدهد، '?' فقط یک نویسه را مطابقت میدهد). اگر گزینهٔ '--long' نیز داده شود، اطلاعات اشتراکهای کاربری ایجادشده توسط سایر کاربران را چاپ میکند.
اطلاعات ارائهشده درباره یک اشتراک شبیه به این است: [foobar] path=/home/jeremy comment=testme usershare_acl=Everyone:F guest_ok=n و فهرستی از تنظیمات فعلی اشتراک تعریفشده توسط کاربر است که میتواند توسط دستور "net usershare add" اصلاح شود.
USERSHARE LIST [--long] wildcard sharename
فهرست کردن تمام اشتراکهای تعریفشده توسط کاربر متعلق به کاربر جاری که با الگوی دادهشده مطابقت دارند، یا همه کاربران.
دستور net usershare list به تنهایی نامهای اشتراکهای کاربری ایجادشده توسط کاربر جاری را فهرست میکند، یا فهرست را به نامهای اشتراکی که با الگوی wildcard دادهشده مطابقت دارند محدود میکند ('*' یک یا چند نویسه را مطابقت میدهد، '?' فقط یک نویسه را مطابقت میدهد). اگر گزینهٔ '--long' نیز داده شود، نام اشتراکهای کاربری ایجادشده توسط سایر کاربران را نیز شامل میشود.
[RPC] CONF
از نسخه 3.2.0، یک سرور سامبا میتواند با دادههای ذخیرهشده در رجیستری پیکربندی شود. این دادههای پیکربندی را میتوان با دستورهای جدید "net conf" ویرایش کرد. همچنین امکان پیکربندی یک سرور سامبای راه دور با فعال کردن حالت RPC conf و تعیین نشانی سرور راه دور وجود دارد.
استقرار این دادههای پیکربندی را میتوان در دو سطح از فایل /etc/samba/smb.conf فعال کرد: تعاریف اشتراک از رجیستری با تنظیم registry shares روی “yes” در بخش [global] فعال میشوند و گزینههای پیکربندی سراسری با تنظیم include = registry در بخش [global] برای یک پیکربندی ترکیبی یا با تنظیم config backend = registry در بخش [global] برای یک پیکربندی صرفاً رجیستری فعال میشوند. برای جزئیات به صفحه راهنمای smb.conf(5) مراجعه کنید.
دستورهای conf عبارتند از:
[RPC] CONF LIST
چاپ دادههای پیکربندی ذخیرهشده در رجیستری در قالبی مشابه smb.conf در خروجی استاندارد.
[RPC] CONF IMPORT [--test|-T] filename [section]
این دستور پیکربندی را از یک فایل با فرمت smb.conf وارد میکند. اگر بخشی در فایل ورودی در رجیستری وجود داشته باشد، محتوای آن جایگزین میشود. بخشهایی از پیکربندی رجیستری که همتایی در فایل ورودی ندارند تحت تأثیر قرار نمیگیرند. اگر میخواهید آنها را حذف کنید، باید از دستورهای "net conf drop" یا "net conf delshare" استفاده کنید. به صورت اختیاری، میتوان یک بخش را برای محدود کردن اثر دستور import به آن بخش خاص مشخص کرد. یک حالت آزمایشی با تعیین پارامتر "-T" در خط فرمان فعال میشود. در حالت آزمایشی، هیچ تغییری در رجیستری ایجاد نمیشود و پیکربندی حاصل در عوض در خروجی استاندارد چاپ میشود.
[RPC] CONF LISTSHARES
فهرست کردن نامهای اشتراکهای تعریفشده در رجیستری.
[RPC] CONF DROP
حذف کامل دادههای پیکربندی از رجیستری.
[RPC] CONF SHOWSHARE sharename
نمایش تعریف اشتراک یا بخش مشخصشده. تعیین "global" به عنوان sharename برای بازیابی گزینههای پیکربندی سراسری از رجیستری معتبر است.
[RPC] CONF ADDSHARE sharename path [writeable={y|N} [guest_ok={y|N} [comment]]]
ایجاد یک تعریف اشتراک جدید در رجیستری. نام اشتراک و مسیر باید ارائه شوند. نام اشتراک نباید not برابر "global" باشد. به صورت اختیاری، مقادیر گزینههای بسیار رایج "writeable"، "guest ok" و یک "comment" میتوانند مشخص شوند. همین نتیجه را میتوان با توالی از دستورهای "net conf setparm" به دست آورد.
[RPC] CONF DELSHARE sharename
حذف یک تعریف اشتراک از رجیستری.
[RPC] CONF SETPARM section parameter value
ذخیره یک پارامتر در رجیستری. بخش میتواند global یا یک نام اشتراک باشد. اگر بخش هنوز وجود نداشته باشد ایجاد میشود.
[RPC] CONF GETPARM section parameter
نمایش یک پارامتر ذخیرهشده در رجیستری.
[RPC] CONF DELPARM section parameter
حذف یک پارامتر ذخیرهشده در رجیستری.
[RPC] CONF GETINCLUDES section
دریافت فهرست includeها برای بخش ارائهشده (global یا share).
توجه داشته باشید که به دلیل ماهیت پایگاه داده رجیستری و ماهیت دستورالعملهای include، موارد include نیاز به رفتار ویژهای دارند: پارامترها در رجیستری بر اساس نام پارامتر به عنوان valuename ذخیره میشوند، بنابراین در هر اشتراک فقط یک نمونه از یک پارامتر وجود دارد. همچنین، ترتیب خاصی مانند یک فایل متنی تضمین نمیشود. برای همه پارامترهای واقعی، این کاملاً مناسب است، اما دستورالعمل include بیشتر یک فراپارامتر است، که در فایل متنی smb.conf، مکانی که بین سایر پارامترها مشخص میشود بسیار مهم است. این مورد را نمیتوان با مدل ساده داده رجیستری smbconf به دست آورد، بنابراین یک فهرست مرتب از includeها برای هر اشتراک وجود دارد، و این فهرست پس از تمام پارامترهای اشتراک ارزیابی میشود.
علاوه بر این توجه داشته باشید که در حال حاضر، فقط فایلها را میتوان از پیکربندی رجیستری include کرد. در آینده، توانایی include کردن دادههای پیکربندی از سایر کلیدهای رجیستری وجود خواهد داشت.
[RPC] CONF SETINCLUDES section [filename]+
تنظیم فهرست includeها برای بخش ارائهشده (global یا share) روی فهرست دادهشده از یک یا چند نام فایل. نامهای فایل ممکن است شامل ماکروهای معمول smb.conf مانند %I باشند.
[RPC] CONF DELINCLUDES section
حذف فهرست includeها از بخش ارائهشده (global یا share).
REGISTRY
دستکاری رجیستری سامبا.
دستورهای رجیستری عبارتند از:
REGISTRY ENUMERATE key
شمارش کلیدهای فرعی و مقادیر key.
REGISTRY ENUMERATE_RECURSIVE key
شمارش مقادیر key و کلیدهای فرعی آن.
REGISTRY CREATEKEY key
ایجاد یک key جدید در صورت عدم وجود.
REGISTRY DELETEKEY key
حذف key دادهشده و مقادیر آن از رجیستری، در صورتی که فاقد کلیدهای فرعی باشد.
REGISTRY DELETEKEY_RECURSIVE key
حذف key دادهشده و تمام کلیدهای فرعی و مقادیر آن از رجیستری.
REGISTRY GETVALUE key name
خروجی دادن نوع و مقدار واقعی از مقدار name مربوط به key دادهشده.
REGISTRY GETVALUERAW key name
خروجی دادن مقدار واقعی از مقدار name مربوط به key دادهشده.
REGISTRY SETVALUE key name type value ...
تنظیم مقدار name از یک key موجود. type میتواند یکی از موارد sz، multi_sz یا dword باشد. در صورت استفاده از multi_sz مقدار value ممکن است چندین بار ارائه شود.
REGISTRY INCREMENT key name [inc]
افزایش مقدار DWORD با نام name از key به میزان inc در حین نگهداشتن یک g_lock. مقدار inc به طور پیشفرض 1 است.
REGISTRY DELETEVALUE key name
حذف مقدار name از key دادهشده.
REGISTRY GETSD key
دریافت توصیفگر امنیت (security descriptor) برای key دادهشده.
REGISTRY GETSD_SDDL key
دریافت توصیفگر امنیت برای key دادهشده به صورت یک رشته با قالب Security Descriptor Definition Language (SDDL).
REGISTRY SETSD_SDDL keysd
تنظیم توصیفگر امنیت برای key دادهشده از روی یک رشته با قالب Security Descriptor Definition Language (SDDL) به نام sd.
REGISTRY IMPORT file [--precheck <check-file>] [opt]
وارد کردن یک file ورودیهای ثبت (.reg).
گزینههای زیر در دسترس هستند:
--precheck check-file
فایل check-file از نحو معمول فایل رجیستری با معانی زیر پیروی میکند:
REGISTRY EXPORT keyfile[opt]
برونبری یک key به یک file ورودیهای ثبت (.reg).
REGISTRY CONVERT in out [[inopt] outopt]
تبدیل یک فایل ورودیهای ثبت (.reg) ورودی in.
REGISTRY CHECK [-ravTl] [-o <ODB>] [--wipe] [<DB>]
بررسی و تعمیر پایگاه داده رجیستری. اگر هیچ گزینهای داده نشود، یک بررسی فقطخواندنی از پایگاه داده انجام میشود. در میان موارد دیگر، یک حالت تعمیر تعاملی یا خودکار را میتوان با یکی از گزینههای زیر انتخاب کرد:
-r|--repair
-a|--auto
-v|--verbose
-T|--test
-l|--lock
--reg-version={1,2,3}
[--db] <DB>
-o|--output <ODB>
--wipe
EVENTLOG
از نسخه 3.4.0 ابزار net میتواند فایلهای وقایع بومی win32 (معمولاً *.evt) را بخواند، تخلیه، وارد و صادر کند. فایلهای evt توسط ابزارهای بومی مشاهده وقایع ویندوز استفاده میشوند.
وارد کردن و صادر کردن فایلهای evt تنها در صورتی میتواند موفق شود که از eventlog list در فایل /etc/samba/smb.conf استفاده شده باشد. برای جزئیات به صفحه راهنمای smb.conf(5) مراجعه کنید.
دستورهای eventlog عبارتند از:
EVENTLOG DUMP filename
چاپ یک فایل وقایع *.evt در خروجی استاندارد.
EVENTLOG IMPORT filename eventlog
وارد کردن یک فایل وقایع *.evt مشخصشده با filename به نمایش داخلی tdb سامبا از لاگ وقایع مشخصشده با eventlog. مقدار eventlog باید بخشی از eventlog list تعریفشده در /etc/samba/smb.conf باشد. برای جزئیات به صفحه راهنمای smb.conf(5) مراجعه کنید.
EVENTLOG EXPORT filename eventlog
صادر کردن نمایش داخلی tdb سامبا از لاگ وقایع مشخصشده با eventlog به یک فایل وقایع *.evt مشخصشده با filename. مقدار eventlog باید بخشی از eventlog list تعریفشده در /etc/samba/smb.conf باشد. برای جزئیات به صفحه راهنمای smb.conf(5) مراجعه کنید.
DOM
از نسخه 3.2.0 سامبا از APIهای الحاق و لغو الحاق راه دور، هم در سمت کلاینت و هم در سمت سرور پشتیبانی میکند. ویندوز از زمان Windows 2000 از قابلیتهای الحاق راه دور پشتیبانی میکند.
برای اینکه سامبا به صورت راه دور ملحق یا لغو الحاق شود، باید از حسابی استفاده شود که یا عضو گروه Domain Admins باشد، یا عضو گروه Administrators محلی یا کاربری که امتیاز SeMachineAccountPrivilege به آن اعطا شده است.
پشتیبانی سمت کلاینت برای الحاق راه دور در دستورهای net dom پیادهسازی شده که عبارتند از:
DOM JOIN domain=DOMAIN ou=OU account=ACCOUNT password=PASSWORD reboot
یک رایانه را به یک دامنه ملحق میکند. این دستور از پارامترهای اضافی زیر پشتیبانی میکند:
توجه داشته باشید که برای اتصال و احراز هویت در ماشین راه دوری که میخواهید به آن ملحق شوید، باید از پارامترهای استاندارد net نیز استفاده کنید. این پارامترهای اضافی عبارتند از: -S computer و -U user.
مثال: net dom join -S xp -U XP\\administrator%secret domain=MYDOM account=MYDOM\\administrator password=topsecret reboot.
این مثال به رایانهای با نام XP به عنوان مدیر محلی با استفاده از گذرواژه secret متصل میشود و رایانه را با استفاده از حساب مدیر دامنه MYDOM و گذرواژه topsecret به دامنهای با نام MYDOM ملحق میکند. پس از الحاق موفق، رایانه راهاندازی مجدد میشود.
DOM UNJOIN account=ACCOUNT password=PASSWORD reboot
لغو الحاق یک رایانه از یک دامنه. این دستور از پارامترهای اضافی زیر پشتیبانی میکند:
توجه داشته باشید که برای اتصال و احراز هویت در ماشین راه دوری که میخواهید از آن لغو الحاق کنید، باید از پارامترهای استاندارد net نیز استفاده کنید. این پارامترهای اضافی عبارتند از: -S computer و -U user.
مثال: net dom unjoin -S xp -U XP\\administrator%secret account=MYDOM\\administrator password=topsecret reboot.
این مثال به رایانهای به نام XP به عنوان مدیر محلی با استفاده از گذرواژه secret متصل میشود و با استفاده از حساب مدیر دامنه MYDOM و گذرواژه topsecret، رایانه را از دامنه لغو الحاق میکند. پس از لغو الحاق موفقیتآمیز، رایانه راهاندازی مجدد میشود.
DOM RENAMECOMPUTER newname=NEWNAME account=ACCOUNT password=PASSWORD reboot
تغییر نام رایانهای که به یک دامنه ملحق شده است. این دستور از پارامترهای اضافی زیر پشتیبانی میکند:
توجه داشته باشید که برای اتصال و احراز هویت در ماشین راه دوری که میخواهید در دامنه تغییر نام دهید، باید از پارامترهای استاندارد net نیز استفاده کنید. این پارامترهای اضافی عبارتند از: -S computer و -U user.
مثال: net dom renamecomputer -S xp -U XP\\administrator%secret newname=XPNEW account=MYDOM\\administrator password=topsecret reboot.
این مثال به رایانهای به نام XP به عنوان مدیر محلی با استفاده از گذرواژه secret متصل میشود و رایانهٔ ملحقشده را با استفاده از حساب مدیر دامنه MYDOM و گذرواژه topsecret به XPNEW تغییر نام میدهد. پس از تغییر نام موفقیتآمیز، رایانه راهاندازی مجدد میشود.
G_LOCK
مدیریت قفلهای سراسری (global locks).
G_LOCK DO lockname timeout command
اجرای یک دستور شل تحت یک قفل سراسری. این ممکن است برای تعیین ترتیبی که در آن چندین دستور شل اجرا خواهند شد مفید باشد. اطلاعات قفلگذاری در فایلی به نام g_lock.tdb ذخیره میشود. در راهاندازیهایی با اجرای CTDB، اطلاعات قفلگذاری روی تمام گرههای کلاستر در دسترس خواهد بود.
G_LOCK LOCKS
چاپ فهرستی از تمام نامهای قفل موجود در حال حاضر.
G_LOCK DUMP lockname
تخلیه جدول قفلگذاری یک قفل سراسری خاص.
TDB
چاپ اطلاعات از رکوردهای tdb.
TDB LOCKING key [DUMP]
فهرست کردن نام اشتراک، نام فایل و تعداد حالتهای اشتراکگذاری برای یک رکورد از locking.tdb. با گزینههای اختیاری DUMP، رکورد کامل را تخلیه میکند.
tdb smbXsrv wipedbs
پاکسازی ورودیهای بیاستفاده و کهنه از پایگاههای داده smbXsrv.
نام مستعاری برای net serverid wipedbs.
vfs
دسترسی به فایلسیستم مشترک از طریق VFS.
vfs stream2abouble [--recursive] [--verbose] [--continue] [--follow-symlinks] share path
تبدیل جریانهای فایل (file streams) به فایلهای AppleDouble.
گزینهها:
--recursive
--verbose
--continue
--follow-symlinks
vfs getntacl share path
نمایش توصیفگر امنیت (security descriptor) یک فایل یا دایرکتوری.
OFFLINEJOIN
از نسخه 4.15 سامبا از APIهای الحاق آفلاین پشتیبانی میکند. ویندوز از Windows 7 و Windows 2008 R2 از قابلیتهای الحاق آفلاین پشتیبانی میکند.
دستورهای آفلاین زیر پیادهسازی شدهاند:
OFFLINEJOIN PROVISION domain=DOMAIN machine_name=MACHINE_NAME machine_account_ou=MACHINE_ACCOUNT_OU dcname=DCNAME defpwd reuse savefile=FILENAME printblob
تدارک یک حساب ماشین در AD. این دستور برای موفقیت نیاز به اتصال شبکه به کنترلکننده دامنه دارد. این دستور از پارامترهای اضافی زیر پشتیبانی میکند:
مثال: net offlinejoin provision -U administrator%secret domain=MYDOM machine_name=MYHOST savefile=provisioning.txt
OFFLINEJOIN REQUESTODJ loadfile=FILENAME
درخواست یک الحاق آفلاین به دامنه با ارائه دادههای تدارک مبتنی بر فایل. این دستور از پارامترهای اضافی زیر پشتیبانی میکند:
مثال: net offlinejoin requestodj loadfile=provisioning.txt
WITNESS
از نسخه 4.20 سامبا از سرویس SMB Witness در یک کلاستر پشتیبانی میکند.
دستورهای witness زیر پیادهسازی شدهاند:
net witness list فهرست کردن ثبتنامهای witness از rpcd_witness_registration.tdb.
net witness client-move تولید اعلانهای جابهجایی کلاینت برای ثبتنامهای witness به یک IP یا گره جدید.
net witness share-move تولید اعلانهای جابهجایی اشتراک برای ثبتنامهای witness به یک IP یا گره جدید.
net witness force-unregister اجبار به لغو ثبتنامها برای ثبتنامهای witness.
net witness force-response اجبار به یک پاسخ AsyncNotify بر اساس ورودی json (عمدتاً برای آزمایش).
WITNESS LIST
فهرست کردن ثبتنامهای witness از rpcd_witness_registration.tdb
نکته: فقط با clustering=yes پشتیبانی میشود!
خروجی قابل خواندن توسط ماشین را میتوان با گزینه زیر تولید کرد:
--json
انتخاب ثبتنامها را میتوان با گزینههای زیر محدود کرد:
--witness-registration=REGISTRATION_UUID
این گزینه به جای انجام پیمایش پایگاه داده، یک جستجوی مستقیم برای REGISTRATION_UUID انجام میدهد.
گزینههای زیر همگی یک عبارت منظم گسترشیافته POSIX میپذیرند که میتواند انتخاب ثبتنامها را بیشتر فیلتر کند. این گزینهها به صورت AND منطقی اعمال میشوند، اما هر REGEX اجازه میدهد با استفاده از نماد خط عمودی (pipe) چندین رشته را مشخص کنید.
--witness-net-name=REGEX
این گزینه 'نام سرور' را که کلاینت برای نظارت ثبت کرده است مشخص میکند.
--witness-share-name=REGEX
این گزینه 'نام اشتراک' را که کلاینت برای نظارت ثبت کرده است مشخص میکند. توجه داشته باشید که نام اشتراک در ثبتنام اختیاری است، در غیر این صورت یک رشته خالی مطابقت داده میشود.
--witness-ip-address=REGEX
این گزینه نشانی IP را که کلاینت برای نظارت ثبت کرده است مشخص میکند.
--witness-client-computer-name=REGEX
این گزینه نام رایانه کلاینت را که در ثبتنام مشخص شده است مشخص میکند. توجه داشته باشید که این صرفاً یک رشته است که خود کلاینت انتخاب میکند.
WITNESS CLIENT-MOVE
تولید اعلانهای جابهجایی کلاینت برای ثبتنامهای witness به یک IP یا گره جدید
نکته: فقط با clustering=yes پشتیبانی میشود!
خروجی قابل خواندن توسط ماشین را میتوان با گزینه زیر تولید کرد:
--json
انتخاب ثبتنامها را میتوان با گزینههای زیر محدود کرد:
--witness-registration=REGISTRATION_UUID
این گزینه به جای انجام پیمایش پایگاه داده، یک جستجوی مستقیم برای REGISTRATION_UUID انجام میدهد.
گزینههای زیر همگی یک عبارت منظم گسترشیافته POSIX میپذیرند که میتواند انتخاب ثبتنامها را بیشتر فیلتر کند. این گزینهها به صورت AND منطقی اعمال میشوند، اما هر REGEX اجازه میدهد با استفاده از نماد خط عمودی چندین رشته را مشخص کنید.
--witness-net-name=REGEX
این گزینه 'نام سرور' را که کلاینت برای نظارت ثبت کرده است مشخص میکند.
--witness-share-name=REGEX
این گزینه 'نام اشتراک' را که کلاینت برای نظارت ثبت کرده است مشخص میکند. توجه داشته باشید که نام اشتراک در ثبتنام اختیاری است، در غیر این صورت یک رشته خالی مطابقت داده میشود.
--witness-ip-address=REGEX
این گزینه نشانی IP را که کلاینت برای نظارت ثبت کرده است مشخص میکند.
--witness-client-computer-name=REGEX
این گزینه نام رایانه کلاینت را که کلاینت در ثبتنام مشخص کرده است تعیین میکند. توجه داشته باشید که این صرفاً یک رشته است که خود کلاینت انتخاب میکند.
اگر بهروزرسانی باید روی تمام ثبتنامها اعمال شود، باید صراحتاً مشخص شود:
--witness-apply-to-all
این گزینه تمام ثبتنامها را انتخاب میکند. نکته: این گزینه با گزینههای بالا مانعةالجمع است.
محتوای اعلان CLIENT_MOVE شامل نشانیهای IP مشخصشده توسط (دقیقاً یکی) از گزینههای زیر است:
--witness-new-node=NODEID
با تعیین یک NODEID تمام نشانیهای IP موجود در آن گره در پاسخ گنجانده میشوند. با تعیین '-1' به عنوان NODEID تمام نشانیهای IP کلاستر در پاسخ گنجانده میشوند.
--witness-new-ip=IPADDRESS
با تعیین یک IPADDRESS فقط نشانی IP مشخصشده در پاسخ گنجانده میشود.
WITNESS SHARE-MOVE
تولید اعلانهای جابهجایی اشتراک برای ثبتنامهای witness به یک IP یا گره جدید
نکته: فقط با clustering=yes پشتیبانی میشود!
خروجی قابل خواندن توسط ماشین را میتوان با گزینه زیر تولید کرد:
--json
انتخاب ثبتنامها را میتوان با گزینههای زیر محدود کرد:
--witness-registration=REGISTRATION_UUID
این گزینه به جای انجام پیمایش پایگاه داده، یک جستجوی مستقیم برای REGISTRATION_UUID انجام میدهد.
گزینههای زیر همگی یک عبارت منظم گسترشیافته POSIX میپذیرند که میتواند انتخاب ثبتنامها را بیشتر فیلتر کند. این گزینهها به صورت AND منطقی اعمال میشوند، اما هر REGEX اجازه میدهد با استفاده از نماد خط عمودی چندین رشته را مشخص کنید.
--witness-net-name=REGEX
این گزینه 'نام سرور' را که کلاینت برای نظارت ثبت کرده است مشخص میکند.
--witness-share-name=REGEX
این گزینه 'نام اشتراک' را که کلاینت برای نظارت ثبت کرده است مشخص میکند. توجه داشته باشید که نام اشتراک در ثبتنام اختیاری است، در غیر این صورت یک رشته خالی مطابقت داده میشود.
--witness-ip-address=REGEX
این گزینه نشانی IP را که کلاینت برای نظارت ثبت کرده است مشخص میکند.
--witness-client-computer-name=REGEX
این گزینه نام رایانه کلاینت را که کلاینت در ثبتنام مشخص کرده است تعیین میکند. توجه داشته باشید که این صرفاً یک رشته است که خود کلاینت انتخاب میکند.
اگر بهروزرسانی باید روی تمام ثبتنامها اعمال شود، باید صراحتاً مشخص شود:
--witness-apply-to-all
این گزینه تمام ثبتنامها را انتخاب میکند. نکته: این گزینه با گزینههای بالا مانعةالجمع است.
نکته: این مورد فقط برای ثبتنامهایی با نام اشتراک غیرخالی اعمال میشود!
محتوای اعلان SHARE_MOVE شامل نشانیهای IP مشخصشده توسط (دقیقاً یکی) از گزینههای زیر است:
--witness-new-node=NODEID
با تعیین یک NODEID تمام نشانیهای IP موجود در آن گره در پاسخ گنجانده میشوند. با تعیین '-1' به عنوان NODEID تمام نشانیهای IP کلاستر در پاسخ گنجانده میشوند.
--witness-new-ip=IPADDRESS
با تعیین یک IPADDRESS فقط نشانی IP مشخصشده در پاسخ گنجانده میشود.
WITNESS FORCE-UNREGISTER
اجبار به لغو ثبتنامها برای ثبتنامهای witness
نکته: فقط با clustering=yes پشتیبانی میشود!
خروجی قابل خواندن توسط ماشین را میتوان با گزینه زیر تولید کرد:
--json
انتخاب ثبتنامها را میتوان با گزینههای زیر محدود کرد:
--witness-registration=REGISTRATION_UUID
این گزینه به جای انجام پیمایش پایگاه داده، یک جستجوی مستقیم برای REGISTRATION_UUID انجام میدهد.
گزینههای زیر همگی یک عبارت منظم گسترشیافته POSIX میپذیرند که میتواند انتخاب ثبتنامها را بیشتر فیلتر کند. این گزینهها به صورت AND منطقی اعمال میشوند، اما هر REGEX اجازه میدهد با استفاده از نماد خط عمودی چندین رشته را مشخص کنید.
--witness-net-name=REGEX
این گزینه 'نام سرور' را که کلاینت برای نظارت ثبت کرده است مشخص میکند.
--witness-share-name=REGEX
این گزینه 'نام اشتراک' را که کلاینت برای نظارت ثبت کرده است مشخص میکند. توجه داشته باشید که نام اشتراک در ثبتنام اختیاری است، در غیر این صورت یک رشته خالی مطابقت داده میشود.
--witness-ip-address=REGEX
این گزینه نشانی IP را که کلاینت برای نظارت ثبت کرده است مشخص میکند.
--witness-client-computer-name=REGEX
این گزینه نام رایانه کلاینت را که کلاینت در ثبتنام مشخص کرده است تعیین میکند. توجه داشته باشید که این صرفاً یک رشته است که خود کلاینت انتخاب میکند.
اگر بهروزرسانی باید روی تمام ثبتنامها اعمال شود، باید صراحتاً مشخص شود:
--witness-apply-to-all
این گزینه تمام ثبتنامها را انتخاب میکند. نکته: این گزینه با گزینههای بالا مانعةالجمع است.
ثبتنامهای انتخابشده روی سرور حذف میشوند و هر درخواست در انتظار AsyncNotify خطای NOT_FOUND دریافت خواهد کرد.
معمولاً این امر باعث یک ثبتنام مجدد تمیز در کلاینت میشود.
WITNESS FORCE-RESPONSE
اجبار به یک پاسخ AsyncNotify بر اساس ورودی json (عمدتاً برای آزمایش)
نکته: فقط با clustering=yes پشتیبانی میشود!
خروجی قابل خواندن توسط ماشین را میتوان با گزینه زیر تولید کرد:
--json
انتخاب ثبتنامها را میتوان با گزینههای زیر محدود کرد:
--witness-registration=REGISTRATION_UUID
این گزینه به جای انجام پیمایش پایگاه داده، یک جستجوی مستقیم برای REGISTRATION_UUID انجام میدهد.
گزینههای زیر همگی یک عبارت منظم گسترشیافته POSIX میپذیرند که میتواند انتخاب ثبتنامها را بیشتر فیلتر کند. این گزینهها به صورت AND منطقی اعمال میشوند، اما هر REGEX اجازه میدهد با استفاده از نماد خط عمودی چندین رشته را مشخص کنید.
--witness-net-name=REGEX
این گزینه 'نام سرور' را که کلاینت برای نظارت ثبت کرده است مشخص میکند.
--witness-share-name=REGEX
این گزینه 'نام اشتراک' را که کلاینت برای نظارت ثبت کرده است مشخص میکند. توجه داشته باشید که نام اشتراک در ثبتنام اختیاری است، در غیر این صورت یک رشته خالی مطابقت داده میشود.
--witness-ip-address=REGEX
این گزینه نشانی IP را که کلاینت برای نظارت ثبت کرده است مشخص میکند.
--witness-client-computer-name=REGEX
این گزینه نام رایانه کلاینت را که کلاینت در ثبتنام مشخص کرده است تعیین میکند. توجه داشته باشید که این صرفاً یک رشته است که خود کلاینت انتخاب میکند.
اگر بهروزرسانی باید روی تمام ثبتنامها اعمال شود، باید صراحتاً مشخص شود:
--witness-apply-to-all
این گزینه تمام ثبتنامها را انتخاب میکند. نکته: این گزینه با گزینههای بالا مانعةالجمع است.
توجه داشته باشید این دستور برای آزمایش و اشکالزدایی طراحی شده است!
به طور خلاصه این دستور برای استفاده مدیران طراحی نشده، بلکه برای توسعهدهندگان و آزمونهای خودکار است.
بهطور پیشفرض یک پاسخ خالی با WERR_OK تولید میشود، اما اساساً هر پاسخ معتبری را میتوان با تعیین یک رشته JSON مشخص کرد:
--witness-forced-response=JSON
این امکان تولید ساختارهای بسیار پیچیده witness_notifyResponse را فراهم میکند.
از آنجا که این دستور برای توسعهدهندگان است، لطفاً برای درک تمام مقادیر ممکن از قالب رشته JSON کد منبع را بخوانید...
برای جزئیات بیشتر 'net help witness force-response' را ببینید.
serverid
بررسی وجود یک serverid و پاکسازی ورودیهای کهنه و بیاستفاده از پایگاههای داده وضعیت سرور فایل.
دستورهای زیر پیادهسازی شدهاند:
serverid exists <serverid>
بررسی میکند که آیا یک serverid وجود دارد یا خیر.
serverid wipedbs
پاکسازی ورودیهای کهنه از پایگاههای داده وضعیت فایلسرور.
گزینههای مربوط به wipedbs:
--test
فقط ورودیهای کهنه را بررسی کرده و آنها را لاگ میکند
--verbose
تولید لاگهای پرجزئیات
HELP [COMMAND]
ارائه اطلاعات نحوه استفاده برای دستور مشخصشده.
نسخه (VERSION)
این صفحه راهنما بخشی از نسخهٔ 4.24.6 مجموعه نرمافزاری سامبا است.
نویسنده (AUTHOR)
نرمافزار اصلی سامبا و ابزارهای مرتبط با آن توسط Andrew Tridgell ایجاد شدهاند. اکنون سامبا توسط تیم سامبا به عنوان یک پروژه منبعباز مشابه روش توسعه هسته لینوکس توسعه داده میشود.
صفحه راهنمای net توسط Jelmer Vernooij نوشته شده است.
| 08/16/2026 | Samba 4.24.6 |