एजेंट 365 सीएलआई query-entra कमांड संदर्भ

कार्यक्षेत्र, अनुमतियाँ और सहमति स्थिति सहित एजेंट जानकारी के लिए Microsoft Entra ID क्वेरी करने के लिए विकल्प प्रदान करता है। आप एजेंट ब्लूप्रिंट और एजेंट इंस्टेंस दोनों के लिए कॉन्फ़िगरेशन और सहमति स्थिति की जांच कर सकते हैं।

न्यूनतम भूमिका आवश्यक: निर्देशिका रीडर

Syntax

a365 query-entra [command] [options]

विकल्प

Option Description
-?, , -h--help मदद और उपयोग की जानकारी दिखाएं

query-entra blueprint-scopes

एजेंट ब्लूप्रिंट अनुप्रयोग द्वारा घोषित प्रत्यायोजित और अनुप्रयोग अनुमतियों की सूची बनाएं।

a365 query-entra blueprint-scopes [options]

यह आदेश पुनर्प्राप्त करता है और प्रत्यायोजित क्षेत्र और अनुप्रयोग रोल असाइनमेंट Microsoft Entra ID में ब्लूप्रिंट सेवा प्रिंसिपल पर दिए गए प्रदर्शित करता है। यह परिणाम ब्लूप्रिंट एप्लिकेशन के लिए Entra व्यवस्थापक केंद्र में API अनुमतियाँ ब्लेड पर दिखाई देने वाली चीज़ों से मेल खाता है.

blueprint-scopes विकल्प

Option Description
-n, --agent-name <name> एजेंट आधार का नाम। जब आप यह विकल्प प्रदान करते हैं, तो आपको कॉन्फ़िगरेशन फ़ाइल की आवश्यकता नहीं होती है।
--tenant-id <tenantId> Azure AD टेनेंट ID. Overrides autodetection. के साथ प्रयोग --agent-nameकरें।
-?, , -h--help मदद और उपयोग की जानकारी दिखाएं.

query-entra inheritance

सत्यापित करें कि ब्लूप्रिंट की इनहेरिटेबल अनुमतियाँ ठीक से कॉन्फ़िगर की गई हैं और एजेंट पहचान वास्तव में उन्हें इनहेरिट करेगा।

a365 query-entra inheritance [options]

यह आदेश ब्लूप्रिंट पर कॉन्फ़िगर किए गए प्रत्येक संसाधन के लिए दो चीज़ों की जाँच करता है:

  1. ब्लूप्रिंट की inheritablePermissions प्रविष्टि स्कोप और भूमिकाओं (आवश्यक कॉन्फ़िगरेशन) दोनों के लिए उपयोग करती kind=allAllowed है।
  2. ब्लूप्रिंट सेवा प्रिंसिपल के पास उस संसाधन के लिए वास्तविक अनुमति अनुदान है (अनुदान के बिना, कॉन्फ़िगरेशन सही होने पर भी विरासत में लेने के लिए कुछ भी नहीं है)।

प्रत्येक संसाधन के लिए, कमांड रिपोर्ट करता है:

  • Scopes: OK- सेटkind=allAllowed है और प्रत्यायोजित अनुमतियाँ ब्लूप्रिंट एसपी पर प्रदान की जाती हैं।
  • Scopes: WARN— kind=allAllowed' सेट किया गया है, लेकिन कोई प्रत्यायोजित अनुमतियाँ नहीं दी जाती हैं, या प्रविष्टि एक विरासत गणना प्रपत्र का उपयोग करती है।
  • Roles: OK-kind=allAllowed सेट है और ब्लूप्रिंट एसपी पर ऐप रोल असाइनमेंट दिए जाते हैं।
  • Roles: WARN—ऐप भूमिकाओं के लिए स्कोप्स चेतावनी के समान शर्तें।
  • Effective inheritance: OK—दोनों पक्ष हैं allAllowed और कम से कम एक अनुदान मौजूद है। इस ब्लूप्रिंट से बनाई गई एजेंट पहचान इस संसाधन के लिए अनुमतियाँ इनहेरिट करेगी.
  • Effective inheritance: NONE-कॉन्फ़िगरेशन सही है लेकिन ब्लूप्रिंट एसपी पर कोई अनुदान मौजूद नहीं है। अनुदान जोड़ने के लिए वैश्विक व्यवस्थापक के रूप में चलाएँ a365 setup permissions ।
  • Effective inheritance: BROKEN—प्रविष्टि एक या दोनों तरफ उपयोग नहीं allAllowed करती है। सुलह करने के लिए दौड़ें a365 setup permissions ।

कमांड कोड के 1 साथ बाहर निकलता है यदि किसी संसाधन में इसके अलावा कोई Effective inheritance: OKस्थिति है। एजेंट पहचान बनाने से पहले यह पुष्टि करने के लिए कि ब्लूप्रिंट तैयार है, या यह पता लगाने के लिए कि एजेंट पहचान अपेक्षित अनुमतियाँ क्यों नहीं प्राप्त कर रही हैं, इस आदेश का उपयोग करें.

inheritance विकल्प

Option Description
-n, --agent-name <name> एजेंट आधार का नाम। जब आप यह विकल्प प्रदान करते हैं, तो आपको कॉन्फ़िगरेशन फ़ाइल की आवश्यकता नहीं होती है।
--tenant-id <tenantId> Azure AD टेनेंट ID. Overrides autodetection. के साथ प्रयोग --agent-nameकरें।
-?, , -h--help मदद और उपयोग की जानकारी दिखाएं.

Tip

यदि एक या अधिक संसाधनों के लिए प्रकट होता है, तो Effective inheritance: NONE सबसे आम कारण क्लाइंट ऐप पर एक अनुपलब्ध wids वैकल्पिक दावा है। इसे स्वचालित रूप से पता लगाने और सुधारने के लिए दौड़ें a365 setup requirements ।

query-entra instance-scopes

एजेंट आवृत्ति के लिए कॉन्फ़िगर किए गए क्षेत्र और सहमति स्थिति की सूची बनाएं।

a365 query-entra instance-scopes [options]

यह आदेश पुनर्प्राप्त करता है और कॉन्फ़िगर किए गए क्षेत्र और Microsoft Entra ID में एजेंट आवृत्ति अनुप्रयोग के लिए उनकी सहमति स्थिति प्रदर्शित करता है।

instance-scopes विकल्प

Option Description
-n, --agent-name <name> एजेंट आधार का नाम। जब आप यह विकल्प प्रदान करते हैं, तो आपको कॉन्फ़िगरेशन फ़ाइल की आवश्यकता नहीं होती है।
--tenant-id <tenantId> Azure AD टेनेंट ID. Overrides autodetection. के साथ प्रयोग --agent-nameकरें।
-v, --verbose वर्बोज़ लॉगिंग सक्षम करें।
-?, , -h--help मदद और उपयोग की जानकारी दिखाएं.

Note

किरायेदार-व्यापी OAuth2 अनुमति अनुदान पढ़ने के लिए केवल व्यवस्थापक DelegatedPermissionGrant.Read.All के दायरे की आवश्यकता होती है। यदि आप उस दायरे के बिना साइन इन करते हैं, तो आदेश आपको "व्यवस्थापक सहमति नहीं दी गई है" की रिपोर्ट करने के बजाय सहमति स्थिति को सत्यापित करने के लिए Microsoft Entra व्यवस्थापक center पर निर्देशित करता है।