Command

Set-PlannerPlanOptions

Description

The command to set new planner plan options. Currently only allows the renaming of plans.

Examples

Rename a single plan

$tenant = Connect-Tenant -Domain tenantDomain
$group = Get-Microsoft365Group -Name "MyGroup" -Tenant $tenant
$plan = Get-PlannerPlan -Name "Plan Name" -Group $group
$plan = Set-PlannerPlanOptions -Plan $plan -NewName "New Name"

Rename a plan from a list

$tenant = Connect-Tenant -Domain tenantDomain
$group = Get-Microsoft365Group -Name "MyGroup" -Tenant $tenant
$plans = Get-PlannerPlan -Name "Plan 1", "Plan 2" -Group $group -AllowMultiple
$plans[0] = Set-PlannerPlanOptions -Plan $plans[0] -NewName "New Name 1"

Rename all plans

$tenant = Connect-Tenant -Domain tenantDomain
$group = Get-Microsoft365Group -Name "MyGroup" -Tenant $tenant
$plans = Get-PlannerPlan -Name "*" -Group $group -AllowMultiple
$plans = $plans | ForEach-Object { Set-PlannerPlanOptions -Plan $_ -NewName ($_.Name + "Copied") }

Syntax

Set-PlannerPlanOptions
-Plan <PlannerPlan>
-NewName <String>

Parameters

-NewName <String>

Specifies the Planner plan's new name property.

Required?	True
Default value	None
Accept pipeline input?	False
Accept wildcard characters?	False
Parameter set name	(All)
Aliases	None

-Plan <PlannerPlan>

Specifies the Planner plan property.

Required?	True
Default value	None
Accept pipeline input?	True (ByValue)
Accept wildcard characters?	False
Parameter set name	(All)
Aliases	None