OrphanedSid.psd1

@{
    RootModule = 'OrphanedSid.psm1'
    ModuleVersion = '1.1.0'
    GUID = '7d3f2a9e-5b61-4c08-9e4a-2f8c1b6d0a37'
    Author = 'Jeffrey Stuhr'
    CompanyName = 'Jeffrey Stuhr'
    Copyright = '(c) 2026 Jeffrey Stuhr. All rights reserved.'
    Description = 'Finds orphaned SIDs in Active Directory ACLs, removes them with a backup of every ACL it touches, and restores an ACL from that backup'

    # Windows PowerShell 5.1 is a real target: the RSAT ActiveDirectory module ships for it and
    # most domain-joined management hosts have nothing else installed.
    PowerShellVersion = '5.1'
    CompatiblePSEditions = @('Desktop', 'Core')

    # The ActiveDirectory module is Windows-only RSAT and is not on the Gallery, so it is checked
    # at run time by each command rather than declared here. Declaring it would make the module
    # unimportable, and the test suite unrunnable, on any host without RSAT.
    RequiredModules = @()

    FunctionsToExport = @(
        'Find-OrphanedSid'
        'Remove-OrphanedSid'
        'Restore-OrphanedSidBackup'
    )
    CmdletsToExport = @()
    VariablesToExport = @()
    AliasesToExport = @()

    PrivateData = @{
        PSData = @{
            Tags = @(
                'ActiveDirectory', 'AD', 'SID', 'OrphanedSID', 'ACL', 'Security', 'Permissions',
                'Cleanup', 'Audit', 'Compliance', 'Backup', 'Restore',
                'PSEdition_Desktop', 'PSEdition_Core', 'Windows'
            )
            LicenseUri = 'https://github.com/fadwen/OrphanedSid/blob/main/LICENSE'
            ProjectUri = 'https://github.com/fadwen/OrphanedSid'
            ReleaseNotes = @'
1.1.0 - Safer removal, faster detection, and fixes from testing against a live domain.
A SID is reported orphaned only when its deleted object is found or every directory lookup
completed and none found it. A SID whose lookup failed, including one from a trusted domain that
cannot be reached, is reported as Unverified (new VerificationStatus and VerificationError
properties) and is never removed. A live principal found among deleted-object search results is no
longer taken as deleted.
Remove-OrphanedSid takes one backup per object, removes all of that object's orphaned entries
together, and returns one RemovalOperationResult per object; restoring such an object now brings
back every removed entry. Inherited entries are left in place with a warning.
Detection is several times faster: on a lab domain controller a typical user object went from
941 ms to 96 ms on Windows PowerShell 5.1. An unreachable domain controller costs about 42 seconds
per SID instead of 3.5 minutes.
Pipeline input of Active Directory objects now works for all three commands. -MaxRetries now
sets the retries of each search-base read and SID lookup. Logging, configuration, backup
timestamps, correlation IDs and restore messages are corrected.
See CHANGELOG.md for every change and the issue behind it.
'@

            RequireLicenseAcceptance = $false
        }
    }
}