DSInternals PowerShell Module

package           : tis-dsinternals
version           : 5.1-2
architecture      : all
section           : base
priority          : optional
name              : DSInternals PowerShell Module
categories        : Utilities
maintainer        : WAPT Team,Tranquil IT,Clément Baziret
description       : The DSInternals PowerShell Module exposes several internal features of Active Directory and Azure Active Directory
depends           : tis-powershell,tis-dotnetfx
conflicts         : 
maturity          : PROD
locale            : all
target_os         : windows
min_wapt_version  : 2.3
sources           : https://github.com/MichaelGrafnetter/DSInternals/
installed_size    : 
impacted_process  : 
description_fr    : Le module PowerShell DSInternals expose plusieurs fonctionnalités internes d'Active Directory et d'Azure Active Directory
description_pl    : Moduł PowerShell DSInternals udostępnia kilka wewnętrznych funkcji Active Directory i Azure Active Directory
description_de    : Das DSInternals PowerShell-Modul macht mehrere interne Funktionen von Active Directory und Azure Active Directory zugänglich
description_es    : El módulo PowerShell de DSInternals expone varias características internas de Active Directory y Azure Active Directory
description_pt    : O Módulo PowerShell DSInternals expõe várias funcionalidades internas do Active Directory e do Azure Active Directory
description_it    : Il modulo PowerShell DSInternals espone diverse funzionalità interne di Active Directory e Azure Active Directory
description_nl    : De DSInternals PowerShell-module legt verschillende interne functies van Active Directory en Azure Active Directory bloot
description_ru    : Модуль DSInternals PowerShell раскрывает несколько внутренних возможностей Active Directory и Azure Active Directory
audit_schedule    : 
editor            : 
keywords          : dsinternals,powershell,module,exposes,several,internal,features,active,directory,azure,active,directory
licence           : opensource_free,wapt_public
homepage          : https://www.powershellgallery.com/packages/DSInternals/
package_uuid      : 64330650-afbb-43c8-855e-6378821b115b
valid_from        : 
valid_until       : 
forced_install_on : 
changelog         : https://github.com/MichaelGrafnetter/DSInternals/releases
min_os_version    : 6.1
max_os_version    : 
icon_sha256sum    : 8f14830d6e9a8d005ea600473e5ecfdd3c7dbb6b0899a44e8f1d040a6b1f7162
signer            : Tranquil IT
signer_fingerprint: 8c5127a75392be9cc9afd0dbae1222a673072c308c14d88ab246e23832e8c6bb
signature_date    : 2025-03-27T17:11:14.000000
signed_attributes : package,version,architecture,section,priority,name,categories,maintainer,description,depends,conflicts,maturity,locale,target_os,min_wapt_version,sources,installed_size,impacted_process,description_fr,description_pl,description_de,description_es,description_pt,description_it,description_nl,description_ru,audit_schedule,editor,keywords,licence,homepage,package_uuid,valid_from,valid_until,forced_install_on,changelog,min_os_version,max_os_version,icon_sha256sum,signer,signer_fingerprint,signature_date,signed_attributes
signature         : BRmvEUebum3tasNh4OQubIHLW6nToAi4PNqy09f0Iem1OOYF4sC4oM+CvEiO6fDkAh9mhHjics7PT6VfwWI1Z5GY0GayMjhsI2izaN7RuG/YBg5dKSB4GzWq7P3iZV6c0eoAZKsoWZstgp1m4slZPp8BHpUpnXM+60k54kQZ5WGvhlsbIQVFzfdw2n6mJVoYmuxMslMIn8IkwsP8jSMw0AVMUAC7dH6OmwdnNOK3JljeZqvj/Lsn/nBXg08quljwfVmvewD57VUYpiiJRftKPOM6yeQIQLlAR5tlpjSNSlJQWAzeGSvIg71kCxLcQ3iEjJ5kRlz8ZfcONcRbUEZw1g==

# -*- coding: utf-8 -*-
from setuphelpers import *
import os
import shutil


app_name = "DSInternals"
app_dir = makepath(system32(), "WindowsPowerShell", "v1.0", "Modules", app_name)


