Export-Console 帮助信息-优快云博客

本文介绍如何使用Export-Console命令将当前控制台配置导出到文件以便后续使用或分享。文章详细解释了命令的语法、参数及用法，并通过实例演示了如何添加管理单元、导出配置以及使用导出的配置启动新会话。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

如下说明是翻译 : help Export-Console 产生的帮助信息 .

译者 : Edengundam( 马涛 )

Export-Console

摘要

将当前控制台配置导出到文件 , 以便于重新使用或将其共享 .

语法

Export-Console [[-path] <string>] [-force] [-noClobber] [-whatIf] [-confirm] [<CommonParameters>]

详细描述

Export-Console cmdlet 将当前控制台配置导出到 Windows PowerShell 控制台文件 (.psc1). 你可以使用此 cmdlet 保存你对属性进行的修改或者添加到控制台 Windows PowerShell 管理单元的配置信息 .

参数

-path <string>

指定控制台文件 (*.psc1) 的路径名和文件名 . 输入的路径名为可选项 . 不允许使用通配符 .

如果你只输入文件名 , Export-Console 在当前目录创建以 ".psc1" 为文件扩展名的文件 .

除非你在当前会话过程中已经导出过控制台信息 , 否则必须指定此参数 . 如果你指定 NoClobber 参数组织当前控制台文件被覆盖 , 那么此参数也必须指定 .

如果你忽略此参数 , Export-Console 将会覆盖 ( 替换文件中的内容 ) 此会话最近使用过的额控制台文件 .

强制参数 ?	false
参数位置 ?	1
默认值
允许从管道绑定输入 ?	true ( 根据值 , 根据属性名 )
允许通配符扩展 ?	false

-force <SwitchParameter>

在不破坏安全性的前提下 , 能够避免影响命令成功执行的限制条件 . Force 将在不给出警告的情况下允许你覆盖具有只读属性的文件 . 文件只读属性将被取消 , 并且在命令结束后也不会被重置 .

强制参数 ?	false
参数位置 ?	named
默认值
允许从管道绑定输入 ?	false
允许通配符扩展 ?	false

-noClobber <SwitchParameter>

不覆盖 ( 替换原有内容 ) 已经存在的文件 . 默认情况下 , 如果文件已经在指定路径存在 , Export-Console 不提示任何警告 , 将其覆盖 .

强制参数 ?	false
参数位置 ?	named
默认值
允许从管道绑定输入 ?	false
允许通配符扩展 ?	false

-whatIf

描述执行此命令将会发生的现象 , 不会真正执行此命令 .

强制参数 ?	false
参数位置 ?	named
默认值
允许从管道绑定输入 ?	false
允许通配符扩展 ?	false

-confirm

执行命令前提示你进行确认 .

强制参数 ?	false
参数位置 ?	named
默认值
允许从管道绑定输入 ?	false
允许通配符扩展 ?	false

< 公共参数 >

此命令支持公共参数 : -Verbose, -Debug, -ErrorAction, -ErrorVariable, and -OutVariable. 更多信息 , 输入 , "get-help about_commonparameters".

输入类型

none

返回类型

FileInfo 对象

注意

更多信息 , 输入 "Get-Help Export-Console -detailed". 需要技术信息 , 输入 "Get-Help Export-Console -full".

当前控制台文件的名称被自动的保存在 $ConsoleFilename 变量中 . 如果此变量中没有值 , 则当前控制台为 Windows PowerShell 的默认控制台 .

要在一个新的会话中使用 Windows PowerShell 控制台文件 , 使用下面的语法启动 Windows PowerShell:

"powershell.exe -PsConsoleFile <ConsoleFile>.psc1".

关于你可以添加到控制台的 Windows PowerShell 管理单元信息 ( 以及使用 Export-Console 进行保存 ), 输入 "Get-Help About_PSSnapins" 获得更多信息 .

如果需要为该命令提供多个参数 , 请使用逗号进行分隔 . 例如 , "<parameter-name> <value1>, <value2>".

例 1

C:/PS>export-console -path $pshome/Consoles/ConsoleS1.psc1

此命令将控制台配置导入到变量 $pshome 保存的目录位置的 Console 子目录中的 ConsoleS1.psc1 文件 . 默认情况下 , $pshome 存储着 Windows PowerShell 的安装目录 . 要查看你的计算机上此变量的值输入 "$pshome".

例 2

C:/PS>export-console

此命令导出控制台配置到当前会话最近使用过的 Windows PowerShell 控制台文件 , 此命令将会覆盖文件中已经存在的配置信息 .

如果在当前会话中没有导出控制台文件 , 你将会被提示是否继续处理并被要求输入文件名称 .

例 3

C:/PS>add-pssnapin NewPSSnapIn

export-console -path NewPsSnapinConsole.psc1

powershell.exe -PsConsoleFile NewPsSnapinConsole.psc1

这些命令添加 Windows PowerShell 管理单元 NewPsSnapin 到当前控制台 , 并将导出当前控制台配置 , 最后使用新控制台配置启动 Windows PowerShell 会话 .

第一个命令使用 Add-PsSnapin cmdlet 将 NewPsSnapin 管理单元添加到当前控制台 . 你只能添加那些在你系统中注册的管理单元 .

第二个命令将包含管理单元的控制台配置导出到 NewPsSnapinConsole.psc1 文件 .

第三个命令使用 NewPsSnapinConsole.psc1 文件启动 Windows PowerShell.

当你将 Windows PowerShell 管理单元添加到控制台时 , 管理单元支持的提供程序和 cmdlet 立即可以被使用 . 你不需要启动的新的会话 . 然而 , 管理单元仅仅被添加到当前控制台 , 新会话将不会包括新添加的管理单元 , 您可以通过导出当前控制台配置 , 并在启动 Windows PowerShell 时指定该配置来允许新的管理单元依然可以使用 .

例 4

C:/PS>export-console -path Console01