Windows PowerShell 명령 및 개념에 대한 정보를 표시합니다.

구문

Get-Help [-Full] [[-Name] <string>] [-Category <string[]>] [-Component <string[]>] [-Functionality <string[]>] [-Online] [-Path <string>] [-Role <string[]>] [<CommonParameters>]

Get-Help [-Detailed] [[-Name] <string>] [-Category <string[]>] [-Component <string[]>] [-Functionality <string[]>] [-Online] [-Path <string>] [-Role <string[]>] [<CommonParameters>]

Get-Help [-Examples] [[-Name] <string>] [-Category <string[]>] [-Component <string[]>] [-Functionality <string[]>] [-Online] [-Path <string>] [-Role <string[]>] [<CommonParameters>]

Get-Help [-Parameter <string>] [[-Name] <string>] [-Category <string[]>] [-Component <string[]>] [-Functionality <string[]>] [-Online] [-Path <string>] [-Role <string[]>] [<CommonParameters>]

설명

Get-Help cmdlet은 cmdlet, 공급자, 함수 및 스크립트를 포함하여 Windows PowerShell 개념 및 명령에 대한 정보를 표시합니다. 모든 cmdlet 도움말 항목 제목의 목록을 보려면 "get-help *"를 입력하십시오.

"Get-Help"를 입력한 다음 도움말 항목의 정확한 이름이나 도움말 항목에 고유한 단어를 입력하는 경우 Get-Help는 항목 내용을 표시합니다. 여러 도움말 항목 제목에 나타나는 단어 또는 단어 패턴을 입력하는 경우 Get-Help는 일치하는 제목의 목록을 표시합니다. 어떠한 도움말 항목 제목에도 나타나지 않는 단어를 입력하는 경우 Get-Help는 내용에 해당 단어가 포함된 항목의 목록을 표시합니다.

"get-help" 외에도 한 번에 한 텍스트 화면을 표시하는 "man" 또는 "help"를 입력하거나 Get-Help와 동일하지만 cmdlet에 대해서만 작동하는 "<cmdlet-name> -?"를 입력할 수도 있습니다.

전체 도움말 파일을 표시하거나 구문, 매개 변수 또는 예와 같은 cmdlet 도움말 파일의 선택된 부분을 표시할 수 있습니다. 또한 Online 매개 변수를 사용하여 도움말 파일의 온라인 버전을 인터넷 브라우저에 표시할 수 있습니다. 이러한 매개 변수는 개념 도움말 항목에 영향을 주지 않습니다.

Windows PowerShell의 개념 도움말 항목은 "about_Comparison_Operators"와 같이 "about_"으로 시작합니다. 모든 "about_" 항목을 표시하려면 "get-help about_*"를 입력하고, 특정 항목을 표시하려면 "get-help about_<topic-name>"(예: "get-help about_Comparison_Operators")을 입력하십시오.

매개 변수

-Category <string[]>

지정된 범주의 항목에 대한 도움말을 표시합니다. 유효한 값은 Alias, Cmdlet, Provider 및 HelpFile입니다. 개념 항목은 HelpFile 범주에 포함됩니다.

Category는 Get-Help가 반환하는 MamlCommandHelpInfo 개체의 속성입니다. 이 매개 변수는 개념("about_") 도움말의 표시에는 영향을 주지 않습니다.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-Component <string[]>

지정된 구성 요소 값(예: "Exchange")이 있는 도구 목록을 표시합니다. 구성 요소 이름을 입력합니다. 와일드카드를 사용할 수 있습니다.

Component는 Get-Help가 반환하는 MamlCommandHelpInfo 개체의 속성입니다. 이 매개 변수는 개념("About_") 도움말의 표시에는 영향을 주지 않습니다.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-Detailed

매개 변수 설명과 예를 기본 도움말 표시에 추가합니다.

이 매개 변수는 개념("About_") 도움말의 표시에는 영향을 주지 않습니다.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-Examples

이름, 개요 및 예만 표시합니다. 예만 표시하려면 "(get-help <cmdlet-name>).examples"를 입력하십시오.

이 매개 변수는 개념("About_") 도움말의 표시에는 영향을 주지 않습니다.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-Full

매개 변수 설명 및 특성, 예, 입력 및 출력 개체 유형 및 추가 참고를 비롯한 cmdlet의 전체 도움말 파일을 표시합니다.

이 매개 변수는 개념("About_") 도움말의 표시에는 영향을 주지 않습니다.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-Functionality <string[]>

지정된 기능이 있는 항목에 대한 도움말을 표시합니다. 기능을 입력하십시오. 와일드카드를 사용할 수 있습니다.