def install():
    # Declaring local variables
    package_version = control.get_software_version()
    zip_name = glob.glob(app_name + "*.zip")[0]

    print("Installing: %s (%s)" % (app_name, control.get_software_version()))
    if isdir(app_dir):
        remove_tree(app_dir)
    mkdirs(app_dir)

    # unziping archive and moving it to powershell modules folder
    print("Extracting: %s to: %s" % (zip_name, app_dir))
    unzipped_dir = zip_name.rsplit(".", 1)[0]
    unzip(zip_name, unzipped_dir)
    move_directory(makepath(unzipped_dir, app_name), app_dir)
    remove_tree(unzipped_dir)


def audit():
    # Declaring local variables
    package_version = control.get_software_version()

    if not isdir(app_dir):
        print("%s is not installed" % app_name)
        return "ERROR"

    name = get_powershell_str("Get-Module -ListAvailable -Name %s" % app_name)
    if name != app_name:
        print("%s is not installed" % app_name)
        return "ERROR"

    version = get_powershell_str("Get-Module -ListAvailable -Name %s" % app_name, "Version")
    if Version(package_version) != Version(version):
        print("%s is installed but not up-to-date" % app_name)
        return "WARNING"

    # if everything is OK :
    print("%s (%s) is installed" % (app_name, package_version))
    return "OK"


def uninstall():
    # Uninstalling software
    if isdir(app_dir):
        remove_tree(app_dir)


def move_directory(source, destination):
    """
    Moves a directory safely, avoiding unnecessary subfolders.

    Args:
        source (str): The path of the directory to move.
        destination (str): The destination path where the directory will be moved to.

    Returns:
        bool: True if the directory was successfully moved, False otherwise.
    """
    try:
        if not os.path.exists(destination):
            os.makedirs(destination)

        for item in os.listdir(source):
            item_path = os.path.join(source, item)
            if os.path.isfile(item_path):
                shutil.move(item_path, destination)
            elif os.path.isdir(item_path):
                new_destination = os.path.join(destination, item)
                move_directory(item_path, new_destination)

        os.rmdir(source)
        return True
    except Exception as e:
        print(f"ERROR: {e}")
        return False

# -*- coding: utf-8 -*-
from setuphelpers import *


def update_package():
    # Declaring local variables
    package_updated = False
    proxies = get_proxies()
    if not proxies:
        proxies = get_proxies_from_wapt_console()
    api_url = "https://api.github.com/repos/MichaelGrafnetter/DSInternals/releases/latest"

    # Getting latest version information from official sources
    print("API used is: %s" % api_url)
    json_load = wgets(api_url, proxies=proxies, as_json=True)
    version = json_load["tag_name"].replace("v", "")
    for to_download in json_load["assets"]:
        if "DSInternals" in to_download["name"] and ".zip" in to_download["name"]:
            download_url = to_download["browser_download_url"]
            latest_bin = to_download["name"]
            break

    # Downloading latest binaries
    print("Latest %s version is: %s" % (control.name, version))
    print("Download URL is: %s" % download_url)
    if not isfile(latest_bin):
        print("Downloading: %s" % latest_bin)
        wget(download_url, latest_bin, proxies=proxies)
    else:
        print("Binary is present: %s" % latest_bin)

    # Deleting outdated binaries
    remove_outdated_binaries(latest_bin)

    # Changing version of the package
    if Version(version, 4) > Version(control.get_software_version(), 4):
        print("Software version updated (from: %s to: %s)" % (control.get_software_version(), Version(version)))
        package_updated = True
    else:
        print("Software version up-to-date (%s)" % Version(version))
    control.set_software_version(version)
    control.save_control_to_wapt()

    # Validating update-package-sources
    return package_updated

22477d55c1bcba2762740baa1d1df426f5a67d16251e1796ed4d1db60ca94965 : DSInternals_v5.1.zip
38d056ab130f7bf7c481c12636a4e9959de36561d3dfcbe54c6e3571bc0c1dc3 : WAPT/certificate.crt
c9655fd01b02c3d854c361c083b17ed6ddc3d4dcbce6c36285a2fb5d158f0534 : WAPT/control
8f14830d6e9a8d005ea600473e5ecfdd3c7dbb6b0899a44e8f1d040a6b1f7162 : WAPT/icon.png
e1a922e60556218ab81aadbf42501087bbf0e7f13b02423da58fb5dcc1250c11 : luti.json
90fe5908d340cf3fbdf1f36ade0976a51cd90d81aca4320880d0fee37a345a6a : setup.py
8de655386ae3cea23e8151f9432ea7577df95bc95fddeb2bf7765fbad2ba17d7 : update_package.py