Get-Content 帮助信息

[align=left]如下说明是翻译PowerShell中: help Get-Content 产生的帮助信息. [/align]
译者: Edengundam(马涛)

[align=left]Get-Content[/align]

[align=left]大纲[/align]
[align=left]取得指定位置上的项的内容.[/align]
[align=left] [/align]
[align=left]语法[/align]
[align=left]Get-Content [-path] <string[]> [-totalCount <long>] [-readCount <long>] [-include <string[]>] [-exclude <string[]>] [-filter <string>] [-force] [-credential <PSCredential>] [-encoding {<Unknown> | <String> | <Unicode> | <Byte> | <BigEndianUnicode> | <UTF8> | <UTF7> | <Ascii>}] [<CommonParameters>][/align]
[align=left] [/align]
[align=left]Get-Content [-literalPath] <string[]> [-totalCount <long>] [-readCount <long>] [-include <string[]>] [-exclude <string[]>] [-filter <string>] [-force] [-credential <PSCredential>] [-encoding {<Unknown> | <String> | <Unicode> | <Byte> | <BigEndianUnicode> | <UTF8> | <UTF7> | <Ascii>}] [<CommonParameters>][/align]
[align=left] [/align]
[align=left]详细描述[/align]
[align=left]Get-Content cmdlet取得路径指定的位置上项的内容, 例如文件中的文本信息. 它一次读取一行内容, 并将每行当作一个对象返回.[/align]
[align=left] [/align]
[align=left]参数[/align]
[align=left] [/align]
[align=left]-path <string[]>[/align]
[align=left]指定项的路径. Get-Content取得指定项的内容. 允许使用通配符. 参数名称("-Path" or "-FilePath")为可选项.[/align]
[align=left] [/align]

[align=left]强制参数?[/align]	[align=left]true[/align]
[align=left]参数位置?[/align]	[align=left]1[/align]
[align=left]默认值[/align]	[align=left]N/A - The path must be specified[/align]
[align=left]允许从管道绑定输入?[/align]	[align=left]true (根据属性名)[/align]
[align=left]允许通配符扩展?[/align]	[align=left]true[/align]

[align=left] [/align]
[align=left]-totalCount <long>[/align]
[align=left]指定需要取得的总行数. 默认值为 -1 (所有行).[/align]
[align=left] [/align]

[align=left]强制参数?[/align]	[align=left]false[/align]
[align=left]参数位置?[/align]	[align=left]named[/align]
[align=left]默认值[/align]	[align=left]0[/align]
[align=left]允许从管道绑定输入?[/align]	[align=left]true (根据属性名)[/align]
[align=left]允许通配符扩展?[/align]	[align=left]false[/align]

[align=left] [/align]
[align=left]-readCount <long>[/align]
[align=left]指定每次通过管道发送的行数. 默认值为0, 一次发送所有的内容. [/align]
[align=left] [/align]
[align=left]此参数不会影响内容的显示, 但是影响着显示内容的时间. 随着ReadCount的增加, 返回第一行的时间逐渐增加, 但是操作过程的总时间减少了. 当输入项很大时, 会感受到明显的区别.[/align]
[align=left] [/align]

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

[align=left] [/align]
[align=left]-include <string[]>[/align]
[align=left]取得指定项. 此参数值用于限定Path参数. 输入一个路径元素或模式, 例如"*.txt"(此参数允许通配符).允许使用通配符.[/align]
[align=left] [/align]

[align=left]强制参数?[/align]	[align=left]false[/align]
[align=left]参数位置?[/align]	[align=left]named[/align]
[align=left]默认值[/align]	[align=left] [/align]
[align=left]允许从管道绑定输入?[/align]	[align=left]false[/align]
[align=left]允许通配符扩展?[/align]	[align=left]true[/align]

[align=left] [/align]
[align=left]-exclude <string[]>[/align]
[align=left]忽略指定项. 此参数值用于限定Path参数. 输入一个路径元素或模式, 例如"*.txt"(此参数允许通配符).允许使用通配符.[/align]
[align=left] [/align]

[align=left]强制参数?[/align]	[align=left]false[/align]
[align=left]参数位置?[/align]	[align=left]named[/align]
[align=left]默认值[/align]	[align=left] [/align]
[align=left]允许从管道绑定输入?[/align]	[align=left]false[/align]
[align=left]允许通配符扩展?[/align]	[align=left]true[/align]

[align=left] [/align]
[align=left]-filter <string>[/align]
[align=left]指定特定provider格式或语言的过滤器.此参数值用于限定Path参数. 过滤器的语法取决于provider(是否支持通配符也依赖provider). 过滤器相比其他参数更加有效, 主要因为provider取值时候使用过滤器, 而不是等到provider将所有内容返回后, 由Windows PowerShell 过滤对象.[/align]
[align=left] [/align]

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