Functionality는 Get-Help가 반환하는 MamlCommandHelpInfo 개체의 속성입니다. 이 매개 변수는 개념("About_") 도움말의 표시에는 영향을 주지 않습니다.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-Name <string>

지정된 도구 또는 개념 항목에 대한 도움말을 요청합니다. cmdlet, 공급자, 스크립트 또는 함수 이름(예: Get-Member), 개념 항목 이름(예: "about_Objects") 또는 별칭(예: "ls")을 입력합니다. cmdlet 및 공급자 이름에 와일드카드를 사용할 수 있지만 와일드카드를 사용하여 함수 도움말 및 스크립트 도움말 항목의 이름을 찾을 수는 없습니다.

Path 환경 변수에 나열된 경로에 없는 스크립트에 대한 도움말을 가져오려면 스크립트의 경로 및 파일 이름을 입력합니다.

도움말 항목의 정확한 이름을 입력하는 경우 Get-Help는 해당 항목의 내용을 표시합니다. 여러 도움말 항목 제목에 나타나는 단어 또는 단어 패턴을 입력하는 경우 Get-Help는 일치하는 제목의 목록을 표시합니다. 어떠한 도움말 항목 제목과도 일치하지 않는 단어를 입력하는 경우 Get-Help는 내용에 해당 단어가 포함된 항목의 목록을 표시합니다.

about_Objects와 같은 개념 항목의 이름은 영어 이외 버전의 Windows PowerShell을 사용하는 경우에도 영어로 입력해야 합니다.

필수 여부

false

위치

1

기본값

파이프라인 입력 적용 여부

true (ByPropertyName)

와일드카드 문자 적용 여부

false

-Online

도움말 항목의 온라인 버전을 기본 인터넷 브라우저에 표시합니다. 이 매개 변수는 cmdlet, 함수 및 스크립트 도움말 항목에만 사용할 수 있습니다.

Get-Help는 cmdlet, 함수 또는 스크립트 도움말 항목의 관련 링크 섹션에서 첫 번째 항목에 나타나는 인터넷 주소(Uniform Resource Identifier [URI])를 사용합니다. 이 매개 변수는 도움말 항목이 "Http" 또는 "Https"로 시작하는 URI를 포함하고 시스템에 인터넷 브라우저가 설치되어 있는 경우에만 작동합니다.

