docs: refresh install, auth, troubleshooting for v0.62.0#451
Merged
Conversation
5 tasks
Phase 1: install & prerequisites - Mark PSGallery as not-updated past 0.60.4 (tracking #450), link issue from README, install.md, and docs landing page - Fix garbled "Windows Powershell PowerShell 7+" prereq; PS 7+ required for new installs, PS 5.1 still supported for older releases - Add SHA256 integrity verification snippet and version-check snippet - Add CHANGELOG release-notes link to docs landing page Phase 2: authentication & TLS - Document new -SkipCertificateCheck switch on New-TssSession (v0.62.0 RestSharp 112 stopped trusting self-signed certs by default) - Rename Login-SS profile sample to Connect-SS, add -IgnoreDefault param so the existing branch actually does something; fix duplicate-verb typo - New troubleshooting.md covering TLS 1.2 on PS 5.1, TaskCanceledException on self-signed certs, cast errors, and how to capture verbose logs Refs #450 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
…ificateCheck) - OtpCode parameter type changed Int32 -> String in v0.62.0 to preserve leading zeros (e.g. '012345'). Update SYNTAX and parameter table. - Document the new -SkipCertificateCheck switch (available in all parameter sets) added in v0.62.0 alongside the RestSharp 112 upgrade. Hand-edited rather than regenerated via build.ps1 because the docs build task strips Jekyll frontmatter from every cmdlet page (see #452). Refs #452 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
jagger
force-pushed
the
jagger/docs-refresh-v0.62.0
branch
from
391dea3 to
af43019
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Phase 1 + 2 of the v0.62.0 documentation refresh (see plan in tracking conversation).
Phase 1 — install & prerequisites:
Phase 2 — authentication & TLS:
+ "-SkipCertificateCheck" +switch on+ "New-TssSession" +(v0.62.0 RestSharp 112 stopped trusting self-signed certs by default)+ "Login-SS" +PowerShell-profile sample to+ "Connect-SS" +(approved verb) and add the missing+ "-IgnoreDefault" +switch parameter so the existing+ "if (-not $ignoreDefault)" +branch actually does something+ "docs/getting_started/troubleshooting.md" +covering TLS 1.2 on PS 5.1,+ "TaskCanceledException" +from self-signed certs, cast errors, and how to capture a verbose session for bug reportsOut of scope (separate PRs):
+ "New-TssSession.md" +platyPS regeneration for the+ "OtpCode" +int→string fix+ "event-pipeline" +folder renameRefs #450
Test plan
+ "Get-FileHash -Algorithm SHA256" +against the published zip+ "New-TssSession -SkipCertificateCheck" +against a self-signed lab Secret Server+ "Connect-SS" +profile sample loads cleanly when sourced into+ "$PROFILE" +Generated with Claude Code