From 1917e7844ced2ca1aa9884198bd104565ffaead0 Mon Sep 17 00:00:00 2001
From: Andriy Kvasnytsya <andriy@kvasnytsya.name>
Date: Tue, 1 Mar 2022 19:09:52 +0200
Subject: [PATCH 1/2] #3021 Pass extra parameters to MSBuild: easy way

---
 src/GitVersion.MsBuild/msbuild/tools/GitVersion.MsBuild.props | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/GitVersion.MsBuild/msbuild/tools/GitVersion.MsBuild.props b/src/GitVersion.MsBuild/msbuild/tools/GitVersion.MsBuild.props
index 266236f7fb..1f7f7bba05 100644
--- a/src/GitVersion.MsBuild/msbuild/tools/GitVersion.MsBuild.props
+++ b/src/GitVersion.MsBuild/msbuild/tools/GitVersion.MsBuild.props
@@ -13,7 +13,7 @@
         <GitVersion_NoNormalizeEnabled Condition="$(GitVersion_NoNormalizeEnabled) == ''">false</GitVersion_NoNormalizeEnabled>
         <GitVersion_NoCacheEnabled Condition="$(GitVersion_NoCacheEnabled) == ''">false</GitVersion_NoCacheEnabled>
 
-        <GitVersion_ToolArgments>-output file -outputfile $(GitVersionOutputFile)</GitVersion_ToolArgments>
+        <GitVersion_ToolArgments>$(GitVersion_CommandLineArgments) -output file -outputfile $(GitVersionOutputFile)</GitVersion_ToolArgments>
         <GitVersion_ToolArgments Condition=" '$(GitVersion_NoFetchEnabled)' == 'true' ">$(GitVersion_ToolArgments) -nofetch</GitVersion_ToolArgments>
         <GitVersion_ToolArgments Condition=" '$(GitVersion_NoNormalizeEnabled)' == 'true' ">$(GitVersion_ToolArgments) -nonormalize</GitVersion_ToolArgments>
         <GitVersion_ToolArgments Condition=" '$(GitVersion_NoCacheEnabled)' == 'true' ">$(GitVersion_ToolArgments) -nocache</GitVersion_ToolArgments>

From 3ef4778f84ed732c9c55b7ac1646f97b6cd95849 Mon Sep 17 00:00:00 2001
From: Andriy Kvasnytsya <andriy@kvasnytsya.name>
Date: Tue, 1 Mar 2022 21:03:12 +0200
Subject: [PATCH 2/2] Added documentation

---
 docs/input/docs/usage/msbuild.md                       | 10 ++++++++++
 .../msbuild/tools/GitVersion.MsBuild.props             |  2 +-
 2 files changed, 11 insertions(+), 1 deletion(-)

diff --git a/docs/input/docs/usage/msbuild.md b/docs/input/docs/usage/msbuild.md
index 5a70bb9415..64e06e9b9b 100644
--- a/docs/input/docs/usage/msbuild.md
+++ b/docs/input/docs/usage/msbuild.md
@@ -258,6 +258,16 @@ For SDK-style projects, `UpdateVersionProperties` controls setting the default
 variables: `Version`, `VersionPrefix`, `VersionSuffix`, `PackageVersion`,
 `InformationalVersion`, `AssemblyVersion` and `FileVersion`.
 
+## Extra properties
+
+There are properties that correspont to certain 
+[command line arguments](/docs/usage/cli/arguments) for GetVersion task.
+In particular, setting `GitVersion_NoFetchEnabled` to `true` disables `git fetch` 
+during version calculation, setting `GitVersion_NoNormalizeEnabled` to `true` disables 
+normalize step on a build server, setting `GitVersion_NoCacheEnabled` to `true`
+makes GetVersion ignore cache. All the rest command line arguments can be passed via 
+`GitVersion_CommandLineArguments` variable.
+
 ## My Git repository requires authentication. What should I do?
 
 Set the environment variables `GITVERSION_REMOTE_USERNAME` and
diff --git a/src/GitVersion.MsBuild/msbuild/tools/GitVersion.MsBuild.props b/src/GitVersion.MsBuild/msbuild/tools/GitVersion.MsBuild.props
index 1f7f7bba05..e102c29e34 100644
--- a/src/GitVersion.MsBuild/msbuild/tools/GitVersion.MsBuild.props
+++ b/src/GitVersion.MsBuild/msbuild/tools/GitVersion.MsBuild.props
@@ -13,7 +13,7 @@
         <GitVersion_NoNormalizeEnabled Condition="$(GitVersion_NoNormalizeEnabled) == ''">false</GitVersion_NoNormalizeEnabled>
         <GitVersion_NoCacheEnabled Condition="$(GitVersion_NoCacheEnabled) == ''">false</GitVersion_NoCacheEnabled>
 
-        <GitVersion_ToolArgments>$(GitVersion_CommandLineArgments) -output file -outputfile $(GitVersionOutputFile)</GitVersion_ToolArgments>
+        <GitVersion_ToolArgments>$(GitVersion_CommandLineArguments) -output file -outputfile $(GitVersionOutputFile)</GitVersion_ToolArgments>
         <GitVersion_ToolArgments Condition=" '$(GitVersion_NoFetchEnabled)' == 'true' ">$(GitVersion_ToolArgments) -nofetch</GitVersion_ToolArgments>
         <GitVersion_ToolArgments Condition=" '$(GitVersion_NoNormalizeEnabled)' == 'true' ">$(GitVersion_ToolArgments) -nonormalize</GitVersion_ToolArgments>
         <GitVersion_ToolArgments Condition=" '$(GitVersion_NoCacheEnabled)' == 'true' ">$(GitVersion_ToolArgments) -nocache</GitVersion_ToolArgments>