docs: update cmdlet help via platyPS merge, fix generate-help.ps1

- generate-help.ps1: rewritten to use Update-MarkdownHelp (merge) by
  default, preserving hand-written descriptions and examples. Only
  New-MarkdownHelp on genuinely new cmdlets. -Force flag for full regen.
- docs/cmdlets: parameter metadata updated via platyPS merge, CRLF
  normalized to LF
- Removed stale Send-PveIso.md (cmdlet renamed to Send-PveFile)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
Clint Branham
2026-03-23 17:41:04 -05:00
parent d5f4e13637
commit f6a2f843db
90 changed files with 24596 additions and 3615 deletions
+145 -149
View File
@@ -31,78 +31,13 @@ PS C:\> New-PveFirewallRule -Level Cluster -Type in -Action ACCEPT -Proto tcp -D
## PARAMETERS
### -Level
The firewall level: Cluster, Node, Vm, or Container.
```yaml
Type: String
Parameter Sets: (All)
Aliases:
Accepted values: Cluster, Node, Vm, Container
Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```
### -Node
The node name. Required when Level is Node, Vm, or Container.
```yaml
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```
### -VmId
The VM/Container ID. Required when Level is Vm or Container.
```yaml
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```
### -Type
The rule type: in, out, or group.
```yaml
Type: String
Parameter Sets: (All)
Aliases:
Accepted values: in, out, group
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```
### -Action
The rule action: ACCEPT, DROP, or REJECT.
```yaml
Type: String
Parameter Sets: (All)
Aliases:
Aliases:
Accepted values: ACCEPT, DROP, REJECT
Required: True
@@ -112,13 +47,13 @@ Accept pipeline input: False
Accept wildcard characters: False
```
### -Enable
Enable the rule.
### -Comment
Rule comment.
```yaml
Type: SwitchParameter
Type: String
Parameter Sets: (All)
Aliases:
Aliases:
Required: False
Position: Named
@@ -127,13 +62,13 @@ Accept pipeline input: False
Accept wildcard characters: False
```
### -Source
Source address or alias.
### -Confirm
Prompts you for confirmation before running the cmdlet.
```yaml
Type: String
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Aliases: cf
Required: False
Position: Named
@@ -148,22 +83,7 @@ Destination address or alias.
```yaml
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```
### -Proto
Protocol (e.g., tcp, udp, icmp).
```yaml
Type: String
Parameter Sets: (All)
Aliases:
Aliases:
Required: False
Position: Named
@@ -178,7 +98,7 @@ Destination port.
```yaml
Type: String
Parameter Sets: (All)
Aliases:
Aliases:
Required: False
Position: Named
@@ -187,58 +107,13 @@ Accept pipeline input: False
Accept wildcard characters: False
```
### -Sport
Source port.
### -Enable
Enable the rule.
```yaml
Type: String
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```
### -Comment
Rule comment.
```yaml
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```
### -Macro
Macro name.
```yaml
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```
### -Log
Log level.
```yaml
Type: String
Parameter Sets: (All)
Aliases:
Aliases:
Required: False
Position: Named
@@ -253,7 +128,83 @@ Network interface.
```yaml
Type: String
Parameter Sets: (All)
Aliases:
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```
### -Level
The firewall level: Cluster, Node, Vm, or Container.
```yaml
Type: String
Parameter Sets: (All)
Aliases:
Accepted values: Cluster, Node, Vm, Container
Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```
### -Log
Log level.
```yaml
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```
### -Macro
Macro name.
```yaml
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```
### -Node
The node name. Required when Level is Node, Vm, or Container.
```yaml
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```
### -Proto
Protocol (e.g., tcp, udp, icmp).
```yaml
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
@@ -277,13 +228,13 @@ Accept pipeline input: False
Accept wildcard characters: False
```
### -WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
### -Source
Source address or alias.
```yaml
Type: SwitchParameter
Type: String
Parameter Sets: (All)
Aliases: wi
Aliases:
Required: False
Position: Named
@@ -292,13 +243,59 @@ Accept pipeline input: False
Accept wildcard characters: False
```
### -Confirm
Prompts you for confirmation before running the cmdlet.
### -Sport
Source port.
```yaml
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```
### -Type
The rule type: in, out, or group.
```yaml
Type: String
Parameter Sets: (All)
Aliases:
Accepted values: in, out, group
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```
### -VmId
The VM/Container ID. Required when Level is Vm or Container.
```yaml
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```
### -WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
```yaml
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Aliases: wi
Required: False
Position: Named
@@ -325,7 +322,6 @@ Accept wildcard characters: False
### CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
## INPUTS
### None