[align=left] [/align]
[align=left]-force <SwitchParameter>[/align]
[align=left]在不破坏安全性的前提下, 能够避免影响命令成功执行的限制条件, 例如: Force参数能够覆盖具有只读属性的文件或创建路径中的必要成分, 但是不会改变任何文件的权限.[/align]
[align=left] [/align]

[align=left]强制参数?[/align]	[align=left]false[/align]
[align=left]参数位置?[/align]	[align=left]named[/align]
[align=left]默认值[/align]	[align=left]False[/align]
[align=left]允许从管道绑定输入?[/align]	[align=left]false[/align]
[align=left]允许通配符扩展?[/align]	[align=left]false[/align]

[align=left] [/align]
[align=left]-credential <PSCredential>[/align]
[align=left]使用其他凭证进行文件访问认证. <Credential>代表着用户名(例如: "User01"或"Domain01/User01") 或者PSCredential对象(例如: 通过Get-Credential cmdlet取得的对象). 如果此处使用用户名, 命令执行时会提示输入该用户密码. 尽管此参数出现, 但是并非所有Windows PowerShell核心cmdlets或providers支持此功能.[/align]
[align=left] [/align]

[align=left]强制参数?[/align]	[align=left]false[/align]
[align=left]参数位置?[/align]	[align=left]named[/align]
[align=left]默认值[/align]	[align=left] [/align]
[align=left]允许从管道绑定输入?[/align]	[align=left]true (根据属性名)[/align]
[align=left]允许通配符扩展?[/align]	[align=left]false[/align]

[align=left] [/align]
[align=left]-encoding <FileSystemCmdletProviderEncoding>[/align]
[align=left]指定用于显示内容的字符编码类型. 此参数只能在Windows PowerShell文件系统提供程序中使用.[/align]
[align=left] [/align]
[align=left]下面列出此参数接受的值:[/align]
[align=left] [/align]
[align=left]· Unknown[/align]
[align=left]· String[/align]
[align=left]· Unicode[/align]
[align=left]· Byte[/align]
[align=left]· BigEndian[/align]
[align=left]· Unicode[/align]
[align=left]· UTF8[/align]
[align=left]· UTF7[/align]
[align=left]· Ascii[/align]
[align=left] [/align]

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

[align=left] [/align]
[align=left]-literalPath <string[]>[/align]
[align=left]指定项的路径. 与Path不同, LiteralPath的值被直接使用, 不会对任何通配符进行解释. 如果路径中包含了转义字符, 需要将路径用单引号保护. 单引号指示Windows PowerShell不对字符串中的转义字符进行处理.[/align]
[align=left] [/align]

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

[align=left] [/align]
[align=left]<公共参数>[/align]
[align=left]此命令支持公共参数: -Verbose, -Debug, -ErrorAction, -ErrorVariable, and -OutVariable. 更多信息, 输入, "get-help about_commonparameters".[/align]
[align=left] [/align]
[align=left]注意[/align]
[align=left] [/align]
[align=left]更多信息, 输入"Get-Help Get-Content -detailed".需要技术信息, 输入"Get-Help Get-Content -full".[/align]
[align=left] [/align]
[align=left]如果需要为该命令提供多个参数, 请使用逗号进行分隔. 例如, "<parameter-name> <value1>, <value2>".[/align]
[align=left] [/align]
[align=left]你可以使用Get-Content的内建别名"cat", "type"和"gc".需要更多信息, 查看 About_Alias.[/align]
[align=left] [/align]
[align=left]例1 [/align]
[align=left] [/align]
[align=left]C:/PS>get-content -Path C:/Chapters/chapter1.txt[/align]
[align=left] [/align]
[align=left]此命令在控制台上显示文件Chapter1.txt的内容. 此命令使用参数Path来指定项的名称(路径). Get-Content实际上将文件内容继续沿着管道线传递, 由于没有任何后继管道成员, 内容被格式化并显示在控制台上.[/align]
[align=left] [/align]
[align=left]例2 [/align]
[align=left] [/align]
[align=left]C:/PS>get-content c:/Logs/Log060912.txt -totalcount 50 | set-content sample.txt[/align]
[align=left] [/align]
[align=left]此命令取得文件Log060912.txt的前50行并将它们存储在文件sample.txt中. 命令使用Get-Content cmdlet取得文件中的文本. (参数Path的名称是可选项, 在这个例子中被省略了.) 参数TotalCount限制只取得前50行. 管道运算符(|)将结果发送到Set-Content, 后者将它们存储到文件sample.txt中.[/align]
[align=left] [/align]
[align=left]相关链接[/align]
[align=left]Add-Content[/align]
[align=left]Set-Content[/align]
[align=left]Clear-Content[/align]
[align=left]about_namespace[/align]