ConvertTo-Html

참조

모듈:: Microsoft.PowerShell.Utility

Microsoft .NET Framework 개체를 웹 브라우저에 표시할 수 있는 HTML로 변환합니다.

구문

ConvertTo-Html
              [-InputObject <PSObject>]
              [[-Property] <Object[]>]
              [[-Body] <String[]>]
              [[-Head] <String[]>]
              [[-Title] <String>]
              [-As <String>]
              [-CssUri <Uri>]
              [-PostContent <String[]>]
              [-PreContent <String[]>]
              [<CommonParameters>]

ConvertTo-Html
              [-InputObject <PSObject>]
              [[-Property] <Object[]>]
              [-As <String>]
              [-Fragment]
              [-PostContent <String[]>]
              [-PreContent <String[]>]
              [<CommonParameters>]

Description

ConvertTo-Html cmdlet은 .NET Framework 개체를 웹 브라우저에 표시할 수 있는 HTML로 변환합니다. 이 cmdlet을 사용하여 웹 페이지에 명령의 출력을 표시할 수 있습니다.

ConvertTo-Html 매개 변수를 사용하여 개체 속성을 선택하고, 테이블 또는 목록 형식을 지정하고, HTML 페이지 제목을 지정하고, 개체 앞과 뒤에 텍스트를 추가하고, 엄격한 DTD 페이지 대신 테이블 또는 목록 조각만 반환할 수 있습니다.

ConvertTo-Html여러 개체를 제출하면 Windows PowerShell에서 제출하는 첫 번째 개체의 속성에 따라 테이블 또는 목록을 만듭니다. 나머지 개체에 지정된 속성 중 하나가 없는 경우 해당 개체의 속성 값은 빈 셀입니다. 나머지 개체에 추가 속성이 있는 경우 해당 속성 값은 파일에 포함되지 않습니다.

예제

예제 1: 날짜를 표시하는 웹 페이지 만들기

PS C:\> ConvertTo-Html -InputObject (Get-Date)

이 명령은 현재 날짜의 속성을 표시하는 HTML 페이지를 만듭니다. InputObject 매개 변수를 사용하여 Get-Date 명령의 결과를 ConvertTo-Html cmdlet에 제출합니다.

예제 2: PowerShell 별칭을 표시하는 웹 페이지 만들기

PS C:\> Get-Alias | ConvertTo-Html | Out-File aliases.htm
PS C:\> Invoke-Item aliases.htm

이 명령은 현재 콘솔에서 Windows PowerShell 별칭을 나열하는 HTML 페이지를 만듭니다.

이 명령은 Get-Alias cmdlet을 사용하여 별칭을 가져옵니다. 파이프라인 연산자(|)를 사용하여 별칭을 html 페이지를 만드는 ConvertTo-Html cmdlet으로 보냅니다. 또한 이 명령은 Out-File cmdlet을 사용하여 HTML 코드를 aliases.htm 파일로 보냅니다.

예제 3: PowerShell 이벤트를 표시하는 웹 페이지 만들기

PS C:\> Get-EventLog -LogName "Windows PowerShell" | ConvertTo-Html | Out-File pslog.htm

이 명령은 로컬 컴퓨터의 Windows PowerShell 이벤트 로그에 이벤트를 표시하는 pslog.htm이라는 HTML 페이지를 만듭니다.

Get-EventLog cmdlet을 사용하여 Windows PowerShell 로그에서 이벤트를 가져옵니다. 그런 다음 파이프라인 연산자(|)를 사용하여 ConvertTo-Html cmdlet에 이벤트를 보냅니다.

또한 이 명령은 Out-File cmdlet을 사용하여 HTML 코드를 pslog.htm 파일로 보냅니다.

예제 4: 프로세스를 표시하는 웹 페이지 만들기

PS C:\> Get-Process | ConvertTo-Html -Property Name, Path, Company -Title "Process Information" | Out-File proc.htm; ii proc.htm

이러한 명령은 로컬 컴퓨터에서 프로세스의 이름, 경로 및 회사를 나열하는 HTML 페이지를 만들고 엽니다.

