登录  |  注册
当前位置：网站首页 > 更多 > 玩电脑 > 正文

[玩转系统] Show-Command (Microsoft.PowerShell.Utility)

作者：精品下载站 日期：2024-12-14 02:03:31 浏览：14 分类：玩电脑

Show-Command (Microsoft.PowerShell.Utility)

Show-Command

模块 ：Microsoft.PowerShell.Utility

在图形窗口中显示 PowerShell 命令信息。

句法

Show-Command
    [[-Name] <String>]
    [-Height <Double>]
    [-Width <Double>]
    [-NoCommonParameter]
    [-ErrorPopup]
    [-PassThru]
    [<CommonParameters>]

描述

此 cmdlet 仅适用于 Windows 平台。

Show-Command cmdlet 允许您在命令窗口中创建 PowerShell 命令。您可以使用命令窗口的功能来运行命令或让它将命令返回给您。

Show-Command 是一个非常有用的教学工具。 Show-Command 适用于所有命令类型，包括 cmdlet、函数、工作流和 CIM 命令。

如果没有参数，Show-Command 将显示一个命令窗口，其中列出所有已安装模块中的所有可用命令。要查找模块中的命令，请从模块下拉列表中选择该模块。要选择命令，请单击命令名称。

要使用命令窗口，请使用名称或单击命令列表中的命令名称来选择命令。每个参数集都显示在单独的选项卡上。星号表示强制参数。要输入参数值，请在文本框中键入值或从下拉框中选择值。要添加开关参数，请单击以选中参数复选框。

准备就绪后，您可以单击复制将您创建的命令复制到剪贴板，或单击运行运行该命令。您还可以使用PassThru参数将命令返回到主机程序，例如PowerShell控制台。要取消命令选择并返回到显示所有命令的视图，请按 Ctrl 并单击所选命令。

在 PowerShell 集成脚本环境 (ISE) 中，默认情况下会显示 Show-Command 窗口的变体。有关使用此命令窗口的信息，请参阅 PowerShell ISE 帮助主题。

此 cmdlet 在 PowerShell 7 中重新引入。

由于此 cmdlet 需要用户界面，因此它不适用于 Windows Server Core 或 Windows Nano Server。此 cmdlet 仅在支持 Windows 桌面的 Windows 系统上可用。

示例

示例 1：打开命令窗口

此示例显示 Show-Command 窗口的默认视图。 命令窗口显示计算机上安装的所有模块中的所有命令的列表。

Show-Command

示例 2：在命令窗口中打开 cmdlet

此示例在命令窗口中显示Invoke-Command cmdlet。您可以使用此显示来运行 Invoke-Command 命令。

Show-Command -Name "Invoke-Command"

示例 3：打开具有指定参数的 cmdlet

此命令会打开 Connect-PSSession cmdlet 的 Show-Command 窗口。

Show-Command -Name "Connect-PSSession" -Height 700 -Width 1000 -ErrorPopup

高度和宽度参数指定命令窗口的尺寸。 ErrorPopup 参数显示错误命令窗口。

当您单击运行时，Connect-PSSession 命令将运行，就像您在命令行中键入Connect-PSSession 命令一样。

示例 4：为 cmdlet 指定新的默认参数值

此示例使用 $PSDefaultParameterValues 自动变量为 Height、Width 和 ErrorPopup 参数设置新的默认值Show-Command cmdlet 的。

$PSDefaultParameterValues = @{
    "Show-Command:Height" = 700
    "Show-Command:Width" = 1000
    "Show-Command:ErrorPopup" = $True
}

现在，当您运行 Show-Command 命令时，会自动应用新的默认值。要在每个 PowerShell 会话中使用这些默认值，请将 $PSDefaultParameterValues 变量添加到您的 PowerShell 配置文件中。有关详细信息，请参阅 about_Profiles 和 about_Parameters_Default_Values。

示例 5：将输出发送到网格视图

此命令演示如何一起使用 Show-Command 和 Out-GridView cmdlet。

Show-Command Get-ChildItem | Out-GridView

该命令使用 Show-Command cmdlet 打开 Get-ChildItemcmdlet 的命令窗口。单击运行按钮时，Get-ChildItem 命令将运行并生成输出。管道运算符 ( | ) 将 Get-ChildItem 命令的输出发送到 Out-GridView cmdlet，后者显示 Get-ChildItem 输出在交互式窗口中。

示例 6：显示您在命令窗口中创建的命令

此示例显示您在 Show-Command 窗口中创建的命令。该命令使用 PassThru 参数，该参数以字符串形式返回 Show-Command 结果。

Show-Command -PassThru

Get-EventLog -LogName "Windows PowerShell" -Newest 5

例如，如果您使用 Show-Command 窗口创建一个 Get-EventLog 命令来获取 Windows PowerShell 事件日志中的五个最新事件，然后单击 好的，该命令将返回如上所示的输出。查看命令字符串有助于您学习 PowerShell。

示例 7：将命令保存到变量

此示例演示如何运行使用 Show-Command cmdlet 的 PassThru 参数时获取的命令字符串。此策略可让您查看命令并使用它。

$C = Show-Command -PassThru
$C
Invoke-Expression $C

