<!--
title: Standardize PowerShell Naming
domain: cloud-infra
topic: Naming Conventions
language: Markdown
source: Azure/azure-powershell
updated: 2026-06-25
url: https://awesomereviewers.com/reviewers/azure-powershell-standardize-powershell-naming/
-->

Apply consistent, semantic naming to generated cmdlets, parameters, and help/docs.

- Cmdlet verb semantics: name sync operations with `Invoke-*` rather than `Start-*`/job-style verbs.
  - Example: if an operation is synchronous, prefer `Invoke-AzNetworkCloudStorageApplianceReadCommand` over `Start-*`.

- Parameter readability: avoid overly hierarchical/verbose parameter names produced by AutoRest (e.g., `InvitedUserDetailAuthType`). Use AutoRest’s parameter rename directive to shorten/clarify names.
  - Also validate directive fields (e.g., use `verb`, not `werb`).

- Keep help/docs type references aligned with the current generator: after migrating (e.g., AutoRest v4), update output type namespaces to the expected flat model types (e.g., `Models.IFileSystemResource` instead of `Models.Api20221012Preview.IFileSystemResource`).

- Be conservative with generation directives that affect cmdlet naming: follow established cmdlet pairing patterns (e.g., `Set`/`New` typically map to the same PUT API) unless you have a clear, verified reason to change generation behavior.

These checks prevent misleading cmdlet names, awkward parameter UX, and incorrect documentation/type references when the generator or swagger surface changes.
