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 |
|
기본값 |
Table |
|
파이프라인 입력 적용 여부 |
false |
|
와일드카드 문자 적용 여부 |
false |
-Body <string[]>
여는 <BODY> 태그 뒤에 추가할 텍스트를 지정합니다. 기본적으로 해당 위치에는 텍스트가 없습니다.
|
필수 여부 |
false |
|
위치 |
4 |
|
기본값 |
No text. |
|
파이프라인 입력 적용 여부 |
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 |
|
기본값 |
No text |
|
파이프라인 입력 적용 여부 |
false |
|
와일드카드 문자 적용 여부 |
false |
-PreContent <string[]>
여는 <TABLE> 태그 앞에 추가할 텍스트를 지정합니다. 기본적으로 해당 위치에는 텍스트가 없습니다.
|
필수 여부 |
false |
|
위치 |
named |
|
기본값 |
No text |
|
파이프라인 입력 적용 여부 |
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 파일을 엽니다.
참고 항목