첫 번째 명령은 Get-Process cmdlet을 사용하여 컴퓨터에서 실행되는 프로세스를 나타내는 개체를 가져옵니다. 이 명령은 파이프라인 연산자(|)를 사용하여 프로세스 개체를 ConvertTo-Html cmdlet으로 보냅니다.

이 명령은 Property 매개 변수를 사용하여 테이블에 포함할 프로세스 개체의 세 가지 속성을 선택합니다. 이 명령은 Title 매개 변수를 사용하여 HTML 페이지의 제목을 지정합니다. 또한 이 명령은 Out-File cmdlet을 사용하여 결과 HTML을 Proc.htm파일에 보냅니다.

두 번째 명령은 Invoke-Item cmdlet(별칭 = ii)을 사용하여 기본 브라우저에서 Proc.htm 엽니다. 두 명령은 세미콜론(;)으로 구분됩니다.

예제 5: 서비스 개체를 표시하는 웹 페이지 만들기

PS> get-service | convertto-html -CssUri "test.css"
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"  "https://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html>
<head>
<title>HTML TABLE</title>
<link rel="stylesheet" type="text/css" href="test.css" />
...

이 명령은 Get-Service cmdlet이 반환하는 서비스 개체의 HTML 페이지를 만듭니다. 이 명령은 CssUri 매개 변수를 사용하여 HTML 페이지에 대한 계단식 스타일시트를 지정합니다.

CssUri 매개 변수는 결과 HTML에 추가 <링크 rel="stylesheet" type="text/css"/ href="test.css"> 태그를 추가합니다. 태그의 HREF 특성에는 스타일시트 이름이 포함됩니다.

예제 6: 서비스 개체를 표시하는 웹 페이지 만들기

PS C:\> Get-Service | ConvertTo-Html -As LIST | Out-File services.htm

이 명령은 Get-Service cmdlet이 반환하는 서비스 개체의 HTML 페이지를 만듭니다. 이 명령은 As 매개 변수를 사용하여 목록 형식을 지정합니다. cmdlet Out-File 결과 HTML을 Services.htm 파일로 보냅니다.

예제 7: 현재 날짜에 대한 웹 테이블 만들기

PS C:\> Get-Date | cth -Fragment
<table>
<colgroup>...</colgroup>
<tr><th>DisplayHint</th><th>DateTime</th><th>Date</th><th>Day</th><th>DayOfWeek</th><th>DayOfYear</th><th>Hour</th>
<th>Kind</th><th>Millisecond</th><th>Minute</th><th>Month</th><th>Second</th><th>Ticks</th><th>TimeOfDay</th><th>Year</th></tr>
<tr><td>DateTime</td><td>Monday, May 05, 2008 10:40:04 AM</td><td>5/5/2008 12:00:00 AM</td><td>5</td><td>Monday</td>
<td>126</td><td>10</td><td>Local</td><td>123</td><td>40</td><td>5</td><td>4</td><td>633455808041237213</td><td>10:40:04.12
37213</td><td>2008</td></tr>
</table>

이 명령은 ConvertTo-Html 사용하여 현재 날짜의 HTML 테이블을 생성합니다. 이 명령은 Get-Date cmdlet을 사용하여 현재 날짜를 가져옵니다. 파이프라인 연산자(|)를 사용하여 결과를 ConvertTo-Html cmdlet(cth별칭)으로 보냅니다.

ConvertTo-Html 명령에는 출력을 HTML 테이블로 제한하는 Fragment 매개 변수가 포함되어 있습니다. 따라서 <HEAD> 및 <BODY> 태그와 같은 HTML 페이지의 다른 요소는 생략됩니다.

예제 8: PowerShell 이벤트를 표시하는 웹 페이지 만들기

PS C:\> Get-EventLog -Log "Windows PowerShell" | ConvertTo-Html -Property id, level, task

이 명령은 Get-EventLog cmdlet을 사용하여 Windows PowerShell 이벤트 로그에서 이벤트를 가져옵니다.

파이프라인 연산자(|)를 사용하여 이벤트를 HTML 형식으로 변환하는 ConvertTo-Html cmdlet으로 이벤트를 보냅니다.