Get-EventLog -LogName "PowerShell" -Newest 5

Index Time          EntryType   Source                 InstanceID Message
----- ----          ---------   ------                 ---------- -------
11520 Dec 16 16:37  Information Windows PowerShell            400 Engine state is changed from None to Available...
11519 Dec 16 16:37  Information Windows PowerShell            600 Provider "Variable" is Started. ...
11518 Dec 16 16:37  Information Windows PowerShell            600 Provider "Registry" is Started. ...
11517 Dec 16 16:37  Information Windows PowerShell            600 Provider "Function" is Started. ...
11516 Dec 16 16:37  Information Windows PowerShell            600 Provider "FileSystem" is Started. ...

第一个命令使用 Show-Command cmdlet 的 PassThru 参数，并将命令结果保存在 $C 变量中。在本例中，我们使用 Show-Command 窗口创建一个 Get-EventLog 命令，用于获取 Windows PowerShell 事件日志中的五个最新事件。当您单击确定时，Show-Command 返回命令字符串，该字符串保存在$C 变量中。

示例 8：将命令的输出保存到变量

此示例使用 ErrorPopup 参数将命令的输出保存在变量中。

$P = Show-Command Get-Process -ErrorPopup
$P

Handles  NPM(K)    PM(K)      WS(K) VM(M)   CPU(s)     Id ProcessName
-------  ------    -----      ----- -----   ------     -- -----------
    473      33    94096     112532   709     2.06   4492 powershell

除了在窗口中显示错误之外，ErrorPopup还将命令输出返回到当前命令，而不是创建新命令。当您运行此命令时，Show-Command 窗口将打开。您可以使用窗口功能来设置参数值。要运行该命令，请单击 Show-Command 窗口中的运行按钮。

参数

-ErrorPopup

指示 cmdlet 除了在命令行中显示错误之外，还在弹出窗口中显示错误。默认情况下，当在 Show-Command 窗口中运行的命令生成错误时，该错误仅显示在命令行中。

此外，当您运行命令时（通过使用 Show-Command 窗口中的 Run 按钮），ErrorPopup 参数会将命令结果返回到当前命令，而不是运行该命令并将其输出返回到新命令。您可以使用此功能将命令结果保存在变量中。

类型 ：

SwitchParameter

位置：

命名

默认值：

False

必需的：

False

接受管道输入：

False

接受通配符：

False

-Height

指定 Show-Command 窗口的高度（以像素为单位）。输入 300 到屏幕分辨率像素数之间的值。如果该值太大而无法在屏幕上显示命令窗口，Show-Command 会生成错误。默认高度为 600 像素。对于包含 Name 参数的 Show-Command 命令，默认高度为 300 像素。

类型 ：

双倍的

位置：

命名

默认值：

None

必需的：

False

接受管道输入：

False

接受通配符：

False

-Name

显示指定命令的命令窗口。输入一个命令的名称，例如 cmdlet、函数或 CIM 命令的名称。如果省略此参数，Show-Command 将显示一个命令窗口，其中列出计算机上安装的所有模块中的所有 PowerShell 命令。

类型 ：

String

别名：

CommandName

位置：

0

默认值：

None

必需的：

False

接受管道输入：

False

接受通配符：

False

-NoCommonParameter

指示此 cmdlet 忽略命令显示的通用参数部分。默认情况下，通用参数显示在命令窗口底部的可扩展部分中。

类型 ：

SwitchParameter

位置：

命名

默认值：

False

必需的：

False

接受管道输入：

False

接受通配符：

False

-PassThru

返回一个代表您正在使用的项目的对象。默认情况下，此 cmdlet 不生成任何输出。要运行命令字符串，请将其复制并粘贴到命令提示符处或将其保存在变量中，然后使用 Invoke-Expression cmdlet 运行变量中的字符串。

类型 ：

SwitchParameter

位置：

命名

默认值：

False

必需的：

False

接受管道输入：

False

接受通配符：

False

-Width

指定 Show-Command 窗口的宽度（以像素为单位）。输入 300 到屏幕分辨率像素数之间的值。如果该值太大而无法在屏幕上显示命令窗口，Show-Command 会生成错误。默认宽度为 300 像素。

类型 ：

双倍的

位置：

命名

默认值：

None

必需的：

False

接受管道输入：

False

接受通配符：

False

输入

无

您无法通过管道将对象传递到此 cmdlet。

输出

无

默认情况下，此 cmdlet 不返回任何输出。

字符串

当您使用 PassThru 参数时，此 cmdlet 将返回一个命令字符串。

对象

当您使用 ErrorPopup 参数时，此 cmdlet 返回命令输出（任何对象）。

笔记

PowerShell 包含以下 Show-Command 别名：

  • Windows:

      shcm

    此 cmdlet 仅适用于 Windows 平台。

    Show-Command 在远程会话中不起作用。

    猜你还喜欢

    您需要 登录账户 后才能发表评论

    取消回复欢迎 你 发表评论:

    精品推荐！
    欢迎 访客 登录没有账号？
    • 最新文章
    • 热门文章
    • 热评文章
    最新评论
      热门tag
      友情链接

      关灯