منصوبے کے بارے میں

cb365 مائیکروسافٹ 365 خدمات تک کمانڈ لائن رسائی فراہم کرتا ہے، جو کہ کسٹم Graph API ایپلیکیشنز لکھنے یا مینوئل UI تعامل کے متبادل کے طور پر کام کرتا ہے۔ یہ کاموں کو خودکار بنانے کی اجازت دیتا ہے جیسے ٹاسکس بنانا، میل بھیجنا، کیلنڈرز کا نظم کرنا، Teams پر پوسٹ کرنا، اور SharePoint، OneDrive، Planner، اور Loop کے ساتھ تعامل کرنا۔ یہ ٹول سٹرکچرڈ JSON آؤٹ پٹ فراہم کرتا ہے، جو اسے سکرپٹس اور AI ایجنٹس کے استعمال کے لیے موزوں بناتا ہے۔ اہم خصوصیات اور ہدف کے حامل صارفین میں شامل ہیں: * **DevOps اور پلیٹ فارم انجینئرز**: M365 آپریشنز کے لیے سکرپٹنگ، جیسے CI سے ٹاسکس بنانا یا Teams میں بلڈ کے نتائج پوسٹ کرنا۔ * **AI ایجنٹ بلڈرز**: خود مختار ورک فلو کے لیے `--json` آؤٹ پٹ اور حفاظتی فلیگز کے ساتھ ڈیزائن کیا گیا۔ * **IT ایڈمنز**: Graph API آپریشنز کے لیے PowerShell کا ایک CLI متبادل۔ * **ڈویلپرز**: عام M365 کاموں کے لیے بوائلر پلیٹ Graph SDK کوڈ کو کم کرتا ہے۔ cb365 مائیکروسافٹ Graph API کو لپیٹتا (wraps) ہے، اور اس طرح کی پیچیدگیوں کو سنبھالتا ہے: * **توثیق (Authentication)**: ڈیوائس-کوڈ، کلائنٹ کریڈینشلز، اور سرٹیفکیٹ فلو کی حمایت کرتا ہے، اور ٹوکنز کو OS کیچین میں محفوظ طریقے سے اسٹور کرتا ہے۔ * **حفاظت (Safety)**: 44 ہارڈ کوڈ شدہ قواعد پر مشتمل ہے، جس کے لیے ڈیلیٹ کرنے کے لیے `--force` اور براڈکاسٹ کے لیے `--confirm` کی ضرورت ہوتی ہے، جبکہ تمام رائٹ (write) آپریشنز کے لیے `--dry-run` دستیاب ہے۔ آؤٹ پٹ میں ٹوکن کبھی بھی ظاہر نہیں ہوتے ہیں۔ * **آؤٹ پٹ**: پائپ لائن انٹیگریشن کے لیے ڈیزائن کیے گئے `--json`، `--plain` (TSV)، اور انسان کے پڑھنے کے قابل ٹیبل فارمیٹس فراہم کرتا ہے۔ * **پروفائلز**: تفویض کردہ (delegated) اور صرف-ایپ (app-only) توثیق کا ایک ساتھ نظم کرتا ہے، جس سے ٹیننٹ (tenant) کی تبدیلی آسان ہو جاتی ہے۔ * **کوئی انحصار (dependencies) نہیں**: بغیر کسی رن ٹائم ضروریات کے ایک واحد Go بائنری۔ انسٹالیشن `go install` یا پری-بلٹ ریلیز بائنریز کے ذریعے دستیاب ہے۔ صارفین کو ایک Entra ID App رجسٹر کرنا ہوگا اور ضروری API اجازتیں کنفیگر کرنی ہوں گی۔ توثیق تعاملی (interactive) استعمال کے لیے تفویض کردہ (ڈیوائس کوڈ) اور بغیر نگرانی کی آٹومیشن کے لیے صرف-ایپ (کلائنٹ سیکرٹ یا سرٹیفکیٹ) کی حمایت کرتی ہے، سیکورٹی کے لیے کلائنٹ سیکرٹس صرف سٹینڈرڈ ان پٹ سے قبول کیے جاتے ہیں۔ مختلف M365 ورک لوڈز کے لیے کمانڈز دستیاب ہیں: * **Auth**: لاگ ان، سٹیٹس، لاگ آؤٹ، پروفائل مینجمنٹ۔ * **To Do**: ٹاسک لسٹس اور ٹاسکس کی فہرست بنانا، تخلیق کرنا، اپ ڈیٹ کرنا، مکمل کرنا، اور حذف کرنا۔ * **Mail**: پیغام دکھانا، حاصل کرنا، پڑھا ہوا مارک کرنا، منتقل کرنا، مستقل طور پر ڈیلیٹ کرنا، ڈرافٹ بنانا، بھیجنا، اور تلاش کرنا۔ * **Calendar**: ایونٹس کی فہرست بنانا، حاصل کرنا، بنانا، اپ ڈیٹ کرنا، اور ڈیلیٹ کرنا۔ * **Contacts**: رابطوں (contacts) کی فہرست بنانا، حاصل کرنا، تلاش کرنا، بنانا، اور اپ ڈیٹ کرنا۔ * **Planner**: پلانز کی فہرست بنانا، پلان بنانا، بکیٹس کا نظم کرنا، اور ٹاسکس کا نظم کرنا۔ * **Teams**: چینلز کی فہرست بنانا، چینلز اور چیٹس میں پیغامات بھیجنا، اور چینل پیغامات کو سوفٹ ڈیلیٹ کرنا۔ * **SharePoint**: سائٹس کی فہرست بنانا/تلاش کرنا، سائٹ کی تفصیلات حاصل کرنا، لسٹس اور لسٹ آئٹمز کا نظم کرنا، اور فائلوں کا نظم کرنا (فہرست بنانا، حاصل کرنا، اپ لوڈ کرنا)۔ * **OneDrive**: فائلوں کی فہرست بنانا، حاصل کرنا، اپ لوڈ کرنا، ڈیلیٹ کرنا، اور فولڈرز بنانا۔ * **Loop**: ورک اسپیسز اور صفحات کی فہرست بنانا، صفحات کو ڈاؤن لوڈ/ایکسپورٹ کرنا، صفحات کو ڈیلیٹ کرنا، فائلیں اپ لوڈ کرنا، اور فولڈرز بنانا۔ گلوبل فلیگز میں `--json`، `--plain`، `--profile`، `--dry-run`، اور `--verbose` شامل ہیں۔ یہ ٹول فائلوں یا stdin سے بالواسطہ (indirect) قدروں کی حمایت کرکے پروسیس آرگومنٹس سے بزنس مواد کو باہر رکھنے پر زور دیتا ہے۔ حفاظتی قواعد ہارڈ کوڈ شدہ ہیں، جن میں رائٹ پروٹیکشن، کیلنڈر سے مخصوص قواعد (مثلاً ٹائم زون کی تصدیق، ڈپلیکیٹ کا پتہ لگانا، شرکاء کی تعداد کے محافظ)، میل کی حفاظت (مثلاً بھیجنے کے لیے `--confirm`، وصول کنندگان کی تعداد کے محافظ)، اور ٹوکن کی حفاظت (محفوظ سٹوریج، آؤٹ پٹ کا کوئی نمائش نہ ہونا) شامل ہیں۔ AI ایجنٹ انٹیگریشن کے لیے، `--json` آؤٹ پٹ سٹرکچرڈ ڈیٹا فراہم کرتا ہے۔ ایجنٹس کو مشورہ دیا جاتا ہے کہ وہ M365 مواد کو ناقابل اعتماد ڈیٹا کے طور پر لیں اور کمانڈز کے لیے واضح اجازت ناموں (allowlists) اور سائیڈ ایفیکٹس کے لیے کنفرمیشن فلیگز کا استعمال کریں۔ ایرر ہینڈلنگ معیار کے مطابق سٹینڈرڈ Unix ایگزٹ کوڈز کا استعمال کرتی ہے، جس میں غلطیاں (errors) stderr پر پرنٹ ہوتی ہیں۔