Справочник по команде agent 365 CLI query-entra

Предоставляет параметры для запроса идентификатора Microsoft Entra для сведений об агенте, включая области, разрешения и состояние согласия. Вы можете проверить статус конфигурации и согласия как для чертежей агентов, так и для экземпляров агентов.

Минимальная необходимая роль: Читатель каталогов

Syntax

a365 query-entra [command] [options]

Options

Option Description
-?, -h, --help Показывать справочную и пользовательскую информацию

query-entra blueprint-scopes

Перечислите делегированные и разрешения приложений, объявленные программой Agent Blueprint.

a365 query-entra blueprint-scopes [options]

Эта команда извлекает и отображает делегированные области и назначение ролей приложений, предоставленные в принципе сервиса blueprint в Microsoft Entra ID. Этот результат совпадает с тем, что вы видите на блейде разрешения API в административном центре Entra для приложения blueprint.

blueprint-scopes варианты

Option Description
-n, --agent-name <name> Имя базы агента. Когда вы предоставляете эту опцию, конфигурационный файл не нужен.
--tenant-id <tenantId> Идентификатор клиента Azure AD. Overrides autodetection. Используйте с --agent-name.
-?, -h, --help Показать справку и информацию об использовании.

query-entra inheritance

Убедитесь, что права наследования чертежа настроены правильно и что идентификаторы агентов действительно их наследуют.

a365 query-entra inheritance [options]

Эта команда проверяет две вещи для каждого ресурса, настроенного в чертеже:

  1. Запись в inheritablePermissions чертеже используется kind=allAllowed как для целов, так и для ролей (необходимая конфигурация).
  2. Принципал сервиса blueprint имеет реальные разрешения для этого ресурса (без грантов нечего наследовать, даже если конфигурация правильна).

По каждому ресурсу команда сообщает:

  • Scopes: OK—kind=allAllowed устанавливается, и делегированные разрешения предоставляются на чертеже SP.
  • Scopes: WARN— kind=allAllowed' устанавливается, но делегированные разрешения не предоставляются, или запись использует устаревшую перечисленную форму.
  • Roles: OK—kind=allAllowed устанавливается, и назначение ролей приложений присваивается на чертеже SP.
  • Roles: WARN— те же условия, что и в Scopes WARN, для ролей в приложениях.
  • Effective inheritance: OK—обе стороны — такие allAllowed , и по крайней мере один грант существует. Идентификаторы агентов, созданные на основе этого чертежа, наследует права на доступ к этому ресурсу.
  • Effective inheritance: NONE—конфигурация правильна, но грантов на чертеже SP нет. Работайте 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. 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. Overrides autodetection. Используйте с --agent-name.
-v, --verbose Включите подробное логирование.
-?, -h, --help Показать справку и информацию об использовании.

Note

Для чтения разрешений OAuth2 по всему арендатору требуется область доступа только DelegatedPermissionGrant.Read.All для администратора. Если вы войдёте без этой области, команда направляет вас в Центр администрирования Microsoft Entra для проверки статуса согласия, а не сообщает о «согласие администратора не предоставлено».

  • Последнее обновление: