如下说明是翻译: help Export-Console 产生的帮助信息.
译者: Edengundam(马涛)
Export-Console
摘要
将当前控制台配置导出到文件, 以便于重新使用或将其共享.
语法
Export-Console [[-path] ] [-force] [-noClobber] [-whatIf] [-confirm] []
详细描述
Export-Console cmdlet将当前控制台配置导出到Windows PowerShell控制台文件(.psc1). 你可以使用此cmdlet保存你对属性进行的修改或者添加到控制台Windows PowerShell管理单元的配置信息.
参数
-path
指定控制台文件(*.psc1)的路径名和文件名. 输入的路径名为可选项. 不允许使用通配符.
如果你只输入文件名, Export-Console在当前目录创建以 ".psc1"为文件扩展名的文件.
除非你在当前会话过程中已经导出过控制台信息, 否则必须指定此参数. 如果你指定NoClobber参数组织当前控制台文件被覆盖, 那么此参数也必须指定.
如果你忽略此参数, Export-Console将会覆盖(替换文件中的内容)此会话最近使用过的额控制台文件.
|
强制参数? |
false |
|
参数位置? |
1 |
|
默认值 |
|
|
允许从管道绑定输入? |
true (根据值, 根据属性名) |
|
允许通配符扩展? |
false |
-force
在不破坏安全性的前提下, 能够避免影响命令成功执行的限制条件. Force将在不给出警告的情况下允许你覆盖具有只读属性的文件. 文件只读属性将被取消, 并且在命令结束后也不会被重置.
|
强制参数? |
false |
|
参数位置? |
named |
|
默认值 |
|
|
允许从管道绑定输入? |
false |
|
允许通配符扩展? |
false |
-noClobber
不覆盖(替换原有内容) 已经存在的文件. 默认情况下, 如果文件已经在指定路径存在, 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 .psc1".
关于你可以添加到控制台的Windows PowerShell管理单元信息(以及使用Export-Console进行保存), 输入"Get-Help About_PSSnapins"获得更多信息.
如果需要为该命令提供多个参数, 请使用逗号进行分隔. 例如, " , ".
例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
