New-FabricDeploymentPipeline
Creates a new deployment pipeline.
Syntax
New-FabricDeploymentPipeline [-DisplayName] <string> [[-Description] <string>] [-Stages] <array>
[-WhatIf] [-Confirm] [<CommonParameters>]Description
The New-FabricDeploymentPipeline function creates a new deployment pipeline with specified stages. Each stage can be configured with a display name, description, and public/private visibility setting.
Examples
Example 1
Creates a new deployment pipeline with two stages.
New-FabricDeploymentPipeline -DisplayName "My Deployment Pipeline" -Description "This is a test deployment pipeline" -Stages @(
@{ DisplayName = "Stage 1"; Description = "First stage"; IsPublic = $true },
@{ DisplayName = "Stage 2"; Description = "Second stage"; IsPublic = $false }
)Parameters
| Name | Type | Req. | Pos. | Pipeline | Description |
|---|---|---|---|---|---|
| -DisplayName | string | ✓Required | 0 | – | Required. The display name for the deployment pipeline. Maximum length is 256 characters. |
| -Stages | array | ✓Required | 2 | – | Required. An array of hashtables containing stage configurations. Each stage should have:
|
| -Confirmalias: cf | switch | Named | – | Prompts you for confirmation before running the cmdlet. |
|
| -Description | string | 1 | – | Optional. The description for the deployment pipeline. Maximum length is 1024 characters. |
|
| -WhatIfalias: wi | switch | Named | – | Runs the command in a mode that only reports what would happen without performing the actions. |
This cmdlet also supports the common parameters, such as -Verbose and -ErrorAction. See about_CommonParameters.
Notes
- Calls
Confirm-TokenStateto ensure token validity before making the API request. - Requires Pipeline.ReadWrite.All delegated scope.
- Service Principals must have permission granted by Fabric administrator.
- Returns the created deployment pipeline object with assigned IDs for the pipeline and its stages.
Author: Kamil Nowinski