ConvertTo-Html

아티클
01/12/2010

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

구문

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

ConvertTo-Html [-Fragment] [[-Property] <Object[]>] [-As <string>] [-InputObject <psobject>] [-PostContent <string[]>] [-PreContent <string[]>] [<CommonParameters>]

설명

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

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

여러 개체를 ConvertTo-Html로 전송하면 Windows PowerShell은 전송한 첫 번째 개체의 속성을 기준으로 테이블(또는 목록)을 만듭니다. 나머지 개체에 지정된 속성이 하나도 없으면 해당 개체의 속성 값은 빈 셀이 됩니다. 나머지 개체에 추가 속성이 있으면 이러한 속성 값은 파일에 포함되지 않습니다.

매개 변수

-As <string>

개체가 테이블 또는 목록 중 어떤 형식으로 지정되는지 결정합니다. 사용할 수 있는 값은 TABLE 및 LIST입니다. 기본값은 TABLE입니다.

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

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

필수 여부	false
위치	named
기본값	테이블
파이프라인 입력 적용 여부	false
와일드카드 문자 적용 여부	false

-Body <string[]>

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

필수 여부	false
위치	4
기본값	텍스트 없음
파이프라인 입력 적용 여부	false
와일드카드 문자 적용 여부	false

-CssUri <Uri>

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

필수 여부	false
위치	named
기본값
파이프라인 입력 적용 여부	false
와일드카드 문자 적용 여부	false

-Fragment

HTML 테이블만 생성합니다. HTML, HEAD, TITLE 및 BODY 태그는 생략됩니다.

필수 여부	false
위치	named
기본값
파이프라인 입력 적용 여부	false
와일드카드 문자 적용 여부	false

-Head <string[]>

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

필수 여부	false
위치	2
기본값	<title>HTML TABLE</title>
파이프라인 입력 적용 여부	false
와일드카드 문자 적용 여부	false

-InputObject <psobject>

HTML로 표시할 개체를 지정합니다. 개체가 포함된 변수를 입력하거나 개체를 가져오는 명령 또는 식을 입력하십시오.

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

필수 여부	false
위치	named
기본값
파이프라인 입력 적용 여부	true (ByValue)
와일드카드 문자 적용 여부	false

-PostContent <string[]>

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

필수 여부	false
위치	named
기본값	텍스트 없음
파이프라인 입력 적용 여부	false
와일드카드 문자 적용 여부	false

-PreContent <string[]>

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

필수 여부	false
위치	named
기본값	텍스트 없음
파이프라인 입력 적용 여부	false
와일드카드 문자 적용 여부	false

-Property <Object[]>

지정된 개체 속성을 HTML에 포함합니다.

필수 여부	false
위치	1
기본값
파이프라인 입력 적용 여부	false
와일드카드 문자 적용 여부	false

-Title <string>

<TITLE> 태그 사이에 나타나는 텍스트인 HTML 파일의 제목을 지정합니다.

필수 여부	false
위치	3
기본값
파이프라인 입력 적용 여부	false
와일드카드 문자 적용 여부	false

<CommonParameters>

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

입력 및 출력

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

입력

System.Management.Automation.PSObject

임의의 .NET 개체를 ConvertTo-Html로 파이프할 수 있습니다.

출력

System.String

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

참고

이 cmdlet을 사용하려면 하나 이상의 개체를 cmdlet으로 파이프하거나 InputObject 매개 변수를 사용하여 개체를 지정합니다. 입력이 여러 개체로 구성된 경우 이 두 메서드의 출력은 매우 다릅니다.

-- 여러 개체를 cmdlet으로 파이프하면 Windows PowerShell은 해당 개체를 한 번에 하나씩 cmdlet으로 보냅니다. 따라서 ConvertTo-Html은 개별 개체를 표시하는 테이블을 만듭니다. 예를 들어 컴퓨터의 프로세스를 ConvertTo-Html로 파이프하면 결과 테이블이 모든 프로세스를 표시합니다.

-- InputObject 매개 변수를 사용하여 여러 개체를 전송하는 경우 ConvertTo-Html은 이들 개체를 컬렉션이나 배열로 받습니다. 따라서 이 cmdlet은 배열의 항목이 아니라 배열과 해당 속성을 표시하는 테이블을 만듭니다. 예를 들어 InputObject를 사용하여 컴퓨터의 프로세스를 ConvertTo-Html로 전송하면 결과 테이블은 개체 배열(System.Object[])과 해당 속성을 표시합니다.

XHTML Strict DTD를 준수하기 위해 DOCTYPE 태그가 적절하게 수정됩니다.

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

예 1

C:\PS>convertto-html -inputobject (get-date)

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

예 2

C:\PS>get-alias | convertto-html > aliases.htm

C:\PS> invoke-item aliases.htm

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

이 명령은 Get-Alias cmdlet을 사용하여 별칭을 가져옵니다. 파이프라인 연산자(|)를 사용하여 별칭을 ConvertTo-Html cmdlet으로 보내면 이 cmdlet은 해당 HTML 페이지를 만듭니다.

예 3

C:\PS>get-eventlog -logname "Windows PowerShell | convertto-html > pslog.htm

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

이 명령은 Get-EventLog cmdlet을 사용하여 Windows PowerShell 로그의 이벤트를 가져온 다음 파이프라인 연산자(|)를 사용하여 ConvertTo-Html cmdlet으로 보냅니다. 

이 명령은 또한 리디렉션 연산자(>)를 사용하여 HTML 코드를 pslog.htm 파일로 보냅니다.

예 4

C:\PS>get-process | convertto-html -property Name, Path, Company -title "Process Information" > proc.htm; ii proc.htm

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

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

이 명령은 Property 매개 변수를 사용하여 테이블에 포함할 프로세스 개체의 세 가지 속성을 선택하고 Title 매개 변수를 사용하여 HTML 페이지의 제목을 지정합니다. 이 명령은 또한 리디렉션 연산자(>)를 사용하여 결과 HTML을 Proc.htm이라는 파일로 보냅니다. 

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

예 5

C:\PS>get-service | convertto-html -CssUri "test.css"

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"       "http://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 페이지의 CSS 스타일시트를 지정합니다. 

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

예 6

C:\PS>get-service | convertto-html -as LIST > services.htm

설명
-----------
이 명령은 Get-Service cmdlet이 반환하는 서비스 개체의 HTML 페이지를 만듭니다. 이 명령은 As 매개 변수를 사용하여 목록 형식을 지정합니다. 리디렉션 연산자(>)는 결과 HTML을 Services.htm 파일로 보냅니다.

예 7

C:\PS>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 명령은 Fragment 매개 변수를 포함하는데 이 매개 변수는 출력을 HTML 테이블로 제한합니다. 따라서 <HEAD> 및 <BODY> 태그와 같은 HTML 페이지의 다른 요소는 생략됩니다.

예 8

C:\PS>get-eventlog -log "Windows PowerShell" | convertto-html -property id, level, task

설명
-----------
이 명령은 Get-EventLog cmdlet을 사용하여 "Windows PowerShell" 이벤트 로그에서 이벤트를 가져온 다음 

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

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

예 9

C:\PS>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." > services.htm; ii services.htm

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

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

세미콜론(;)으로 첫 번째 명령이 끝나고 두 번째 명령이 시작되면 Invoke-Item cmdlet(별칭 = "ii")을 사용하여 기본 브라우저에서 Services.htm 파일을 엽니다.

참고 항목

개념

ConvertTo-CSV
ConvertTo-XML

다음을 통해 공유