Files
powershell-scripts/registry-backup/README.md
cproudlock fc6be8a876 Update READMEs to emphasize batch files as entry points
Each folder README now has:
- Quick Start section with batch file commands
- Batch Launchers table listing entry points
- PowerShell Scripts section for detailed documentation

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-10 11:02:47 -05:00

126 lines
2.9 KiB
Markdown

# Registry Backup Scripts
Scripts for backing up GE Aircraft Engines registry keys for disaster recovery and auditing.
## Quick Start
```batch
Backup-GERegistry.bat
```
Or with custom backup path:
```batch
Backup-GERegistry.bat "\\server\share\backups"
```
---
## Batch Launchers (Entry Points)
| Batch File | Purpose |
|------------|---------|
| `Backup-GERegistry.bat` | Main launcher for registry backup |
---
## PowerShell Scripts
### Backup-GERegistry.ps1
**GE Registry backup utility** - Backs up GE Aircraft Engines registry keys from both 32-bit and 64-bit locations.
**What it does:**
1. Reads machine number from GE registry or extracts from hostname
2. Gets serial number from BIOS
3. Exports registry keys from both locations:
- `HKLM:\Software\GE Aircraft Engines` (32-bit)
- `HKLM:\Software\WOW6432Node\GE Aircraft Engines` (64-bit)
4. Saves backup files to network share
**Usage:**
```powershell
# Interactive backup with console output
.\Backup-GERegistry.ps1
# Silent backup (for scheduled tasks)
.\Backup-GERegistry.ps1 -Silent
# Custom backup path
.\Backup-GERegistry.ps1 -BackupPath "\\server\share\backups"
```
**Parameters:**
| Parameter | Default | Description |
|-----------|---------|-------------|
| `-BackupPath` | `S:\DT\cameron\scan\backup\reg` | Network path for backup files |
| `-Silent` | `$false` | Suppress console output |
**Output Filename Format:**
```
[machinenumber-]serialnumber-YYYY-MM-DD.reg
Examples:
3104-G4B48FZ3ESF-2025-12-10.reg
7402-G9WP26X3ESF-2025-12-10.reg
```
**Registry Keys Backed Up:**
- DNC Configuration (EFOCAS, SERIAL, NTSHR, etc.)
- DualPath settings (Path1Name, Path2Name)
- Machine number assignments
- Communication settings
- All GE Aircraft Engines subkeys
---
## Batch File Launchers
| File | Purpose |
|------|---------|
| `Backup-GERegistry.bat` | Standard launcher for registry backup |
---
## Requirements
- PowerShell 5.1 or later
- Read access to registry
- Write access to backup network share
- Works without administrator privileges (registry read-only)
## Use Cases
### Manual Backup Before Changes
```powershell
# Before making registry changes, create a backup
.\Backup-GERegistry.ps1
```
### Automated Scheduled Backup
```powershell
# In scheduled task, run silently
.\Backup-GERegistry.ps1 -Silent
```
### Restore from Backup
```cmd
# Double-click the .reg file or run:
regedit /s "\\server\share\backups\3104-G4B48FZ3ESF-2025-12-10.reg"
```
## Backup Contents
The backup `.reg` file includes:
- Complete GE Aircraft Engines registry tree
- DNC service configurations
- Machine communication settings
- Serial port assignments
- DualPath configurations
- Custom GE software settings
## Important Notes
- Backups are named with machine number (if available) for easy identification
- Both 32-bit and 64-bit registry locations are exported
- Existing backups are not overwritten (date is included in filename)
- Silent mode is recommended for scheduled tasks to avoid interrupting users