Skip to content

Commit d67b7a2

Browse files
Merge pull request #226954 from ggailey777/powershell
[Functions] Remaining v4/.NET 6/PS7.2 upgrades
2 parents 3eb43e9 + 51e3dbc commit d67b7a2

6 files changed

+34
-32
lines changed

articles/azure-functions/create-first-function-cli-powershell.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -27,11 +27,13 @@ Before you begin, you must have the following:
2727

2828
+ One of the following tools for creating Azure resources:
2929

30-
+ The Azure [Az PowerShell module](/powershell/azure/install-az-ps) version 5.9.0 or later.
30+
+ The Azure [Az PowerShell module](/powershell/azure/install-az-ps) version 9.4.0 or later.
3131

3232
+ [Azure CLI](/cli/azure/install-azure-cli) version 2.4 or later.
3333

34-
+ The [.NET Core 3.1 SDK](https://dotnet.microsoft.com/download)
34+
+ The [.NET 6.0 SDK](https://dotnet.microsoft.com/download)
35+
36+
+ [PowerShell 7.2](/powershell/scripting/install/installing-powershell-core-on-windows)
3537

3638
### Prerequisite check
3739

@@ -49,7 +51,7 @@ Verify your prerequisites, which depend on whether you are using Azure CLI or Az
4951

5052
+ In a terminal or command window, run `func --version` to check that the Azure Functions Core Tools are version 4.x.
5153

52-
+ Run `(Get-Module -ListAvailable Az).Version` and verify version 5.0 or later.
54+
+ Run `(Get-Module -ListAvailable Az).Version` and verify version 9.4.0 or later.
5355

5456
+ Run `Connect-AzAccount` to sign in to Azure and verify an active subscription.
5557

articles/azure-functions/functions-create-vnet.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Use private endpoints to integrate Azure Functions with a virtual network
33
description: This tutorial shows you how to connect a function to an Azure virtual network and lock it down by using private endpoints.
44
ms.topic: article
5-
ms.date: 2/22/2021
5+
ms.date: 2/10/2023
66

77
#Customer intent: As an enterprise developer, I want to create a function that can connect to a virtual network with private endpoints to secure my function app.
88
---
@@ -40,7 +40,7 @@ You'll create a .NET function app in the Premium plan because this tutorial uses
4040
| **Function App name** | Globally unique name | Name that identifies your new function app. Valid characters are `a-z` (case insensitive), `0-9`, and `-`. |
4141
|**Publish**| Code | Choose to publish code files or a Docker container. |
4242
| **Runtime stack** | .NET | This tutorial uses .NET. |
43-
| **Version** | 3.1 | This tutorial uses .NET Core 3.1 |
43+
| **Version** | 6 | This tutorial uses .NET 6.0 running [in the same process as the Functions host](./functions-dotnet-class-library.md). |
4444
|**Region**| Preferred region | Choose a [region](https://azure.microsoft.com/regions/) near you or near other services that your functions access. |
4545

4646
1. Select **Next: Hosting**. On the **Hosting** page, enter the following settings.
@@ -352,7 +352,7 @@ To use your function app with virtual networks, you need to join it to a subnet.
352352
| **Repository** | functions-vnet-tutorial | The repository forked from https://github.com/Azure-Samples/functions-vnet-tutorial. |
353353
| **Branch** | main | The main branch of the repository you created. |
354354
| **Runtime stack** | .NET | The sample code is in C#. |
355-
| **Version** | .NET Core 3.1 | The runtime version. |
355+
| **Version** | v4.0 | The runtime version. |
356356

357357
1. Select **Save**.
358358

articles/azure-functions/functions-develop-vs-code.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -77,9 +77,9 @@ These prerequisites are only required to [run and debug your functions locally](
7777

7878
* The [Azure Functions Core Tools](functions-run-local.md#install-the-azure-functions-core-tools) version 2.x or later. The Core Tools package is downloaded and installed automatically when you start the project locally. Core Tools include the entire Azure Functions runtime, so download and installation might take some time.
7979

80-
* [PowerShell 7](/powershell/scripting/install/installing-powershell-core-on-windows) recommended. For version information, see [PowerShell versions](functions-reference-powershell.md#powershell-versions).
80+
* [PowerShell 7.2](/powershell/scripting/install/installing-powershell-core-on-windows) recommended. For version information, see [PowerShell versions](functions-reference-powershell.md#powershell-versions).
8181

82-
* Both [.NET Core 3.1 runtime](https://dotnet.microsoft.com/download) and [.NET Core 2.1 runtime](https://dotnet.microsoft.com/download/dotnet/2.1).
82+
* [.NET 6.0 runtime](https://dotnet.microsoft.com/download).
8383

8484
* The [PowerShell extension for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=ms-vscode.PowerShell).
8585

articles/azure-functions/functions-identity-based-connections-tutorial.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -28,9 +28,9 @@ After you complete this tutorial, you should complete the follow-on tutorial tha
2828

2929
+ An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?ref=microsoft.com&utm_source=microsoft.com&utm_medium=docs&utm_campaign=visualstudio).
3030

31-
+ The [.NET Core 3.1 SDK](https://dotnet.microsoft.com/download)
31+
+ The [.NET 6.0 SDK](https://dotnet.microsoft.com/download)
3232

33-
+ The [Azure Functions Core Tools](functions-run-local.md#v2) version 3.x.
33+
+ The [Azure Functions Core Tools](functions-run-local.md#v2) version 4.x.
3434

3535
## Why use identity?
3636

articles/azure-functions/functions-run-local.md

Lines changed: 20 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -30,33 +30,33 @@ The specific prerequisites for Core Tools depend on the features you plan to use
3030

3131
**[Publish](#publish)**: Core Tools currently depends on either the [Azure CLI](/cli/azure/install-azure-cli) or [Azure PowerShell](/powershell/azure/install-az-ps) for authenticating with your Azure account. This means that you must install one of these tools to be able to [publish to Azure](#publish) from Azure Functions Core Tools.
3232

33-
**[Install extensions](#install-extensions)**: To manually install extensions by using Core Tools, you must have the [.NET Core 3.1 SDK](https://dotnet.microsoft.com/download) installed. The .NET Core SDK is used by Core Tools to install extensions from NuGet. You don't need to know .NET to use Azure Functions extensions.
33+
**[Install extensions](#install-extensions)**: To manually install extensions by using Core Tools, you must have the [.NET 6.0 SDK](https://dotnet.microsoft.com/download) installed. The .NET SDK is used by Core Tools to install extensions from NuGet. You don't need to know .NET to use Azure Functions extensions.
3434

3535
## <a name="v2"></a>Core Tools versions
3636

3737
There are four versions of Azure Functions Core Tools. The version you use depends on your local development environment, [choice of language](supported-languages.md), and level of support required.
3838

39-
Choose a version tab below to learn about each specific version and for detailed installation instructions:
39+
Choose one of the following version tabs to learn about each specific version and for detailed installation instructions:
4040

4141
# [Version 4.x](#tab/v4)
4242

4343
Supports [version 4.x](functions-versions.md) of the Functions runtime. This version supports Windows, macOS, and Linux, and uses platform-specific package managers or npm for installation. This is the recommended version of the Functions runtime and Core Tools.
4444

4545
# [Version 3.x](#tab/v3)
4646

47-
Supports [version 3.x](functions-versions.md) of the Azure Functions runtime. This version supports Windows, macOS, and Linux, and uses platform-specific package managers or npm for installation.
47+
Supports [version 3.x](functions-versions.md) of the Azure Functions runtime, which reached end of life (EOL) for extended support on December 13, 2022. Use version 4.x instead.
4848

4949
# [Version 2.x](#tab/v2)
5050

51-
Supports [version 2.x](functions-versions.md) of the Azure Functions runtime. This version supports Windows, macOS, and Linux, and uses platform-specific package managers or npm for installation.
51+
Supports [version 3.x](functions-versions.md) of the Azure Functions runtime, which reached end of life (EOL) for extended support on December 13, 2022. Use version 4.x instead.
5252

5353
# [Version 1.x](#tab/v1)
5454

5555
Supports version 1.x of the Azure Functions runtime. This version of the tools is only supported on Windows computers and is installed from an [npm package](https://www.npmjs.com/package/azure-functions-core-tools).
5656

5757
---
5858

59-
You can only install one version of Core Tools on a given computer. Unless otherwise noted, the examples in this article are for version 3.x.
59+
You can only install one version of Core Tools on a given computer. Unless otherwise noted, the examples in this article are for version 4.x.
6060

6161
## Install the Azure Functions Core Tools
6262

@@ -189,10 +189,10 @@ Version 1.x of the Core Tools isn't supported on Linux. Use version 2.x or a lat
189189
190190
## Changing Core Tools versions
191191
192-
When changing to a different version of Core Tools, you should use the same package manager as the original installation to move to a different package version. For example, if you installed Core Tools version 2.x using npm, you should use the following command to upgrade to version 3.x:
192+
When changing to a different version of Core Tools, you should use the same package manager as the original installation to move to a different package version. For example, if you installed Core Tools version 3.x using npm, you should use the following command to upgrade to version 4.x:
193193
194194
```bash
195-
npm install -g azure-functions-core-tools@3 --unsafe-perm true
195+
npm install -g azure-functions-core-tools@4 --unsafe-perm true
196196
```
197197

198198
If you used Windows installer (MSI) to install Core Tools on Windows, you should uninstall the old version from Add Remove Programs before installing a different version.
@@ -216,7 +216,7 @@ In the terminal window or from a command prompt, run the following command to cr
216216
func init MyFunctionProj
217217
```
218218

219-
This example creates a Functions project in a new `MyFunctionProj` folder. You are prompted to choose a default language for your project.
219+
This example creates a Functions project in a new `MyFunctionProj` folder. You're prompted to choose a default language for your project.
220220

221221
The following considerations apply to project initialization:
222222

@@ -226,13 +226,13 @@ The following considerations apply to project initialization:
226226

227227
+ If you plan to publish your project to a custom Linux container, use the `--docker` option to make sure that a Dockerfile is generated for your project. To learn more, see [Create a function on Linux using a custom image](functions-create-function-linux-custom-image.md).
228228

229-
Certain languages may have additional considerations:
229+
Certain languages may have more considerations:
230230

231231
# [C\#](#tab/csharp)
232232

233233
+ Core Tools lets you create function app projects for the .NET runtime as both [in-process](functions-dotnet-class-library.md) and [isolated worker process](dotnet-isolated-process-guide.md) C# class library projects (.csproj). These projects, which can be used with Visual Studio or Visual Studio Code, are compiled during debugging and when publishing to Azure.
234234

235-
+ Use the `--csx` parameter if you want to work locally with C# script (.csx) files. These are the same files you get when you create functions in the Azure portal and when using version 1.x of Core Tools. To learn more, see the [func init reference](functions-core-tools-reference.md#func-init).
235+
+ Use the `--csx` parameter if you want to work locally with C# script (.csx) files. These files are the same ones you get when you create functions in the Azure portal and when using version 1.x of Core Tools. To learn more, see the [func init reference](functions-core-tools-reference.md#func-init).
236236

237237
# [Java](#tab/java)
238238

@@ -244,7 +244,7 @@ Certain languages may have additional considerations:
244244

245245
# [PowerShell](#tab/powershell)
246246

247-
There are no additional considerations for PowerShell.
247+
There are no other considerations for PowerShell.
248248

249249
# [Python](#tab/python)
250250

@@ -260,11 +260,11 @@ There are no additional considerations for PowerShell.
260260

261261
## Register extensions
262262

263-
Starting with runtime version 2.x, [Functions triggers and bindings](functions-triggers-bindings.md) are implemented as .NET extension (NuGet) packages. For compiled C# projects, you simply reference the NuGet extension packages for the specific triggers and bindings you are using. HTTP bindings and timer triggers don't require extensions.
263+
Starting with runtime version 2.x, [Functions triggers and bindings](functions-triggers-bindings.md) are implemented as .NET extension (NuGet) packages. For compiled C# projects, you simply reference the NuGet extension packages for the specific triggers and bindings you're using. HTTP bindings and timer triggers don't require extensions.
264264

265-
To improve the development experience for non-C# projects, Functions lets you reference a versioned extension bundle in your host.json project file. [Extension bundles](functions-bindings-register.md#extension-bundles) makes all extensions available to your app and removes the chance of having package compatibility issues between extensions. Extension bundles also removes the requirement of installing the .NET Core 3.1 SDK and having to deal with the extensions.csproj file.
265+
To improve the development experience for non-C# projects, Functions lets you reference a versioned extension bundle in your host.json project file. [Extension bundles](functions-bindings-register.md#extension-bundles) makes all extensions available to your app and removes the chance of having package compatibility issues between extensions. Extension bundles also removes the requirement of installing the .NET SDK and having to deal with the extensions.csproj file.
266266

267-
Extension bundles is the recommended approach for functions projects other than C# complied projects, as well as C# script. For these projects, the extension bundle setting is generated in the _host.json_ file during initialization. If bundles aren't enabled, you need to update the project's host.json file.
267+
Extension bundles is the recommended approach for functions projects other than C# complied projects, and for C# script. For these projects, the extension bundle setting is generated in the _host.json_ file during initialization. If bundles aren't enabled, you need to update the project's host.json file.
268268

269269
[!INCLUDE [Register extensions](../../includes/functions-extension-bundles.md)]
270270

@@ -274,9 +274,9 @@ There may be cases in a non-.NET project when you can't use extension bundles, s
274274

275275
[!INCLUDE [functions-local-settings-file](../../includes/functions-local-settings-file.md)]
276276

277-
By default, these settings are not migrated automatically when the project is published to Azure. Use the [`--publish-local-settings` option][func azure functionapp publish] when you publish to make sure these settings are added to the function app in Azure. Values in the `ConnectionStrings` section are never published.
277+
By default, these settings aren't migrated automatically when the project is published to Azure. Use the [`--publish-local-settings` option][func azure functionapp publish] when you publish to make sure these settings are added to the function app in Azure. Values in the `ConnectionStrings` section are never published.
278278

279-
The function app settings values can also be read in your code as environment variables. For more information, see the Environment variables section of these language-specific reference topics:
279+
The function app settings values can also be read in your code as environment variables. For more information, see the Environment variables section of these language-specific reference articles:
280280

281281
* [C# precompiled](functions-dotnet-class-library.md#environment-variables)
282282
* [C# script (.csx)](functions-reference-csharp.md#environment-variables)
@@ -341,7 +341,7 @@ To create a function in an existing project, run the following command:
341341
func new
342342
```
343343
344-
In version 3.x/2.x, when you run `func new` you are prompted to choose a template in the default language of your function app. Next, you're prompted to choose a name for your function. In version 1.x, you are also required to choose the language.
344+
When you run `func new`, you're prompted to choose a template in the default language of your function app. Next, you're prompted to choose a name for your function. In version 1.x, you're also required to choose the language.
345345
346346
You can also specify the function name and template in the `func new` command. The following example uses the `--template` option to create an HTTP trigger named `MyHttpTrigger`:
347347
@@ -515,7 +515,7 @@ You must have already [created a function app in your Azure subscription](functi
515515
To learn how to create a function app from the command prompt or terminal window using the Azure CLI or Azure PowerShell, see [Create a Function App for serverless execution](./scripts/functions-cli-create-serverless.md).
516516

517517
>[!IMPORTANT]
518-
> When you create a function app in the Azure portal, it uses version 3.x of the Function runtime by default. To make the function app use version 1.x of the runtime, follow the instructions in [Run on version 1.x](functions-versions.md#creating-1x-apps).
518+
> When you create a function app in the Azure portal, it uses version 4.x of the Function runtime by default. To make the function app use version 1.x of the runtime, follow the instructions in [Run on version 1.x](functions-versions.md#creating-1x-apps).
519519
> You can't change the runtime version for a function app that has existing functions.
520520
521521

@@ -582,7 +582,7 @@ func extensions install
582582

583583
The command reads the *function.json* file to see which packages you need, installs them, and rebuilds the extensions project (extensions.csproj). It adds any new bindings at the current version but doesn't update existing bindings. Use the `--force` option to update existing bindings to the latest version when installing new ones. To learn more, see the [`func extensions install` command](functions-core-tools-reference.md#func-extensions-install).
584584

585-
If your function app uses bindings or NuGet packages that Core Tools does not recognize, you must manually install the specific extension.
585+
If your function app uses bindings or NuGet packages that Core Tools doesn't recognize, you must manually install the specific extension.
586586

587587
### Install a specific extension
588588

@@ -612,7 +612,7 @@ This type of streaming logs requires that Application Insights integration be en
612612

613613
[!INCLUDE [functions-x86-emulation-on-arm64](../../includes/functions-x86-emulation-on-arm64.md)]
614614

615-
If you are using Visual Studio Code, you can integrate Rosetta with the built-in Terminal. For more information, see [Enable emulation in Visual Studio Code](./functions-develop-vs-code.md#enable-emulation-in-visual-studio-code).
615+
If you're using Visual Studio Code, you can integrate Rosetta with the built-in Terminal. For more information, see [Enable emulation in Visual Studio Code](./functions-develop-vs-code.md#enable-emulation-in-visual-studio-code).
616616

617617
## Next steps
618618

includes/functions-requirements-visual-studio-code-powershell.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -10,9 +10,9 @@ ms.author: glenga
1010

1111
+ The [Azure Functions Core Tools](../articles/azure-functions/functions-run-local.md#install-the-azure-functions-core-tools) version 4.x.
1212

13-
+ [PowerShell 7](/powershell/scripting/install/installing-powershell-core-on-windows)
13+
+ [PowerShell 7.2](/powershell/scripting/install/installing-powershell-core-on-windows)
1414

15-
+ [.NET Core 3.1 runtime](https://dotnet.microsoft.com/download/dotnet)
15+
+ [.NET 6.0 runtime](https://dotnet.microsoft.com/download/dotnet)
1616

1717
+ [Visual Studio Code](https://code.visualstudio.com/) on one of the [supported platforms](https://code.visualstudio.com/docs/supporting/requirements#_platforms).
1818

0 commit comments

Comments
 (0)