The value of New Zealand’s property has increased more than $1.5 trillion in a generation, and investors have been a big winner.