CA-340392 + minor script corrections

[kc284]

See commit messages for details. Commits best reviewed separately.

[lindig]

I notice some changes around hyphens. Several symbols exist in UTF8 but not in Ascii, where we just have the minus, which is used for everything. Code that is pasted into the shell use the minus as otherwise it would not be recognised despite looking correct.

[kc284]

Indeed, the old "hyphens" were in reality this character in UTF-16: \u00e2\u0080\u0090. I've turned them to minus.

[kc284]

An example in order to understand what the OCaml change does:

Previously, calling the following cmdlet: Invoke-XenVM -Name MyVm -XenAction CleanShutdown -PassThru caused the following C# code to run:

XenAPI.VM.clean_shutdown(session, vm);

if (PassThru)
{
    var obj = XenAPI.VM.get_record(session, vm);
    if (obj != null)
        obj.opaque_ref = vm;
    WriteObject(obj, true);
}

i.e. the cmdldet returns the object on which the call was called. Which is not really necessary and it doesn't work for classes without records (e.g. Diagnostics).
Now the following code will be run:

XenAPI.VM.clean_shutdown(session, vm);

if (PassThru)
    WriteWarning("-PassThru can only be used with -Async for this cmdlet. Ignoring.");

The change affects a big number of API calls returning void (they can be found by diffing the autogenerated code), but breaking user implementation may not be very likely as most users wouldn't expect a cmdlet to return the object for a call returning void.