OrganizationSync ユーティリティの使用によるユーザーの組織変更
サイトのディレクトリサービス内のユーザーエントリを修正できるサードパーティツールを使用して、ユーザーを 1 つの組織から別の組織に移動した場合、ユーザーのドメインおよびユーザーのパーソナルキャビネットのドメインは自動的に変更されません。サイト管理者は、OrganizationSync コマンドラインユーティリティを使用して、組織変更のあったユーザーの組織関連情報を更新できます。サードパーティツールでユーザーの組織を変更した後、OrganizationSync ユーティリティを実行して、そのユーザーのその他の組織関連情報を変更します。このユーティリティを使用すると、ユーザーまたは一連のユーザーのプロパティが、現在の組織と確実に同期するようになります。
 |
サードパーティツールではなく「参加者管理」を使用してディレクトリサービス内のユーザー情報を更新した場合、「ユーザーを編集」ウィンドウからユーザーの組織を変更した結果として OrganizationSync ユーティリティが自動的に実行します。
|
OrganizationSync ユーティリティでは、以下の処理が実行されます。
• 一連のユーザー関連ビジネスオブジェクトを、ユーザーの現在の組織の管理ドメインに割り当てます。ユーザーに組織が設定されていない場合、これらのオブジェクトは「Unaffiliated」ドメインに割り当てられます。再割当されたオブジェクトには、WTUser オブジェクト、ユーザーのパーソナルキャビネットとそのパーソナルキャビネットのコンテンツ、およびユーザーのノートブックが含まれます。
• 必要に応じて、前の組織コンテキストの管理者グループおよび作成者グループからユーザーを除去します。ユーティリティは、ユーザーの前の管理ドメインのコンテキストを抽出することによって、前のコンテキストを決定します。
• ユーザーがメンバーであった全チームの組織グループを更新して、ユーザーの現在の組織メンバーシップを反映します。
|
|
OrganizationSync ユーティリティは、実際には更新されていないユーザーに対しても実行しておいた方が安全です。
|
OrganizationSync コマンドの構文は以下のとおりです。
java wt.inf.container.OrganizationSync {--users <ユーザーリスト>} {--domains <ドメインリスト>}
{--domain-hierarchies <ドメインリスト>} {--organizations <組織リスト>}
{--domain-hierarchies <ドメインリスト>} {--organizations <組織リスト>}
構文内の中括弧 ({}) は、オプションのパラメータを示しており、同時に指定するパラメータを示しています。パラメータ名では大文字と小文字が区別されます。構文および以下の表に示すとおりに大文字小文字を区別して名前を入力してください。
|
パラメータ値
|
説明
|
|---|---|
|
<ユーザーリスト>
|
ユーザー名のスペース区切りのリスト
|
|
<ドメインリスト>
|
ドメインパスのスペース区切りのリスト
|
|
<組織リスト>
|
組織名のスペース区切りのリスト
|
<ドメインリスト> を - domains パラメータとともに使用すると、そのドメイン内のすべてのユーザーが同期化されます。<ドメインリスト> を -domain-hierarchies パラメータとともに使用すると、各ドメイン内、およびすべての子ドメイン内のすべてのユーザーが同期化されます。
|
|
OrganizationSync ユーティリティは、常に windchill シェルから実行してください。windchill シェルの使用方法の詳細については、windchill シェルについてを参照してください。
|
例:
//Update the foo and bar users
java wt.inf.container.OrganizationSync --users foo bar
// Update all users in the site-level Unaffiliated domain
// and the "PTC Inc" domain in the "PTC Inc" org container
java wt.inf.container.OrganizationSync --domains [/]/User/Unaffiliated
"[/wt.inf.container.OrgContainer=PTC Inc]/PTC Inc"
// Update all users in the site-level User domain, and in
// all of its child domains
java wt.inf.container.OrganizationSync --domain-hierarchies [/]/User
// Update all members of the "Acme Inc." and
// "Widget Intl." organizations
java wt.inf.container.OrganizationSync --organizations "Acme Inc."
"Widget Intl."
java wt.inf.container.OrganizationSync --users foo bar
// Update all users in the site-level Unaffiliated domain
// and the "PTC Inc" domain in the "PTC Inc" org container
java wt.inf.container.OrganizationSync --domains [/]/User/Unaffiliated
"[/wt.inf.container.OrgContainer=PTC Inc]/PTC Inc"
// Update all users in the site-level User domain, and in
// all of its child domains
java wt.inf.container.OrganizationSync --domain-hierarchies [/]/User
// Update all members of the "Acme Inc." and
// "Widget Intl." organizations
java wt.inf.container.OrganizationSync --organizations "Acme Inc."
"Widget Intl."
上の例で、コンテナパスは、ドメインパスと区別できるように、括弧で囲まれています。[/] はサイト (Root) コンテナです。