ConvertTo-Html 명령은 속성 매개 변수를 사용하여 이벤트의 ID, 수준 및 작업 속성만 선택합니다.

예제 9: 지정된 서비스를 표시하는 웹 페이지 만들기

PS C:\> Get-Service A* | ConvertTo-Html -Title "Windows Services: Server01" -Body (get-date) -Pre
"<P>Generated by Corporate IT</P>" -Post "For details, contact Corporate IT." | Out-File services.htm; ii services.htm

이 명령은 A로 시작하는 컴퓨터의 서비스를 표시하는 웹 페이지를 만들고 엽니다. Title, 본문, PreContent및 ConvertTo-Html PostContent 매개 변수를 사용하여 출력을 사용자 지정합니다.

명령의 첫 번째 부분에서는 Get-Service cmdlet을 사용하여 A로 시작하는 컴퓨터에서 서비스를 가져옵니다. 이 명령은 파이프라인 연산자(|)를 사용하여 결과를 ConvertTo-Html cmdlet으로 보냅니다. 또한 이 명령은 Out-File cmdlet을 사용하여 출력을 Services.htm 파일로 보냅니다.

세미콜론(;) 첫 번째 명령을 종료하고 Invoke-Item cmdlet(별칭 = "ii")을 사용하여 기본 브라우저에서 Services.htm 파일을 여는 두 번째 명령을 시작합니다.

매개 변수

-As

개체의 서식을 테이블 또는 목록으로 지정할지 여부를 지정합니다. 이 매개 변수에 허용되는 값은 테이블 및 목록입니다. 기본값은 Table입니다.

테이블 값은 Windows PowerShell 테이블 형식과 유사한 HTML 테이블을 생성합니다. 머리글 행에 속성 이름이 표시됩니다. 각 테이블 행은 개체를 나타내며 각 속성에 대한 개체의 값을 표시합니다.

목록 값은 Windows PowerShell 목록 형식과 유사한 각 개체에 대해 2열 HTML 테이블을 생성합니다. 첫 번째 열에는 속성 이름이 표시됩니다. 두 번째 열에 속성 값이 표시됩니다.

형식:	String
허용되는 값:	Table, List
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Body

여는 <BODY> 태그 다음에 추가할 텍스트를 배열로 지정합니다. 기본적으로 해당 위치에는 텍스트가 없습니다.

형식:	String[]
Position:	3
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-CssUri

HTML 파일에 적용되는 CSS(연계 스타일시트)의 URI(Uniform Resource Identifier)를 지정합니다. URI는 출력의 스타일시트 링크에 포함됩니다.

형식:	Uri
별칭:	cu, uri
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Fragment

이 cmdlet은 HTML 테이블만 생성한다는 것을 나타냅니다. HTML, HEAD, TITLE 및 BODY 태그는 생략됩니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Head

<HEAD> 태그의 내용을 배열로 지정합니다. 기본값은 html TABLE</title>><제목입니다. Head 매개 변수를 사용하는 경우 Title 매개 변수는 무시됩니다.

형식:	String[]
Position:	1
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-InputObject

HTML로 나타낼 개체를 지정합니다. 개체를 포함하는 변수를 입력하거나 개체를 가져오는 명령이나 식을 입력합니다.

이 매개 변수를 사용하여 컴퓨터의 모든 서비스와 같은 여러 개체를 제출하는 경우 ConvertTo-Html 컬렉션 또는 개체 배열의 속성을 표시하는 테이블을 만듭니다(System.Object[]). 개별 개체의 테이블을 만들려면 파이프라인 연산자를 사용하여 개체를 convertTo-Html파이프합니다.

형식:	PSObject
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-PostContent

닫는 </TABLE> 태그 다음에 추가할 텍스트를 지정합니다. 기본적으로 해당 위치에는 텍스트가 없습니다.

형식:	String[]
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-PreContent

열기 <TABLE> 태그 앞에 추가할 텍스트 배열을 지정합니다. 기본적으로 해당 위치에는 텍스트가 없습니다.

