Export-Console 帮助信息

 

如下说明是翻译: 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

 

此命令将当前控制台配置导入到当前目录的Console01.psc1文件中. 此命令使用参数Path来指定控制台文件的名称. 默认情况下, Export-Console将会给文件名添加.psc1扩展名, 并在当前目录创建改文件.

 

例5

 

C:/PS>export-console MyConsole

 

C:PS>$ConsoleFilename

 

这些命令将当前控制台配置导出到MyConsole.psc1文件中, 并使用变量$ConsoleFilename找到当前控制台文件的位置.

 

第一个命令使用Export-Console将当前控制台配置导出到当前目录下的MyConsole.psc1文件中. 它使用了参数Path, 由于此参数名是可选项, 所以这里将其省略.

 

第二命令使用变量$ConsoleFilename来找到当前控制台文件的名称:

 

C:/Test/MyConsole.psc1

 

相关链接

Add-PSSnapIn

Get-PSSnapIn

Remove-PSSnapIn