internal/Tag-Command.ps1
function Invoke-TagCommand ([string]$Tag, [string]$Keyword) { <# .SYNOPSIS An internal command, feel free to ignore. .EXAMPLE Tag-Command -Tag Restore -Keyword Restore Tag-Command -Tag Backup -Keyword Backup Tag-Command -Tag Orphan -Keyword Orphan Tag-Command -Tag DisasterRecovery -Keyword Attach Tag-Command -Tag DisasterRecovery -Keyword Detach Tag-Command -Tag Snapshot -Keyword Snapshot Tag-Command -Tag Memory -Keyword Memory Tag-Command -Tag DisasterRecovery -Keyword Restore Tag-Command -Tag DisasterRecovery -Keyword Backup Tag-Command -Tag Storage -Keyword disk Tag-Command -Tag Storage -Keyword storage Tag-Command -Tag Migration -Keyword "Copy-" Tag-Command -Tag SPN -Keyword Kerberos Tag-Command -Tag SPN -Keyword SPN Tag-Command -Tag CIM -Keyword CimSession Tag-Command -Tag SQLWMI -Keyword Invoke-ManagedComputerCommand Tag-Command -Tag WSMan -Keyword Invoke-Command #> $tagsRex = ([regex]'(?m)^[\s]{0,15}Tags:(.*)$') $modulepath = (Get-Module -Name dbatools).Path $directory = Split-Path $modulepath $basedir = "$directory\functions\" Import-Module $modulepath -force $allfiles = Get-ChildItem $basedir foreach ($f in $allfiles) { if ($f -eq "Find-DbaCommand.ps1") { continue } $content = Get-Content $f.fullname if ($content -like "*$keyword*") { Write-Warning "$f needs a tag tag" $cmdname = $f.name.replace('.ps1', '') $fullhelp = get-help $cmdname -full $as = $fullhelp.alertset | out-string $tags = $tagsrex.Match($as).Groups[1].Value if ($tags) { $tags = $tags.ToString().split(',').Trim() Write-Warning "adding tags to existing ones" if ($tag -in $tags) { Write-Warning "tag $tag is already present" continue } $out = @() foreach ($line in $content) { if ($line.trim().startsWith('Tags:')) { $out += "$line, $tag" } else { $out += $line } } Write-Warning "replacing content into $($f.fullname)" $out -join "`r`n" | Set-Content $f.fullname -Encoding UTF8 } else { Write-warning "need to add tags" $out = @() foreach ($line in $content) { if ($line.startsWith('.NOTES')) { $out += '.NOTES' $out += "Tags: $tag" } else { $out += $line } } Write-Warning "replacing content into $($f.fullname)" $out -join "`r`n" | Set-Content $f.fullname -Encoding UTF8 } } } } |