Fixed Add-PnPField not supporting a ReturnType to be set for calculated field

CHANGELOG.md

@@ -61,6 +61,7 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/).
 - Fixed issue with `Get-PnPFolder` ignoring `-Includes` parameter when passing in a specific list through `-List` [#2735](https://github.com/pnp/powershell/pull/2735)
 - Fixed the handling of `-ErrorAction` so it follows the standard PowerShell behavior [#2741](https://github.com/pnp/powershell/pull/2741)
 - Fixed issue with `Set-PnPContentType` not allowing you to update basic properties of a content type [#2760](https://github.com/pnp/powershell/pull/2760)
+- Fixed `Add-PnPField` not supporting a ReturnType to be set for calculated fields when created on the site level [#2765](https://github.com/pnp/powershell/pull/2765)
 
 ### Contributors
 

documentation/Add-PnPField.md

@@ -18,8 +18,7 @@ Add a field
 ```powershell
 Add-PnPField [-List <ListPipeBind>] -DisplayName <String> -InternalName <String> -Type <FieldType>
  [-Id <Guid>] [-Formula <String>] [-Choices <String>] [-AddToDefaultView] [-Required] [-Group <String>] [-ClientSideComponentId <Guid>]
- [-ClientSideComponentProperties <String>] [-AddToAllContentTypes] [-Connection <PnPConnection>]
- [<CommonParameters>]
+ [-ClientSideComponentProperties <String>] [-AddToAllContentTypes] [-ReturnType <String>] [-Connection <PnPConnection>]
 ```
 
 ### Add field reference to list
@@ -31,8 +30,8 @@ Add-PnPField -List <ListPipeBind> -Field <FieldPipeBind> [-Connection <PnPConnec
 ### Add field to web
 ```powershell
 Add-PnPField -DisplayName <String> -InternalName <String> -Type <FieldType> [-Id <Guid>] [-Formula <String>] [-Choices <String>]
- [-ClientSideComponentId <Guid>] [-ClientSideComponentProperties <String>] 
- [-Connection <PnPConnection>] [<CommonParameters>]
+ [-ClientSideComponentId <Guid>] [-ClientSideComponentProperties <String>] [-ReturnType <String>]
+ [-Connection <PnPConnection>]
 ```
 
 ## DESCRIPTION
@@ -75,6 +74,13 @@ Add-PnPField -Type Choice -Choices "PnP","Parker","Sharing Is Caring" -DisplayNa
 
 This will add a site column of type Choice (only one choice value can be chosen at the same time) called "My Test Column" with three choice values.
 
+### EXAMPLE 6
+```powershell
+Add-PnPField -Type Calculated -ResultType Number -DisplayName "My Calculated Column" -InternalName "MyCalcCol" -Formula "=Today()"
+```
+
+This will add a site column of type Caulculated called "My Calculated Column" which contains todays date.
+
 ## PARAMETERS
 
 ### -AddToDefaultView
@@ -284,7 +290,7 @@ Accept wildcard characters: False
 ```
 
 ### -Type
-The type of the field like Choice, Note, MultiChoice. For a complete list of field types visit https://learn.microsoft.com/dotnet/api/microsoft.sharepoint.client.fieldtype
+The type of the field like Choice, Note, Calculate, MultiChoice. For a complete list of field types visit https://learn.microsoft.com/dotnet/api/microsoft.sharepoint.client.fieldtype
 
 ```yaml
 Type: FieldType
@@ -298,6 +304,21 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -ReturnType
+The return type of the calculated field. Only valid when Type Calculated is chosen.
+
+```yaml
+Type: FieldType
+Parameter Sets: Add field to list, Add field to web
+Accepted values: Integer, Text, DateTime, Boolean, Number, Currency
+
+Required: False
+Position: Named
+Default value: Text
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ## RELATED LINKS
 
-[Microsoft 365 Patterns and Practices](https://aka.ms/m365pnp)
+[Microsoft 365 Patterns and Practices](https://aka.ms/m365pnp)

src/Commands/Fields/AddField.cs

@@ -245,6 +245,15 @@ protected override void ExecuteCmdlet()
                     EnsureDynamicParameters(calculatedFieldParameters);
                     f = CurrentWeb.CreateField<FieldCalculated>(fieldCI);
                     ((FieldCalculated)f).Formula = calculatedFieldParameters.Formula;
+
+                    if(!string.IsNullOrEmpty(calculatedFieldParameters.ResultType) && Enum.TryParse<FieldType>(calculatedFieldParameters.ResultType, out FieldType resultType))
+                    {
+                        ((FieldCalculated)f).OutputType = resultType;
+                    }
+                    else
+                    {
+                        ((FieldCalculated)f).OutputType = FieldType.Text;
+                    }
                     f.Update();
                     ClientContext.ExecuteQueryRetry();
                 }