SystemManagementExtension

public static class SystemManagementExtension

1. Methods

1.1. BeepLong(int)

public static void BeepLong(int times)
Table 1. Parameters
Name Type Description

times

int

1.2. BeepShort(int)

public static void BeepShort(int times)
Table 2. Parameters
Name Type Description

times

int

1.3. CreateWinPEAgnosticPowershellBuilder(ISystemHost)

public static PowershellCommand.Builder CreateWinPEAgnosticPowershellBuilder(this ISystemHost host)
Table 3. Parameters
Name Type Description

host

ISystemHost

Returns: PowershellCommand.Builder

1.4. EnableWOL(ISystemHost, string)

Enables Wake-on-LAN on a network interface.

public static void EnableWOL(ISystemHost host, string interfaceName)
Table 4. Parameters
Name Type Description

host

ISystemHost

interfaceName

string

Name of the network interface (e.g., "Ethernet", "eth0")

1.5. GetFixedDisks(ISystemHost)

public static IReadOnlyCollection<IDisk> GetFixedDisks(this ISystemHost systemHost)
Table 5. Parameters
Name Type Description

systemHost

ISystemHost

Returns: IReadOnlyCollection<IDisk>

1.6. GetSegments(IP)

public static int[] GetSegments(this IP ip)
Table 6. Parameters
Name Type Description

ip

IP

Returns: int[]

1.7. GetUSBDrives(ISystemHost)

public static IReadOnlyCollection<IDisk> GetUSBDrives(this ISystemHost systemHost)
Table 7. Parameters
Name Type Description

systemHost

ISystemHost

Returns: IReadOnlyCollection<IDisk>

1.8. HasNETSetup(ISystemHost)

public static bool HasNETSetup(this ISystemHost host)
Table 8. Parameters
Name Type Description

host

ISystemHost

Returns: bool

1.9. IsNixOSHost(ISystemHost)

Determines whether the host IS a NixOS host (running NixOS).

public static bool IsNixOSHost(this ISystemHost systemHost)
Table 9. Parameters
Name Type Description

systemHost

ISystemHost

Returns: bool

1.10. IsOnHP(ISystemHost)

public static bool IsOnHP(this ISystemHost systemHost)
Table 10. Parameters
Name Type Description

systemHost

ISystemHost

Returns: bool

1.11. IsOnHyperV(ISystemHost)

public static bool IsOnHyperV(this ISystemHost systemHost)
Table 11. Parameters
Name Type Description

systemHost

ISystemHost

Returns: bool

1.12. IsOnLinux(ISystemHost)

public static bool IsOnLinux(this ISystemHost systemHost)
Table 12. Parameters
Name Type Description

systemHost

ISystemHost

Returns: bool

1.13. IsOnLinuxPE(ISystemHost)

public static bool IsOnLinuxPE(this ISystemHost systemHost)
Table 13. Parameters
Name Type Description

systemHost

ISystemHost

Returns: bool

1.14. IsOnProxmox(ISystemHost)

public static bool IsOnProxmox(this ISystemHost systemHost)
Table 14. Parameters
Name Type Description

systemHost

ISystemHost

Returns: bool

1.15. IsOnWinPE(ISystemHost)

public static bool IsOnWinPE(this ISystemHost systemHost)
Table 15. Parameters
Name Type Description

systemHost

ISystemHost

Returns: bool

1.16. IsOnWindows(ISystemHost)

public static bool IsOnWindows(this ISystemHost systemHost)
Table 16. Parameters
Name Type Description

systemHost

ISystemHost

Returns: bool

1.17. IsProxmoxHost(ISystemHost)

Determines whether the host IS a Proxmox host (running Proxmox OS). Distinct from NETSetup.Extensions.SystemManagementExtension.IsOnProxmox(ISystemHost) which checks if a VM runs ON Proxmox.

public static bool IsProxmoxHost(this ISystemHost systemHost)
Table 17. Parameters
Name Type Description

