Applies changes from the main configuration to the database configuration (/UpdateDBCfg). A mandatory step after /db-load-cf, /db-load-xml, /db-load-git.
Usage
/db-update [database]
/db-update dev
/db-update dev -Dynamic+
Connection parameters
Read .v8-project.json from the project root. Take v8path (path to the platform) and resolve the database:
- If the user specified connection parameters (path, server) — use them directly
- If the user specified a database by name — search by id / alias / name in
.v8-project.json - If not specified — match the current Git branch with
databases[].branches - If the branch did not match — use
defaultIfv8pathis not set — auto-detection:Get-ChildItem "C:\Program Files\1cv8\*\bin\1cv8.exe" | Sort -Desc | Select -First 1If there is no file — suggest/db-list add. If the database used is not registered — after execution, suggest adding it via/db-list add.
Command
powershell.exe -NoProfile -File .claude/skills/db-update/scripts/db-update.ps1 <параметры>
Script parameters
| Parameter | Required | Description |
|---|---|---|
-V8Path <путь> |
no | Platform bin directory (or full path to 1cv8.exe) |
-InfoBasePath <путь> |
* | File database |
-InfoBaseServer <сервер> |
* | 1C server (for a server database) |
-InfoBaseRef <имя> |
* | Database name on the server |
-UserName <имя> |
no | User name |
-Password <пароль> |
no | Password |
-Extension <имя> |
no | Update extension |
-AllExtensions |
no | Update all extensions |
-Dynamic <+/-> |
no | + — dynamic update, - — disable |
-Server |
no | Server-side update |
-WarningsAsErrors |
no | Treat warnings as errors |
*— either-InfoBasePathis required, or the pair-InfoBaseServer+-InfoBaseRef
Background update (server database)
| Parameter | Description |
|---|---|
-BackgroundStart |
Start background update |
-BackgroundFinish |
Wait for completion |
-BackgroundCancel |
Cancel |
-BackgroundSuspend |
Suspend |
-BackgroundResume |
Resume |
Return codes
| Code | Description |
|---|---|
| 0 | Success |
| 1 | Error (see log) |
Warnings
- If the update is not dynamic — it will require exclusive access to the database (all users must log out)
- For server databases it is recommended
-Dynamic+for updating without downtime - If the data structure has changed significantly (deleting attributes, changing types), a dynamic update may be impossible
Examples
# Обычное обновление (файловая база)
powershell.exe -NoProfile -File .claude/skills/db-update/scripts/db-update.ps1 -InfoBasePath "C:\Bases\MyDB" -UserName "Admin"
# Динамическое обновление (серверная база)
powershell.exe -NoProfile -File .claude/skills/db-update/scripts/db-update.ps1 -InfoBaseServer "srv01" -InfoBaseRef "MyDB" -UserName "Admin" -Password "secret" -Dynamic "+"
# Обновление расширения
powershell.exe -NoProfile -File .claude/skills/db-update/scripts/db-update.ps1 -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -Extension "МоёРасширение"