igodwin
6df8a53196
- Move _template.ps1 and cg-disable.ps1 into scripts/ - Update all fetch/run URLs and doc links to scripts/ paths - Rework README layout/naming section; add as-is/no-warranty disclaimer Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
61 lines
2.0 KiB
PowerShell
61 lines
2.0 KiB
PowerShell
<#
|
|
.SYNOPSIS
|
|
One-line description of what this runbook script does.
|
|
|
|
.DESCRIPTION
|
|
Longer context: symptom it addresses, what it changes, whether it reboots.
|
|
|
|
.NOTES
|
|
Convention for scripts in this repo — designed to run via:
|
|
irm https://gitea.ivangodwin.com/ops/rb/raw/branch/main/scripts/<file>.ps1 | iex
|
|
|
|
Because `irm | iex` runs in the caller's session:
|
|
- No param() block — you can't pass args through the pipe. Prompt with
|
|
Read-Host instead.
|
|
- #Requires is NOT enforced under iex — check for admin manually below.
|
|
- Keep it self-contained: no external module installs, no dot-sourcing.
|
|
|
|
PUBLIC REPO: placeholders only. Never hard-code a client, host, user, or
|
|
secret. Prompt for them at run time.
|
|
#>
|
|
|
|
$ErrorActionPreference = 'Stop'
|
|
|
|
# --- Admin check (do not rely on #Requires under iex) ---
|
|
$isAdmin = ([Security.Principal.WindowsPrincipal] `
|
|
[Security.Principal.WindowsIdentity]::GetCurrent()
|
|
).IsInRole([Security.Principal.WindowsBuiltinRole]::Administrator)
|
|
if (-not $isAdmin) {
|
|
Write-Warning 'This script needs an elevated PowerShell session. Re-run as Administrator.'
|
|
return
|
|
}
|
|
|
|
Write-Host '== <SCRIPT TITLE> ==' -ForegroundColor Cyan
|
|
|
|
# --- Prompt for placeholders (no param block; iex-safe) ---
|
|
$server = Read-Host 'Server hostname <SERVER>'
|
|
$shareUser = Read-Host 'Share account <SHARE_USER>'
|
|
# For secrets, use -AsSecureString and never echo or persist them:
|
|
# $secure = Read-Host 'Password <PASSWORD>' -AsSecureString
|
|
|
|
# --- Confirm before destructive / disruptive actions ---
|
|
Write-Host ''
|
|
Write-Host "About to: <describe the change> on $server" -ForegroundColor Yellow
|
|
if ((Read-Host 'Proceed? (y/N)') -ne 'y') {
|
|
Write-Host 'Aborted. No changes made.'
|
|
return
|
|
}
|
|
|
|
# --- Do the work ---
|
|
try {
|
|
# ... the actual commands ...
|
|
Write-Host 'Done.' -ForegroundColor Green
|
|
}
|
|
catch {
|
|
Write-Warning "Failed: $($_.Exception.Message)"
|
|
return
|
|
}
|
|
|
|
# --- If a reboot is required, confirm separately ---
|
|
# if ((Read-Host 'Reboot now to apply? (y/N)') -eq 'y') { shutdown /r /t 0 }
|