systemHost

ISystemHost

Returns: bool

1.18. IsVirtualMachine(ISystemHost)

public static bool IsVirtualMachine(this ISystemHost systemHost)
Table 18. Parameters
Name Type Description

systemHost

ISystemHost

Returns: bool

1.19. IsWOLEnabled(ISystemHost, string)

Checks if Wake-on-LAN is enabled on a network interface.

public static bool IsWOLEnabled(ISystemHost host, string interfaceName)
Table 19. Parameters
Name Type Description

host

ISystemHost

interfaceName

string

Name of the network interface (e.g., "Ethernet", "eth0")

Returns: bool — True if WOL is enabled, false otherwise

1.20. Ping(ISystemHost, string, int, string, TimeSpan, TimeSpan)

Pings a host via HTTP(S) with retry until timeout. Uses a three-stage strategy: (1) HTTPS with strict cert validation, (2) HTTPS accepting self-signed certs, (3) HTTP fallback when HTTPS connection is refused.

public static bool Ping(this ISystemHost host, string hostname, int port, string scheme, TimeSpan timeout, TimeSpan retryInterval)
Table 20. Parameters
Name Type Description

host

ISystemHost

The system host (used for logging).

hostname

string

The hostname or IP to ping.

port

int

The port to connect to (default: 8006 for Proxmox).

scheme

string

The initial URI scheme. If "https", fallback to "http" is automatic.

timeout

TimeSpan

Total retry timeout (default: 10 minutes).

retryInterval

TimeSpan

Interval between retries (default: 10 seconds).

Returns: bool — True if the host responded with a success status code within the timeout.

1.21. RebootOOBE()

public static uint RebootOOBE()

Returns: uint

1.22. RebootOOBE(Live)

public static uint RebootOOBE(this Live live)
Table 21. Parameters
Name Type Description

live

Live

Returns: uint

1.23. Rename(Live, string, string, SecureString)

public static void Rename(this Live live, string computerName, string userName, SecureString password)
Table 22. Parameters
Name Type Description

live

Live

computerName

string

userName

string

password

SecureString

1.24. Rename(Live, string, string, string)

public static void Rename(this Live live, string computerName, string userName = null, string password = null)
Table 23. Parameters
Name Type Description

live

Live

computerName

string

userName

string

password

string

1.25. Rename(string)

public static void Rename(string computerName)
Table 24. Parameters
Name Type Description

computerName

string

1.26. ThrowIfIsNotPrivileged(ISystemHost)

Throws a NETSetupException when the host is not running with elevated privileges (administrator on Windows, root on Linux).

public static void ThrowIfIsNotPrivileged(this ISystemHost host)
Table 25. Parameters
Name Type Description

host

ISystemHost

The system host to check.

1.27. WakeMachine(Live, MAC, IP?, int)

Sends a Wake-on-LAN magic packet to wake a machine via a Live object context.

public static void WakeMachine(this Live live, MAC macAddress, IP? broadcastAddress = null, int port = 9)
Table 26. Parameters
Name Type Description

live

Live

Live management object (not used for local WOL, but provides context)

macAddress

MAC

Target MAC address (format: XX:XX:XX:XX:XX:XX or XX-XX-XX-XX-XX-XX)

broadcastAddress

IP?

Broadcast address (default: 255.255.255.255)

port

int

UDP port (default: 9)

1.28. WakeMachine(MAC, IP?, int)

Sends a Wake-on-LAN magic packet to wake a machine.

public static void WakeMachine(MAC macAddress, IP? broadcastAddress = null, int port = 9)
Table 27. Parameters
Name Type Description

macAddress

MAC

Target MAC address (format: XX:XX:XX:XX:XX:XX or XX-XX-XX-XX-XX-XX)

broadcastAddress

IP?

Broadcast address (default: 255.255.255.255)

port

int

UDP port (default: 9)