Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
## Integration boundary review (unreleased)

- Archive Close-AzureSession in Legacy; document its missing Test-AzureSession dependency.
- Remove the obsolete Close-AzureSession helper and document service-specific authentication ownership.
- Remove the process-wide certificate-validation bypass snippet; retain Git history.
- Remove legacy New-ExchangeSession and Close-ExchangeSession; retain their Git history.
- Delegate Exchange Online connection management to ExchangeOnlineManagement.
Expand Down
82 changes: 0 additions & 82 deletions Legacy/Close-AzureSession.ps1

This file was deleted.

11 changes: 4 additions & 7 deletions Legacy/README.md
Original file line number Diff line number Diff line change
@@ -1,16 +1,13 @@
# Historical commands

These three commands are reference implementations, not a supported compatibility
These two commands are reference implementations, not a supported compatibility
layer. They are never loaded or exported by v3.

| Command | Status |
| --- | --- |
| New-StringEncryption | Historical unauthenticated encryption; use only to migrate existing data in a separate session |
| New-StringDecryption | Historical decryption; original passphrase/salt/vector required |
| Close-AzureSession | AzureAD dependency and absent Test-AzureSession helper |

See [the integration review](../docs/Integrations.md) before planning a replacement.
The root README documents supported encryption and script-context replacements.

The former Exchange session wrappers have been removed. Their source remains in Git
history; use ExchangeOnlineManagement directly for Exchange Online operations.
The former Exchange and AzureAD session wrappers have been removed. Their source
remains in Git history. Use ExchangeOnlineManagement or Microsoft Graph directly
for those services.
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -405,7 +405,7 @@ MyInvocation or silently return a module filename.
WinSCP/SCP and PGP/OpenPGP are separate module projects. No transfer backend or PGP
backend is bundled into this module; AES-GCM string encryption remains independent.

The AzureAD helper is historical source, not a supported session-management command.
The AzureAD helper has been removed; use Microsoft Graph or Microsoft Entra PowerShell directly.
The legacy Exchange wrappers have been removed; use ExchangeOnlineManagement
directly for Exchange Online. The process-wide certificate-bypass snippet has been
removed. Import regression tests verify that loading and reloading IT-ToolBox leaves
Expand Down
35 changes: 15 additions & 20 deletions docs/Integrations.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,36 +11,31 @@ their documented optional dependencies when explicitly invoked.
| --- | --- | --- |
| SCP / WinSCP | Excluded | Dedicated transfer module; no bundled WinSCP binaries here |
| PGP / OpenPGP | Excluded | Dedicated encryption module; backend design is separate from string AES-GCM |
| AzureAD session helper | Historical source in Legacy/ | Explicit Graph or Entra authentication for directory operations |
| AzureAD session helper | Removed | Use Microsoft Graph or Microsoft Entra PowerShell directly |
| Azure resource sessions | No wrapper | Az.Accounts owns its Azure context; it is distinct from Graph |
| Exchange Server remoting | Legacy wrappers removed | Use the documented Exchange Server management workflow for the target environment |
| Exchange Online | No wrapper | ExchangeOnlineManagement owns authentication and disconnection |
| Global certificate bypass | Removed | Configure certificate trust for the endpoint instead |

## Why the old session helpers are excluded

Close-AzureSession calls Test-AzureSession, which is absent from this repository,
and Disconnect-AzureAD. Microsoft documents migration from the deprecated AzureAD
module to Graph PowerShell; this is more than a command-name substitution.
Graph/Entra directory authentication and Az resource contexts are distinct. The old command must not be
aliased to a function that clears a different service's credentials or context.
The former Close-AzureSession helper called the absent Test-AzureSession command and
Disconnect-AzureAD. It has been removed from the current tree. Git history retains
the source for reference; it is not part of the supported v3 API.

New-ExchangeSession and Close-ExchangeSession have been removed from the repository's
current tree. Their historical implementations targeted on-premises remoting and
had credential handling, session-selection and error-reporting defects. Git history
retains the source if needed; they are not part of the supported v3 API.
Microsoft Graph and Microsoft Entra PowerShell own directory authentication. Az
PowerShell owns Azure resource contexts. These contexts are distinct and must be
managed explicitly by the service-specific module.

Use Connect-ExchangeOnline and Disconnect-ExchangeOnline directly from Microsoft's
New-ExchangeSession and Close-ExchangeSession have also been removed. Use
Connect-ExchangeOnline and Disconnect-ExchangeOnline directly from Microsoft's
ExchangeOnlineManagement module for Exchange Online. IT-ToolBox does not wrap these
commands, install that module or manage its sessions. Exchange Server on-premises
has a separate management workflow; ExchangeOnlineManagement is not a general
replacement for its remote PowerShell endpoint.

The removed Enable-SelfSignedCertificate snippet registered a type whose Ignore
method could accept every server certificate through ServicePointManager. The
filename suggested endpoint-specific self-signed certificate support, but the
implementation was a global validation bypass. No replacement bypass is provided.
The old source remains in Git history.
commands or install that module. Exchange Server on-premises has a separate
management workflow.

The removed Enable-SelfSignedCertificate snippet registered a global certificate
validation bypass. No replacement bypass is provided; configure certificate trust
for the endpoint instead.

## Requirements for future session wrappers

Expand Down