ConvertTo-NetboxVersion
Since
v4.4.10.0
SYNOPSIS
Parses Netbox version strings to [System.Version] objects.
SYNTAX
ConvertTo-NetboxVersion [-VersionString] <String> [-ProgressAction <ActionPreference>] [<CommonParameters>]
DESCRIPTION
Extracts semantic version from Netbox version strings that may contain additional metadata (e.g., "4.2.9-Docker-3.2.1" -> "4.2.9").
This is a central helper function used throughout the module to ensure consistent version parsing behavior.
EXAMPLES
EXAMPLE 1
ConvertTo-NetboxVersion -VersionString "4.4.8"
# Returns: [version]"4.4.8"
EXAMPLE 2
ConvertTo-NetboxVersion -VersionString "4.2.9-Docker-3.2.1"
# Returns: [version]"4.2.9"
EXAMPLE 3
ConvertTo-NetboxVersion -VersionString "v4.4.9-dev"
# Returns: [version]"4.4.9"
EXAMPLE 4
"4.4.8" | ConvertTo-NetboxVersion
# Pipeline support - Returns: [version]"4.4.8"
PARAMETERS
-VersionString
The raw version string from Netbox API (e.g., from Get-NBVersion).
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-ProgressAction
{{ Fill ProgressAction Description }}
Type: ActionPreference
Parameter Sets: (All)
Aliases: proga
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
OUTPUTS
System.Version or $null if parsing fails
NOTES
AddedInVersion: v4.4.10.0 Resolves issue #111: Version detection inconsistency