> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/ja/zi-dong-hua/runbooks/naming-conventions.md).

# Runbook 命名規則

## GitHub内のファイル名

私たちは、特定のファイルと命名構造を想定しています [共有runbookリポジトリ](https://github.com/realmjoin/realmjoin-runbooks). RealmJoinは、これらのフォルダーとファイルをGitHubから顧客のAzure Automation Accountにインポートします。

ダッシュ（"-"）はスペースに変換されます。フォルダーはrunbookを「コンテキスト」と「カテゴリ」に分けるために使用されます。たとえば、 `user\general`. ファイル名はスクリプトの目的を表す必要があります。

インポートされるすべてのrunbookには次のプレフィックスが付きます `rjgit-`、続いてコンテキストが入り、次のいずれかになります `org`, `グループ`, `user` その後にカテゴリが続き、たとえば `_general_`, `_security_`, `_mail_` さらにスクリプト自体の名前が続きます。たとえば `add-additional-alias`.

### 例:

GitHub内のrunbookが `user\general` という名前で `add-additional-alias.ps1` は次のように表示されます:

* `rjgit-user_general_add-additional-alias` Azure Automation Account内で
* runbookカテゴリ「General」のUserオブジェクト上で、RealmJoin Portalの「Add Additional Alias」として表示されます。

一般的なカテゴリ

* 一般
* セキュリティ
* メール
* ユーザー情報

追加のカテゴリは定義できますが、コンテキストは定義できません。

### これは何の目的ですか？

これにより、RealmJoin Portal内のrunbookを自動的に入力し、命名できます。また、 `rjgit-` このプレフィックスにより、ローカル/顧客固有のrunbookとの命名衝突を避けられます。このプレフィックスを持たないrunbookは、RealmJoinのインポートロジックによって変更されません。

## プライベート / 顧客固有のRunbook

Azure Automation Accountでプライベート（ローカル）runbookをホストできます。これらのrunbookは、共有runbookと同様にRealmJoin Portalに表示されます。ローカルrunbookは当社の同期プロセスの影響を受けず、他の顧客には表示されません。

ローカルrunbookを作成するには、 `rjgit-` 命名規則からプレフィックスを削除し、残りの命名構造はそのまま維持します。

例: Azure ADグループのコンテキストで、カテゴリ「General」のrunbook「Private Runbook」を提供したい場合、次のように名前を付けます。 `group_general_private-runbook` Azure Automation Account内で。

Azure Automationでは次のようになります:

![GitHub / Azure Automation内のrunbook名](/files/87d5953507e2c490b8d688d64eec8f90f3d46022)

RealmJoin Portalでは次のように表示されます:

![RealmJoin Portal内のrunbook名](/files/1e3c9fcbbeae04b8dfc4097624a4809ae175057c)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.realmjoin.com/ja/zi-dong-hua/runbooks/naming-conventions.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.