작성하는 도움말 항목에서 이 기능을 지원하는 방법에 대한 자세한 내용은 about_Comment_Based_Help 및 MSDN(Microsoft Developer Network) 라이브러리의 "How to Write Cmdlet Help(Cmdlet 도움말 작성 방법)"(https://go.microsoft.com/fwlink/?LinkID=123415)를 참조하십시오.

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-Parameter <string>

지정된 매개 변수에 대한 자세한 설명만 표시합니다. 와일드카드를 사용할 수 있습니다.

이 매개 변수는 개념("About_") 도움말의 표시에는 영향을 주지 않습니다.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-Path <string>

지정된 공급자 경로에서 cmdlet이 작동하는 방식을 설명하는 도움말을 가져옵니다. Windows PowerShell 공급자 경로를 입력합니다.

이 매개 변수는 지정된 Windows PowerShell 공급자 경로에서 cmdlet이 어떻게 작동하는지 설명하는 cmdlet 도움말 항목의 사용자 지정 버전을 가져옵니다. 이 매개 변수는 공급자 cmdlet의 도움말에 대해서만 유효하며 공급자에 공급자 cmdlet 도움말 항목의 사용자 지정 버전이 포함되어 있는 경우에만 유효합니다.

공급자 경로에 대한 사용자 지정 cmdlet 도움말을 보려면 공급자 경로 위치로 이동하여 Get-Help 명령을 입력하거나 임의의 경로 위치에서 Get-Help의 Path 매개 변수를 사용하여 공급자 경로를 지정합니다. 자세한 내용은 about_Providers를 참조하십시오.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-Role <string[]>

지정된 사용자 역할에 맞게 사용자 지정된 도움말을 표시합니다. 역할을 입력하십시오. 와일드카드를 사용할 수 있습니다.

사용자가 조직에서 수행하는 역할을 입력합니다. 일부 cmdlet은 이 매개 변수 값을 기반으로 해당 도움말 파일에서 서로 다른 텍스트를 표시합니다. 이 매개 변수는 핵심 cmdlet의 도움말에는 영향을 주지 않습니다.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

<CommonParameters>

이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 about_Commonparameters.

입력 및 출력

입력 유형은 cmdlet으로 파이프할 수 있는 개체의 유형입니다. 반환 유형은 cmdlet에서 반환되는 개체의 유형입니다.

입력

없음

개체를 이 cmdlet으로 파이프할 수 없습니다.

출력

System.String 또는 MamlCommandHelpInfo

개념 항목을 요청할 경우 Get-Help는 개념 항목을 문자열로 반환합니다. cmdlet, 함수 또는 스크립트의 이름을 지정하면 MamlCommandHelpInfo 개체가 반환됩니다. 그렇지 않을 경우 Get-Help는 $pshome 디렉터리의 Help.Format.ps1xml 파일에 지정된 형식 뷰 중 하나를 반환합니다.

참고

매개 변수가 없는 경우 "Get-Help"는 Windows PowerShell 도움말 시스템에 대한 정보를 표시합니다.

도움말 전체 보기(-full)에서는 매개 변수에 대한 정보 테이블을 제공합니다. 이 테이블에는 다음 필드가 포함되어 있습니다.

-- 필수 여부: 매개 변수가 필수(true)인지 또는 선택 사항(false)인지를 나타냅니다.

-- 위치: 매개 변수가 명명된 매개 변수인지 위치(번호가 매겨진) 매개 변수인지를 나타냅니다. 위치 매개 변수는 명령에서 지정된 위치에 표시해야 합니다.

-- "Named"는 매개 변수 이름이 필수이지만 해당 매개 변수를 명령에서 어느 위치에든 표시할 수 있음을 나타냅니다.

-- <Number>는 매개 변수 이름이 선택 사항이지만 이름을 생략할 경우 번호로 지정된 위치에 매개 변수가 있어야 함을 나타냅니다. 예를 들어 "2"는 매개 변수 이름을 생략할 경우 해당 매개 변수가 명령에서 두 번째(2)에 있거나 명명되지 않은 매개 변수여야 함을 나타냅니다. 매개 변수 이름을 사용할 경우에는 해당 매개 변수를 명령에서 어느 위치에든 표시할 수 있습니다.

-- 기본값: 명령에 매개 변수를 포함하지 않을 경우 Windows PowerShell에서 사용하는 매개 변수 값입니다.

-- 파이프라인 입력 적용 여부: 파이프라인을 통해 개체를 매개 변수로 보낼 수 있는지 여부(true 또는 false)를 나타냅니다. "By Property Name"은 파이프라인 개체에 매개 변수와 이름이 같은 속성이 있어야 함을 의미합니다.

-- 와일드카드 문자 적용 여부: 매개 변수 값에 와일드카드 문자(예: * 및 ?)를 사용할 수 있는지 여부를 나타냅니다.

예 1

C:\PS>get-help

설명
-----------
이 명령은 Windows PowerShell 도움말 시스템에 대한 도움말을 표시합니다.






예 2

C:\PS>get-help *

설명
-----------
이 명령은 Windows PowerShell 도움말 시스템의 모든 도움말 파일 목록을 표시합니다.






예 3

C:\PS>get-help get-alias

C:\PS>help get-alias

C:\PS>get-alias -?

설명
-----------
이들 명령은 get-alias cmdlet에 대한 기본 정보를 표시합니다. "Get-Help" 및 "-?" 명령은 정보를 한 페이지에 표시합니다. "Help" 명령은 한 번에 한 페이지씩 정보를 표시합니다.






예 4

C:\PS>get-help about_*

설명
-----------
이 명령은 Windows PowerShell 도움말에 포함된 개념 항목 목록을 표시합니다. 이러한 항목은 모두 "about_"으로 시작합니다. 특정 도움말 파일을 표시하려면 "get-help <topic-name>"(예: "get-help about_signing")을 입력하십시오.






예 5

C:\PS>get-help ls -detailed

설명
-----------
이 명령은 별칭 중하나("ls")를 지정하여 Get-ChildItem cmdlet의 자세한 도움말을 표시합니다. Detailed 매개 변수는 매개 변수 설명 및 예가 포함된 도움말 파일의 자세히 보기를 요청합니다. Cmdlet의 전체 도움말 파일을 보려면 Full 매개 변수를 사용합니다.






예 6

C:\PS>get-help format-string -full

설명
-----------
이 명령은 Format-String cmdlet의 전체 보기 도움말을 표시합니다. 도움말 전체 보기에는 매개 변수 설명 및 예가 포함되어 있으며, 매개 변수에 대한 기술적 세부 정보 테이블을 제공합니다.






예 7

C:\PS>get-help start-service -examples

설명
-----------
이 명령은 Windows PowerShell 명령에 start-service를 사용하는 예를 표시합니다.






예 8

C:\PS>get-help get-childitem -parameter f*

설명
-----------
이 명령은 "f"로 시작하는 Get-ChildItem cmdlet의 매개 변수(filter 및 force)에 대한 설명을 표시합니다. 모든 매개 변수에 대한 설명을 보려면 "get-help get-childitem parameter*"를 입력하십시오.






예 9

C:\PS>(get-help write-output).syntax

설명
-----------
이 명령은 Write-Output cmdlet의 구문만 표시합니다. 

구문은 도움말 개체의 많은 속성 중 하나이며 다른 속성으로는 설명, 세부 정보, 예, 매개 변수 등이 있습니다. 도움말 개체의 모든 속성 및 메서드를 찾으려면 "get-help <cmdlet-name> | get-member"(예: "get-help start-service | get member")를 입력하십시오.






예 10

C:\PS>(get-help trace-command).alertset

설명
-----------
이 명령은 cmdlet에 대한 정보를 표시합니다. 이 정보는 도움말 개체의 alertSet 속성에 저장됩니다.

이 정보에는 개념 정보와 cmdlet 사용에 대한 팁이 포함되어 있습니다. 기본적으로 이 정보는 Get-Help의 Full 매개 변수를 사용할 때만 표시되지만 alertSet 속성을 통해서도 이 정보를 표시할 수 잇습니다.






예 11

C:\PS>get-help add-member -full | out-string -stream | select-string -pattern clixml

설명
-----------
이 예에서는 특정 cmdlet 도움말 항목에서 단어를 검색하는 방법을 보여 줍니다. 이 명령은 Add-Member cmdlet의 정식 버전 도움말 항목에서 "clixml"이라는 단어를 검색합니다. 

Get-Help cmdlet은 문자열이 아니라 MamlCommandHelpInfo 개체를 생성하기 때문에 도움말 항목 내용을 Out-String 또는 Out-File과 같은 문자열로 변환하는 명령을 사용해야 합니다.






예 12

C:\PS>get-help get-member -online

설명
-----------
이 명령은 Get-Member cmdlet의 온라인 버전 도움말 항목을 표시합니다.






예 13

C:\PS>get-help remoting

설명
-----------
이 명령은 내용에 "remoting"이라는 단어가 포함된 항목의 목록을 표시합니다. 

어떠한 항목 제목에도 나타나지 않는 단어를 입력하는 경우 Get-Help는 해당 단어가 포함된 항목의 목록을 표시합니다.






예 14

C:\PS>get-help get-item -path SQLSERVER:\DataCollection

NAME
    Get-Item

SYNOPSIS
    Gets a collection of Server objects for the local computer and any computers to which you have made a SQL Server PowerShell connection.       
...

C:\PS> cd SQLSERVER:\DataCollection
C:\PS> SQLSERVER:\DataCollection> get-help get-item


NAME
    Get-Item

SYNOPSIS
    Gets a collection of Server objects for the local computer and any computers to which you have made a SQL Server PowerShell connection.       
...


C:\PS> Get-Item

NAME
    Get-Item

SYNOPSIS
    Gets the item at the specified location.

...

설명
-----------
이 예에서는 Windows PowerShell SQL Server 공급자의 DataCollection 노드에서 Get-Item cmdlet을 사용하는 방법을 설명하는 Get-Item cmdlet의 도움말을 가져오는 방법을 보여 줍니다.

또한 Get-Item의 사용자 지정 도움말을 가져오는 두 가지 방법을 보여 줍니다. 

첫 번째 명령은 Get-Help의 Path 매개 변수를 사용하여 공급자 경로를 지정합니다. 이 명령은 모든 경로 위치에서 입력할 수 있습니다.

두 번째 명령은 Set-Location cmdlet(별칭 = "cd")을 사용하여 공급자 경로로 이동합니다. 이 위치에서 Path 매개 변수가 없는 경우에도 Get-Help 명령은 공급자 경로에 대한 사용자 지정 도움말을 가져옵니다.

세 번째 명령은 파일 시스템 경로의 Get-Help 명령은 Path 매개 변수 없이 Get-Item cmdlet의 표준 도움말을 가져오는 것을 보여 줍니다.






예 15

C:\PS>get-help c:\ps-test\MyScript.ps1

설명
-----------
이 명령은 MyScript.ps1 스크립트에 대한 도움말을 가져옵니다. 함수 및 스크립트에 대한 도움말을 작성하는 방법에 대한 자세한 내용은 about_Comment_Based_Help를 참조하십시오.






참고 항목




목차