p4 renameuser
ユーザの名前を変更し、そのユーザについて記載されているデータベースレコードをすべて変更します。
構文規則
p4 [g-opts] renameuser [-f] --from=old --to=new
説明
p4 renameuser
コマンドはユーザの名前を変更し、次の要素を変更してこの変更を反映します。
- ユーザレコード
- ユーザを含むグループ
- ユーザに適用されるプロパティ
- ユーザが所有するオブジェクト: ワークスペース、ラベル、ブランチ、ストリームなど
- ユーザが作成したオブジェクト: 作業中、保留状態、コミット済みの変更すべて
- ユーザが作業状態にしたファイルまたは保留にしたファイル
- ユーザがジョブに対して行った修正
説明的なテキストフィールド(ジョブの説明または変更の説明など)に記載されている ユーザ名は変更されません。データベースレコードの所有者またはユーザの フィールドとして表示される名前のみ変更されます。
ユーザに適用されるプロテクションテーブルエントリは、
Name
フィールドがユーザ名と完全に一致する場合にのみ更新されます。
Name
フィールドにワイルドカードが含まれている場合、変更は行われません。
ジョブフィールドで処理対象となるのは属性コード103のみになります。 他のジョブフィールドに含まれているユーザ名は、手動で変更する必要があります。
p4 renameuser
コマンドは、スペックディポ内の内容は変更しません。
P4AUTH
設定で認証されたユーザの名前を変更する場合、 使用を認められたサーバごとにp4 renameuser
コマンドを実行する必要があります。- Perforce Swarmでは、名前が変更されたユーザのリファレンスはすべて壊れます。回避策については、Perforceテクニカルサポートにお問い合わせください。
使用と制限事項
最善の結果を得るために以下のガイドラインに従ってください。
- このコマンドを使用する前に、
new
に指定するユーザ名が 既に存在していないことを確認してください。既存のユーザ名を使用すると、 既存のユーザのデータと名前を変更したユーザのデータがマージされる (このようなマージはシステムによってできる限り避けられますが)ことがあります。 - このコマンドを発行するユーザは、名前が変更されるユーザと同一であることは できません。
- このコマンドの実行時に、名前が変更されるユーザがサーバを 使用していないことが必要です。コマンドが完了した後、ユーザはログアウトして ログインし直す必要があります。
-
p4 renameuser
コマンドはアンロード済みのワークスペースを処理しません。 そのため、あらかじめすべてのユーザのワークスペースを再ロード (または削除)する必要があります。マルチサーバ環境には、ユーザが所有するローカルワークスペースや ローカルラベルが存在する場合があります。エッジサーバにバインドされているこれらの ワークスペースとラベルは、あらかじめ削除するか、コミットサーバに移動する必要があります。
中央認証サーバが
P4AUTH
を使用して構成されている場合、 両方のサーバでp4 renameuser
を個々に呼び出して ユーザ名を変更する必要があります。コマンドはどちらから先に実行しても構いません。 - ユーザによってサブミットされた
+k
タイプのファイルが$Author$
タグを含んでいる場合、 このコマンド後に不適切なダイジェストを持つようになります。 ユーザ名の変更後にダイジェストの値を再計算するには、p4 verify -v
を使用してください。
オプション
|
古いユーザ名。 |
|
新しいユーザ名。 |
|
このサーバで新規ユーザが既に使用されている場合に発生する可能性のある 予期せぬマージチェックを確認しないで実行するように、コマンドを強制します。 新規のユーザ名が1度も使用されていない場合、このオプションを使用して パフォーマンスを改善することができます。 |
|
「グローバルオプション」を参照してください。 |
使用上の注意点
ファイル引数でリビジョン指定子を使用できるか? | ファイル引数でリビジョン範囲を使用できるか? | 最低限必要なアクセスレベル |
---|---|---|
適用外 |
適用外 |
|
関連コマンド
ユーザ名の変更後に特定のファイルについてダイジェストの値を再計算する。 |
|
ユーザの作成またはユーザプリファレンスの管理を行う。 |
|
既存のユーザを一覧表示する。 |