다음을 통해 공유


ConvertTo-Html

.NET 개체를 웹 브라우저에 표시할 수 있는 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

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

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

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

예제

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

ConvertTo-Html -InputObject (Get-Date)

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

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

Get-Alias | ConvertTo-Html | Out-File aliases.htm
Invoke-Item aliases.htm

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

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

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

Get-EventLog -LogName "Windows PowerShell" | ConvertTo-Html | Out-File pslog.htm

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

cmdlet을 Get-EventLog 사용하여 Windows PowerShell 로그에서 이벤트를 가져옵니다. 그런 다음 파이프라인 연산자(|)를 사용하여 cmdlet에 ConvertTo-Html 이벤트를 보냅니다. 또한 이 명령은 cmdlet을 Out-File 사용하여 HTML 코드를 파일로 보냅니다 pslog.htm .

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

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

Get-Process |
  ConvertTo-Html -Property Name, Path, Company -Title "Process Information" |
    Out-File proc.htm
Invoke-Item proc.htm

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

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

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

두 번째 명령은 cmdlet을 Invoke-Item 사용하여 기본 브라우저에서 엽니다 Proc.htm .

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

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" />
...

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

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

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

Get-Service | ConvertTo-Html -As LIST | Out-File services.htm

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

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

Get-Date | ConvertTo-Html -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>

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

이 명령에는 ConvertTo-Html 출력을 HTML 테이블로 제한하는 Fragment 매개 변수가 포함됩니다. 따라서 HTML 페이지의 다른 요소(예: <HEAD> 태그) <BODY> 는 생략됩니다.

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

Get-EventLog -Log "Windows PowerShell" | ConvertTo-Html -Property id, level, task

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

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

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

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

$htmlParams = @{
  Title = "Windows Services: Server01"
  Body = Get-Date
  PreContent = "<P>Generated by Corporate IT</P>"
  PostContent = "For details, contact Corporate IT."
}
Get-Service A* |
  ConvertTo-Html @htmlParams |
    Out-File Services.htm
Invoke-Item Services.htm

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

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

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

매개 변수

-As

개체의 서식을 테이블 또는 목록으로 지정할지 여부를 결정합니다. 유효한 값은 테이블목록입니다. 기본값은 Table입니다.

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

목록 값은 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

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

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

-Head

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

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

-InputObject

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

이 매개 변수를 사용하여 컴퓨터 ConvertTo-Html 의 모든 서비스와 같은 여러 개체를 제출하는 경우 컬렉션 또는 개체 배열의 속성을 표시하는 테이블을 만듭니다. 개별 개체의 테이블을 만들려면 파이프라인 연산자를 사용하여 개체를 파이프합니다 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 매개 변수의 값은 새 계산 속성일 수 있습니다. 계산된 속성은 스크립트 블록 또는 해시 테이블일 수 있습니다. 유효한 키-값 쌍은 다음과 같습니다.

  • Expression - <string> 또는 <script block>
  • FormatString - <string>
  • Width - <int32> - 보다 커야 합니다. 0
  • Alignment - 값은 Left/Center>일 수 있습니다. Right

자세한 내용은 about_Calculated_Properties 참조하세요.

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

-Title

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

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

입력

PSObject

모든 개체를 이 cmdlet으로 파이프할 수 있습니다.

출력

String

이 cmdlet은 변환된 개체를 나타내는 HTML 문자열 배열을 반환합니다.

참고

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

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

  • InputObject 매개 변수를 사용하여 여러 개체를 제출하는 경우 이러한 개체 ConvertTo-Html 를 컬렉션 또는 배열로 받습니다. 따라서 배열의 항목이 아니라 배열과 해당 속성을 표시하는 테이블을 만듭니다. 예를 들어 InputObject를 사용하여 컴퓨터의 프로세스를 제출하는 ConvertTo-Html경우 결과 테이블에 개체 배열과 해당 속성이 표시됩니다.

    XHTML Strict DTD를 준수하기 위해 태그는 DOCTYPE 그에 따라 수정됩니다.

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