Function Provider

将当前位置更改为 Function: 驱动器。您可以从 Windows PowerShell 的任一驱动器中使用此命令。若要返回到文件系统驱动器，请键入驱动器名称。例如，键入“set-location c:”。

set-location function:

此命令获取当前会话中所有函数的列表。您可以从任一 Windows PowerShell 驱动器中使用此命令。

get-childitem -path function:

此命令从 Function: 驱动器中获取“man”函数。此命令使用 Get-Item cmdlet 来获取该函数。管道运算符 (|) 将结果发送给 Format-Table。

Wrap 参数将一行中容纳不下的文本转至下一行。Autosize 参数重新调整各表列的大小以容纳文本。

get-item -path man | format-table -wrap -autosize

如果您位于其他驱动器中，请将驱动器名称 (Function:) 添加到路径中。

这些命令都可获取名为“c:”的函数。第一个命令可在任何驱动器中使用。第二个命令在 Function: 驱动器中使用。

由于名称以冒号结束（这是用于驱动器的语法），因此您必须使用驱动器名称来限定路径。在 Function: 驱动器中，可以使用两种格式之一。在第二个命令中，点 (.) 表示当前位置。

c:\PS> get-item -path function:c:

PS Function> get-item -path .\c:

此命令使用 New-Item cmdlet 来创建一个名为“HKLM:”的函数。大括号中的表达式是以函数名称表示的脚本块。

new-item -path function:hklm: -value {set-location hklm:}

也可以通过在 Windows PowerShell 命令行中键入函数来创建函数。例如，键入“function:hklm: {set-location hklm:}”。如果您位于 Function: 驱动器中，则可以省略驱动器名称。 由于在 New-Item 中无法指定“Filter”标签，因此筛选器被标记为函数，不过它们使用任何标签都能正常运行。若要创建带有“Filter”标签的筛选器，请在命令行中键入 filter。例如，键入“filter:Running {$_.Status -eq "Running"}”。

此命令使用 New-Item cmdlet 来创建一个名为 Csrss 的函数。此命令使用 Options 动态参数将该函数的 Options 属性值指定为 ReadOnly。

new-item -path function: -name csrss -options readonly -value {get-process csrss}

此命令可以从任何位置运行。如果您位于 Function: 驱动器中，则可以点 (.) 来指定路径。点表示当前位置。

此命令从当前会话中删除“hklm:”函数。

remove-item function:hklm:

此命令从当前会话中删除所有函数，但其 Options 属性的值为 Constant 的函数除外。如果不使用 Force 参数，则此命令不删除 Options 属性值为 ReadOnly 的函数。

remove-item function:* -force

在删除所有函数后，命令提示符将会更改，这是由于删除了用于定义命令提示符内容的 prompt 函数。

此命令使用 Get-Item cmdlet 来获取所有函数。管道运算符将结果发送给 Get-Member cmdlet，后者显示该对象的方法和属性。

get-item -path function:* | get-member

在通过管道将对象集合（例如 Function: 驱动器中的函数集合）传递给 Get-Member 时，Get-Member 将分别评估该集合中的每个对象，并返回它找到的有关每个对象类型的信息。如果所有对象都为同一类型，则它将返回有关单一对象类型的信息。在本例中，所有函数均为 FunctionInfo 对象。 若要获取有关 FunctionInfo 对象集合的信息，请使用 Get-Member 的 InputObject 参数。例如，键入“get-member -InputObject (get-item function:*)”。使用 InputObject 参数时，Get-Member 将对集合而不是对集合中的对象进行评估。

此命令列出了“prompt”函数的属性值。此命令使用 Get-Item cmdlet 来获取表示“prompt”函数的对象。管道运算符 (|) 将结果发送到 Format-List 命令。Format-List 命令对 Property 参数使用通配符 (*) 来设置“prompt”函数的所有属性值的格式并显示这些值。

get-item function:prompt | format-list -property *

您可以使用 Set-Item cmdlet 以及 Options 动态参数来更改函数的 Options 属性的值。

此命令设置“prompt”函数的 AllScope 选项和 ReadOnly 选项。此命令使用 Set-Item cmdlet 的 Options 动态参数。只有在将 Options 参数与 Alias 或 Function 提供程序一起使用时，该参数才在 Set-Item 中可用。

set-item -path function:prompt -options "AllScope,ReadOnly"

此命令使用 Set-Item cmdlet 来更改“prompt”函数，以便让该函数在路径之前显示时间。

set-item -path function:prompt -value {'PS '+ $(Get-Date -format t) + " " + $(Get-Location) + '> '}

此更改将同时影响 FunctionInfo 对象的 Definition 和 ScriptBlock 属性。若要查看更改的效果，请键入“get-item -path function:prompt | format-list -property *”。

此命令使用 Rename-Item cmdlet 将“help”函数的名称更改为“gh”。

rename-item -path function:help -newname gh

此命令将“prompt”函数复制为“oldPrompt”，其效果相当于为与 prompt 函数相关联的脚本块创建了一个新名称。如果计划更改原始 prompt 函数，您可以使用此命令来保存该函数。

新函数的 Options 属性的值为 None。若要更改 Options 属性的值，请使用 Set-Item。

copy-item -path function:prompt -destination function:oldPrompt