讲师中心 微信公众号
AI工具推荐 视频效率加速

PowerShell 中怎么在脚本中声明并接收传入的参数

轻墨酱_3868

轻墨酱_3868

发布时间:2026-09-25 10:02:49

|

154人浏览过

|

来源于php中文网

原创

PowerShell脚本通过param块声明参数,必须位于脚本开头(注释后、执行语句前);支持类型约束、默认值、必填设置、管道输入及值验证等特性。

powershell 脚本中声明并接收参数,主要靠 param 块实现,它必须放在脚本最开头(注释之后、任何可执行语句之前)。

基本语法:用 param 声明参数

在脚本顶部写一个 param 块,里面定义参数名,支持位置参数、命名参数、默认值和类型约束:

  • 不带类型和默认值:[string]$Name
  • 带默认值:$Count = 10
  • 带类型强制:[int]$Port(传入非整数会报错)
  • 设为必填:[Parameter(Mandatory)](配合类型或变量名一起用)

示例脚本 deploy.ps1:

<# 部署脚本,支持 -Env 和 -Version 参数 #>
param(
    [Parameter(Mandatory)]
    [string]$Env,
    [string]$Version = "1.0.0",
    [int]$Timeout = 30
)
Write-Host "环境:$Env,版本:$Version,超时:$Timeout 秒"

调用方式:支持命名和位置两种传参

运行脚本时,可以按名称传参(推荐),也可以按顺序用位置参数(依赖 param 中的声明顺序):

windows-healing-gateway
windows-healing-gateway

通过任务计划程序自动监控并自修复 Windows 上的 OpenClaw Gateway,具备 AI 诊断和 Telegram 报警功能。

下载
  • 命名方式(清晰、安全):.\deploy.ps1 -Env "prod" -Version "2.1.0"
  • 位置方式(需严格对齐顺序):.\deploy.ps1 "staging" "1.5.0" 60 → 对应 $Env, $Version, $Timeout
  • 混合使用也允许:.\deploy.ps1 "dev" -Timeout 120

进阶技巧:支持管道输入和动态验证

如果希望参数能从管道接收(比如 "app1" | .\deploy.ps1),需加 ValueFromPipeline:

param(
    [Parameter(Mandatory, ValueFromPipeline)]
    [string]$AppName
)
process { Write-Host "正在部署:$AppName" }

还可加校验逻辑,比如限制值范围:

param(
    [ValidateSet("dev","test","prod")]
    [string]$Env
)

常见注意事项

  • param 必须是脚本第一个可执行结构(前面只能有注释或空行)
  • 未声明的参数不会自动捕获,$args 只保留未匹配的额外参数(不推荐依赖)
  • 想查看参数帮助,可在 param 上方加注释块,并用 Get-Help .\script.ps1 查看
  • 函数内同样用 param,规则一致

热门AI工具

更多
豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

相关专题

更多
磁盘配额是什么
磁盘配额是什么

磁盘配额是计算机中指定磁盘的储存限制,就是管理员可以为用户所能使用的磁盘空间进行配额限制,每一用户只能使用最大配额范围内的磁盘空间。php中文网为大家提供各种磁盘配额相关的内容,教程,供大家免费下载安装。

3690

2023.06.21

如何安装LINUX
如何安装LINUX

本站专题提供如何安装LINUX的相关教程文章,还有相关的下载、课程,大家可以免费体验。

3193

2023.06.29

linux find
linux find

find是linux命令,它将档案系统内符合 expression 的档案列出来。可以指要档案的名称、类别、时间、大小、权限等不同资讯的组合,只有完全相符的才会被列出来。find根据下列规则判断 path 和 expression,在命令列上第一个 - ( ) , ! 之前的部分为 path,之后的是 expression。还有指DOS 命令 find,Excel 函数 find等。本站专题提供linux find相关教程文章,还有相关

2273

2023.06.30

linux修改文件名
linux修改文件名

本专题为大家提供linux修改文件名相关的文章,这些文章可以帮助用户快速轻松地完成文件名的修改工作,大家可以免费体验。

5450

2023.07.05

linux系统安装教程
linux系统安装教程

linux系统是一种可以免费使用,自由传播,多用户、多任务、多线程、多CPU的操作系统。本专题提供linux系统安装教程相关的文章,大家可以免费体验。

5102

2023.07.06

linux查看文件夹大小
linux查看文件夹大小

Linux是一种自由和开放源码的类Unix操作系统,存在着许多不同的Linux版本,但它们都使用了Linux内核。Linux可安装在各种计算机硬件设备中,比如手机、平板电脑、路由器、视频游戏控制台、台式计算机、大型机和超级计算机。linux怎么查看文件夹大小呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

3033

2023.07.20

linux查看ip命令
linux查看ip命令

本专题为大家提供linux查看ip命令相关文章内容,感兴趣的朋友可以免费下载体验试试。

2545

2023.07.20

linux查看cpu使用率
linux查看cpu使用率

在linux的系统维护中,可能需要经常查看cpu使用率,分析系统整体的运行情况。本专题为大家带来了linux查看cpu使用率的相关文章,感兴趣的朋友千万不要错过了。

2759

2023.07.25

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

120

2026.09.23

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Buffalo框架快速入门指南
Buffalo框架快速入门指南

共0课时 | 0人学习

Conan 2 安装指南
Conan 2 安装指南

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn