Version: 4.0

Convert-ADTValueType

SYNOPSIS

Casts the provided value to the requested type without range errors.

SYNTAX

Convert-ADTValueType [-Value] <Int64> [-To] <ValueTypes> [<CommonParameters>]

DESCRIPTION

This function uses C# code to cast the provided value to the requested type. This avoids errors from PowerShell when values exceed the casted value type's range.

EXAMPLES

EXAMPLE 1

Convert-ADTValueType -Value 256 -To SByte

Invokes the Convert-ADTValueType function and returns the value as a byte, which would equal 0.

PARAMETERS

-Value

The value to convert.

Type: Int64
Parameter Sets: (All)
Aliases:

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

-To

What to cast the value to.

Type: ValueTypes
Parameter Sets: (All)
Aliases:
Accepted values: SByte, Byte, Short, Int16, UShort, UInt16, Int, Int32, UInt, UInt32, Long, Int64, ULong, UInt64

Required: True
Position: 2
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.Int64