Skip to main content

Get-KeldorOperatingSystem

SYNOPSIS​

Gets normalized operating-system information.

SYNTAX​

Local (Default)​

Get-KeldorOperatingSystem [<CommonParameters>]

ComputerName​

Get-KeldorOperatingSystem [-ComputerName] <String[]> [-Credential <PSCredential>]
 [<CommonParameters>]

PSSession​

Get-KeldorOperatingSystem -PSSession <PSSession[]> [<CommonParameters>]

DESCRIPTION​

Returns operating-system identity, version, role, architecture, installation, and boot information for the local system or configured PowerShell-remoting targets.

EXAMPLES​

EXAMPLE 1​

Get-KeldorOperatingSystem

Gets operating-system information for the local system.

EXAMPLE 2​

'server01', 'server02' | Get-KeldorOperatingSystem

Gets operating-system information through configured PowerShell remoting.

EXAMPLE 3​

Get-PSSession | Get-KeldorOperatingSystem | Where-Object IsServer

Reuses existing sessions and filters server operating systems.

PARAMETERS​

-ComputerName​

Specifies computers reachable through configured PowerShell remoting. Keldor must be installed on each target.

Type: String[]
Parameter Sets: ComputerName
Aliases: HostName, DnsHostName

Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

-PSSession​

Specifies existing PowerShell sessions to reuse. Keldor must be installed in each remote session.

Type: PSSession[]
Parameter Sets: PSSession
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-Credential​

Specifies a credential for ComputerName remoting. Credential contents are never returned.

Type: PSCredential
Parameter Sets: ComputerName
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters​

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS​

System.String and System.Management.Automation.Runspaces.PSSession.​

OUTPUTS​

Keldor.OperatingSystem​

NOTES​

ComputerName uses the host's standard PowerShell-remoting configuration and does not modify it.

ALIASES​

None.

PLATFORM APPLICABILITY​

Windows, macOS, and Linux.

POWERSHELL COMPATIBILITY​

See PowerShell compatibility for the supported runtime policy. PowerShell 7.6 LTS is preferred.

https://docs.keldor.dev/powershell/keldor/Get-KeldorOperatingSystem