WinProfileOps

0.2.0-preview0002

The WinProfileOps module provides an essential toolkit for managing Windows user profiles across local and remote computers. This module automates complex profile management tasks such as detecting orphaned profiles, validating profile paths, and removing stale or corrupted profiles. It handles both filesystem and registry operations, leveraging its dependency on WinR
The WinProfileOps module provides an essential toolkit for managing Windows user profiles across local and remote computers. This module automates complex profile management tasks such as detecting orphaned profiles, validating profile paths, and removing stale or corrupted profiles. It handles both filesystem and registry operations, leveraging its dependency on WinRegOps for registry-related functions.

WinProfileOps integrates with WinRegOps to seamlessly manage profiles by querying, validating, and deleting user profile-related data from the Windows registry. This module is ideal for system administrators seeking to streamline profile management operations, especially in environments with numerous users and computers.

Dependencies:
- WinRegOps: The WinProfileOps module depends on WinRegOps for registry operations such as querying, opening, and modifying registry keys related to user profiles.

Key features:
- Retrieve user profile information from both the registry and file system (local and remote).
- Detect orphaned profiles (e.g., missing profile folders or registry entries).
- Remove orphaned or unused profiles from the system.
- Filter and exclude special accounts like system or service accounts.
- Built-in support for remote profile management.
- Error handling for permission issues or unreachable systems.
- Class-based profile objects for easy integration with other automation tasks.

Typical use cases include:
- Cleaning up orphaned user profiles after system migrations or user deactivations.
- Automating the detection and removal of stale profiles on local and remote systems.
- Managing user profiles in large-scale, multi-user environments (e.g., terminal servers, Citrix environments).
- Excluding system accounts from profile cleanup operations, ensuring important profiles remain intact.
- Providing profile management capabilities as part of system maintenance routines.
Show more

Minimum PowerShell version

5.1

This is a prerelease version of WinProfileOps.
There is a newer prerelease version of this module available.
See the version list below for details.

Installation Options

Copy and Paste the following command to install this package using PowerShellGet More Info

Install-Module -Name WinProfileOps -RequiredVersion 0.2.0-preview0002 -AllowPrerelease

Copy and Paste the following command to install this package using Microsoft.PowerShell.PSResourceGet More Info

Install-PSResource -Name WinProfileOps -Version 0.2.0-preview0002 -Prerelease

You can deploy this package directly to Azure Automation. Note that deploying packages with dependencies will deploy all the dependencies to Azure Automation. Learn More

Manually download the .nupkg file to your system's default download location. Note that the file won't be unpacked, and won't include any dependencies. Learn More

Owners

Copyright

(c) 2024 LarryWisherMan. All rights reserved.

Package Details

Author(s)

  • LarryWisherMan

Tags

WindowsProfiles ProfileManagement OrphanedProfiles RegistryOperations FilesystemOperations RemoteManagement UserProfiles ProfileCleanup WindowsRegistry SystemAdministration Automation ProfileValidation WindowsManagement ITAdministration UserProfileTools

Functions

Get-AllUserProfiles Get-OrphanedProfiles Get-SIDProfileInfo Get-UserFolders Get-UserProfilesFromFolders Get-UserProfilesFromRegistry Remove-OrphanedProfiles Remove-ProfilesForSIDs

Dependencies

Release Notes

## [0.2.0-preview0002] - 2024-09-11

### Added

- Added core functions
- configured `WinRegOps` as a dependant module
- Updated build file for release

- Comment-based help documentation added for the following public functions:
 - `Get-AllUserProfiles`
 - `Get-OrphanedProfiles`
 - `Remove-OrphanedProfiles`
 - `Remove-SIDProfile`
 - `Get-UserProfileFolders`
 - `Get-RegistryUserProfiles`
 - `Get-UserFolders`
 - `Get-SIDProfileInfo`

- Comment-based help documentation added for the following public functions:
- `New-UserProfileObject`
- `Remove-RegistryKeyForSID`
- `Remove-ProfilesForSIDs`
- `Get-RegistryKeyForSID`
- `Get-ProfilePathFromSID`
- `Test-FolderExists`
- `Test-OrphanedProfile`
- `Test-SpecialAccount`

- Implemented and completed Unit Tests for private functions

FileList

Version History

Version Downloads Last updated
0.3.0-previe... 4 10/1/2024
0.3.0-previe... 4 10/1/2024
0.3.0-previe... 3 10/1/2024
0.3.0-previe... 4 9/24/2024
0.3.0-previe... 3 9/24/2024
0.3.0-previe... 3 9/16/2024
0.3.0-previe... 4 9/12/2024
0.2.0 13 9/12/2024
0.2.0-previe... 2 9/12/2024
0.2.0-previe... (current version) 2 9/11/2024
0.2.0-previe... 3 9/9/2024
Show less