형식:	String[]
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Property

HTML에서 개체의 속성을 지정합니다. Property 매개 변수의 값은 새 계산 속성일 수 있습니다. 계산된 속성을 만들려면 해시 테이블을 사용합니다. 유효한 키는 다음과 같습니다.

레이블 <문자열>(Select-Object 또는 Format-Table과 달리 이름 키는 지원되지 않음)
식 <문자열> 또는 <스크립트 블록>

형식:	Object[]
Position:	0
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Title

HTML 파일의 제목, 즉 <TITLE> 태그 사이에 표시되는 텍스트를 지정합니다.

형식:	String
Position:	2
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

입력

PSObject

모든 .NET 개체를 ConvertTo-Html파이프할 수 있습니다.

출력

System.String or System.Xml.XmlDocument

이 cmdlet은 유효한 HTML을 구성하는 일련의 문자열을 반환합니다.

참고

이 cmdlet을 사용하려면 하나 이상의 개체를 cmdlet으로 파이프하거나 InputObject 매개 변수를 사용하여 개체를 지정합니다. 입력이 여러 개체로 구성된 경우 이러한 두 메서드의 출력은 매우 다릅니다.
- 여러 개체를 cmdlet으로 파이프하면 Windows PowerShell에서 한 번에 하나씩 cmdlet에 개체를 보냅니다. 결과적으로 convertTo-Html 개별 개체를 표시하는 테이블을 만듭니다. 예를 들어 컴퓨터의 프로세스를 convertTo-Html파이프하면 결과 테이블에 모든 프로세스가 표시됩니다.
- InputObject 매개 변수를 사용하여 여러 개체를 제출하는 경우 ConvertTo-Html 이러한 개체를 컬렉션 또는 배열로 받습니다. 결과적으로 배열의 항목이 아닌 배열과 해당 속성을 표시하는 테이블을 만듭니다. 예를 들어 InputObject 사용하여 ConvertTo-Html컴퓨터의 프로세스를 제출하면 결과 테이블에 개체 배열(System.Object[]) 및 해당 속성이 표시됩니다.
XHTML Strict DTD를 준수하기 위해 DOCTYPE 태그는 그에 따라 수정됩니다.

(<! DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">)

다음을 통해 공유

ConvertTo-Html

구문

Description

예제

예제 1: 날짜를 표시하는 웹 페이지 만들기

예제 2: PowerShell 별칭을 표시하는 웹 페이지 만들기

예제 3: PowerShell 이벤트를 표시하는 웹 페이지 만들기

예제 4: 프로세스를 표시하는 웹 페이지 만들기

예제 5: 서비스 개체를 표시하는 웹 페이지 만들기

예제 6: 서비스 개체를 표시하는 웹 페이지 만들기

예제 7: 현재 날짜에 대한 웹 테이블 만들기

예제 8: PowerShell 이벤트를 표시하는 웹 페이지 만들기

예제 9: 지정된 서비스를 표시하는 웹 페이지 만들기

매개 변수

-As

-Body

-CssUri

-Fragment

-Head

-InputObject

-PostContent

-PreContent

-Property

-Title

입력

출력

참고

추가 리소스

다음을 통해 공유

ConvertTo-Html

구문

Description

예제

예제 1: 날짜를 표시하는 웹 페이지 만들기

예제 2: PowerShell 별칭을 표시하는 웹 페이지 만들기

예제 3: PowerShell 이벤트를 표시하는 웹 페이지 만들기

예제 4: 프로세스를 표시하는 웹 페이지 만들기

예제 5: 서비스 개체를 표시하는 웹 페이지 만들기

예제 6: 서비스 개체를 표시하는 웹 페이지 만들기

예제 7: 현재 날짜에 대한 웹 테이블 만들기

예제 8: PowerShell 이벤트를 표시하는 웹 페이지 만들기

예제 9: 지정된 서비스를 표시하는 웹 페이지 만들기

매개 변수

-As

-Body

-CssUri

-Fragment

-Head

-InputObject

-PostContent

-PreContent

-Property

-Title

입력

출력

참고

관련 링크

추가 리소스