test: add ShouldProcess and comment-based-help coverage sweeps, and fix the gaps they find

Public/Array/Remove-PfbArrayErasure.ps1

@@ -5,8 +5,6 @@ function Remove-PfbArrayErasure {
     .DESCRIPTION
         The Remove-PfbArrayErasure cmdlet deletes an array erasure job from the connected
         Pure Storage FlashBlade. This cmdlet has a high confirm impact.
-    .PARAMETER Attributes
-        A hashtable identifying the erasure job to remove.
     .PARAMETER Array
         The FlashBlade connection object. If not specified, the default connection is used.
     .EXAMPLE

Public/Context/Clear-PfbContext.ps1

@@ -6,6 +6,9 @@ function Clear-PfbContext {
         Its own cmdlet rather than a -Clear switch, matching the Set-/Clear-PfbCredential
         precedent, and because @() must keep its distinct "run this one call locally" meaning
         at the Invoke-PfbInContext layer. Copy-on-write, like Set-PfbContext. No network call.
+    .PARAMETER Array
+        The FlashBlade connection to copy. Defaults to the current default connection. The
+        object passed in is never mutated -- the context-free copy is returned instead.
     #>
     [CmdletBinding()]
     [OutputType([PSCustomObject])]

Public/Context/Invoke-PfbInContext.ps1

@@ -14,6 +14,21 @@ function Invoke-PfbInContext {
         Non-pipeable by design: its pipeline payload would have to be the scriptblock, which
         no cmdlet emits. The blessed form is
         -Context (Get-PfbFleetMember -FleetName 'x').member.name
+    .PARAMETER Array
+        The FlashBlade connection the ambient context is pushed onto for the duration of the
+        block. Required -- pass a connection object from Connect-PfbArray.
+    .PARAMETER Context
+        One or more Fusion context names to apply for the duration of the block. Required.
+        Pass @() to run the block against the local array, which is distinct from setting no
+        context at all.
+    .PARAMETER ScriptBlock
+        The block to run under the context. Positional (position 0) and required. The previous
+        context is restored in a finally, so it survives an exception thrown inside the block.
+    .PARAMETER Kind
+        What the names in -Context identify: an individual array ('Array', the default), a
+        fleet ('Fleet'), or a topology group ('TopologyGroup').
+    .PARAMETER AllArrays
+        Applies the fleet-wide "all arrays" context form instead of naming members individually.
     .NOTES
         Concurrency: .ContextOverride lives on the shared connection object, so concurrent
         workers pushing overrides on the SAME connection race. Set the context before forking

Public/Context/Set-PfbContext.ps1

@@ -22,6 +22,21 @@ function Set-PfbContext {
         failure is swallowed, leaving the locality indeterminate and this cmdlet permissive. Under a
         management-access policy that denies GET /admins it can cost ~3 round trips rather than 1.
         Worth knowing before calling this in a loop over many members: cheap, but not free.
+    .PARAMETER Array
+        The FlashBlade connection to copy. Defaults to the current default connection. The
+        object passed in is never mutated -- the modified copy is returned instead.
+    .PARAMETER Context
+        One or more Fusion context names to set on the returned connection. Accepts pipeline
+        input, including from Get-PfbFleetMember and Get-PfbFleet. Pass no value at all to get
+        the explicit "requires -Context" error; to run locally instead, use Clear-PfbContext.
+    .PARAMETER Kind
+        What the names in -Context identify: an individual array ('Array', the default), a
+        fleet ('Fleet'), or a topology group ('TopologyGroup').
+    .PARAMETER AllArrays
+        Sets the fleet-wide "all arrays" context form instead of naming members individually.
+    .PARAMETER AllowErrors
+        Reserved for Phase 2. Accepted and stored on the returned connection; nothing is
+        injected on the wire for it yet.
     .NOTES
         Mixed-platform fleets: Get-PfbFleetMember will happily return FlashArrays. Piping
         those in is not supported -- cross-platform context is a non-goal (open question 5).

Public/Monitoring/Get-PfbLog.ps1

@@ -6,6 +6,12 @@ function Get-PfbLog {
         The Get-PfbLog cmdlet returns log entries from the connected Pure Storage FlashBlade.
         Results can be narrowed using a server-side filter expression and sorted or limited
         as needed.
+    .PARAMETER StartTime
+        Start of the time window, in milliseconds since the Unix epoch. Defaults to one hour
+        ago. Always sent, whether or not it is supplied.
+    .PARAMETER EndTime
+        End of the time window, in milliseconds since the Unix epoch. Defaults to now. Always
+        sent, whether or not it is supplied.
     .PARAMETER Filter
         A server-side filter expression to narrow results (e.g., "severity='warning'").
     .PARAMETER Sort

Public/Replication/Get-PfbRemoteArray.ps1

@@ -16,6 +16,11 @@ function Get-PfbRemoteArray {
         Sort field and direction (e.g., "name" or "name-").
     .PARAMETER Limit
         Maximum number of entries to return.
+    .PARAMETER CurrentFleetOnly
+        Restricts results to remote arrays in the current fleet. Defaults to $true, so pass
+        -CurrentFleetOnly:$false to include arrays outside it. A scope flag rather than a
+        selector: it is written on every path and never counts as "a selector reached the
+        query".
     .PARAMETER Array
         The FlashBlade connection object. If not specified, the default connection is used.
     .EXAMPLE

Public/Support/Update-PfbSupport.ps1

@@ -1,4 +1,23 @@
 function Update-PfbSupport {
+    <#
+    .SYNOPSIS
+        Updates support configuration on a FlashBlade array.
+    .DESCRIPTION
+        The Update-PfbSupport cmdlet modifies the support configuration -- Phone Home, Remote
+        Assist and related settings -- on the connected FlashBlade.
+    .PARAMETER Attributes
+        A hashtable of support attributes to modify.
+    .PARAMETER Array
+        The FlashBlade connection object. If not specified, the default connection is used.
+    .EXAMPLE
+        Update-PfbSupport -Attributes @{ phonehome_enabled = $true }
+
+        Enables Phone Home.
+    .EXAMPLE
+        Update-PfbSupport -Attributes @{ remote_assist_active = $false } -WhatIf
+
+        Shows what would happen without actually updating the support configuration.
+    #>
     [CmdletBinding(SupportsShouldProcess, ConfirmImpact = 'Medium')]
     param(
         [Parameter(Mandatory)] [hashtable]$Attributes,

Reports/PfbApiDriftReport.json

@@ -7513,7 +7513,7 @@
           "enumStatus": "no-spec-enum-found",
           "target": {
             "file": "Public/Support/Update-PfbSupport.ps1",
-            "paramBlockLine": 5,
+            "paramBlockLine": 24,
             "payloadVariable": "Attributes",
             "assignmentStyle": "attributesOnly",
             "hasAttributes": true
@@ -7530,7 +7530,7 @@
           "enumStatus": "no-spec-enum-found",
           "target": {
             "file": "Public/Support/Update-PfbSupport.ps1",
-            "paramBlockLine": 5,
+            "paramBlockLine": 24,
             "payloadVariable": "Attributes",
             "assignmentStyle": "attributesOnly",
             "hasAttributes": true
@@ -7547,7 +7547,7 @@
           "enumStatus": "no-spec-enum-found",
           "target": {
             "file": "Public/Support/Update-PfbSupport.ps1",
-            "paramBlockLine": 5,
+            "paramBlockLine": 24,
             "payloadVariable": "Attributes",
             "assignmentStyle": "attributesOnly",
             "hasAttributes": true
@@ -7564,7 +7564,7 @@
           "enumStatus": "no-spec-enum-found",
           "target": {
             "file": "Public/Support/Update-PfbSupport.ps1",
-            "paramBlockLine": 5,
+            "paramBlockLine": 24,
             "payloadVariable": "Attributes",
             "assignmentStyle": "attributesOnly",
             "hasAttributes": true
@@ -7581,7 +7581,7 @@
           "enumStatus": "no-spec-enum-found",
           "target": {
             "file": "Public/Support/Update-PfbSupport.ps1",
-            "paramBlockLine": 5,
+            "paramBlockLine": 24,
             "payloadVariable": "Attributes",
             "assignmentStyle": "attributesOnly",
             "hasAttributes": true
@@ -7598,7 +7598,7 @@
           "enumStatus": "no-spec-enum-found",
           "target": {
             "file": "Public/Support/Update-PfbSupport.ps1",
-            "paramBlockLine": 5,
+            "paramBlockLine": 24,
             "payloadVariable": "Attributes",
             "assignmentStyle": "attributesOnly",
             "hasAttributes": true