Skip to content
AzureSqlVmToolkit

Plan Vs WhatIf

-Plan

Section titled “-Plan”

-Plan is available today:

Terminal window
New-AzureSqlVmToolkitDeployment -ConfigFile .\config.local.yaml -SecurityAssessmentAdvice -Plan

It does not call Azure. It validates config and prints the intended deployment shape.

-WhatIf

Section titled “-WhatIf”

The public module command supports PowerShell -WhatIf as an Azure-aware dry run:

Terminal window
Connect-AzAccount
New-AzureSqlVmToolkitDeployment -ConfigFile .\config.local.yaml -WhatIf

This validates config, reads Azure state, reports create/reuse/update/drift decisions, and wraps mutating actions in ShouldProcess. It does not create, update, or run guest commands while -WhatIf is active.

Difference

Section titled “Difference”
  • Use -Plan before signing in, while editing YAML, or when you only need resolved resource names.
  • Use -WhatIf after signing in, when you need to know what the toolkit would do against the current subscription.
  • Use a real deployment only after -WhatIf reports expected drift and update decisions.