Finding PowerShell's Missing Binary Operator - Rotate Right

One of my complaints about PowerShell is its lack of binary operators. As of version 2, it had the -bor, -band, and -bxor operators. Also, thankfully, version 3 will include shift left and shift right operators - -shl and -shr. Unfortunately, there is no rotate right operator. I could certainly write a function to perform a binary rotate right operation but why reinvent the wheel when it is more than likely that .NET has already implemented rotate right. Indeed it already has. System.Security.Cryptography.SHA256Managed and System.Security.Cryptography.SHA512Managed both have private, static methods that operate on unsigned 32 and 64-bit values respectively.

My function below utilizes reflection to provide a public wrapper to these private methods:

function Rotate-Right {
<#
.SYNOPSIS
Performs a binary rotate right operation.
Author: Matthew Graeber (@mattifestation)

.DESCRIPTION
Rather than implementing the logic to perform a binary rotate operation,
Rotate-Right wraps the private methods contained within
System.Security.Cryptography.SHA256Managed and
System.Security.Cryptography.SHA512Managed.

.OUTPUTS
System.UInt32. Returns a 32-bit unsigned integer
System.UInt64. Returns a 64-bit unsigned integer

.EXAMPLE
PS > Rotate-Right 256 1
128

.EXAMPLE
PS > Rotate-Right ([UInt64] 4294967296) 32
1

.LINK
http://www.exploit-monday.com/

#>

    [CmdletBinding(DefaultParameterSetName = '32bit')] Param (
        # The 32-bit value to be rotated
        [Parameter(Mandatory = $True, Position = 0, ParameterSetName = '32bit')] [UInt32] $Value32,
        # The 64-bit value to be rotated
        [Parameter(Mandatory = $True, Position = 0, ParameterSetName = '64bit')] [UInt64] $Value64,
        # The offset by which the value will be rotated
        [Parameter(Mandatory = $True, Position = 1)] [Int32] $Offset
    )
    
    $BindingFlags = 'NonPublic, Static'
    
    switch ($PsCmdlet.ParameterSetName) {
        '32bit' {
            $RorMethodInfo = [System.Security.Cryptography.SHA256Managed].GetMethod('RotateRight', $BindingFlags, $null, @([UInt32], [Int32]), $null)
            $RorMethodInfo.Invoke($null, @($Value32, $Offset))
        }
        '64bit' {
            $RorMethodInfo = [System.Security.Cryptography.SHA512Managed].GetMethod('RotateRight', $BindingFlags, $null, @([UInt64], [Int32]), $null)
            $RorMethodInfo.Invoke($null, @($Value64, $Offset))
        }
    }
}

Here are some usage examples:

PS > Rotate-Right 256 1
128

PS > Rotate-Right ([UInt64] 4294967296) 32
1

To access the private methods, you call the GetMethod method. Normally, to view a type's static or instance methods, you would just pipe it to Get-Member. However, Get-Member will only return public members. The GetMethod method allows you to specify BindingFlags. In the case of RotateRight, it is a NonPublic and Static method. Also, if a method has overloaded parameter sets, you need to specify the specific parameter set in the form of a Type array to GetMethod.

Lastly, when writing a function with multiple parameter sets, a really useful tip is to use a switch statement to process each parameter set accordingly. This can be accomplished using the built-in $PsCmdlet.ParameterSetName property.

Relevant links:

PowerShell V2: ParameterSets
Type.GetMethod Method (String, BindingFlags, Binder, Type[], ParameterModifier[])