다음을 통해 공유


Set-CMBootImage

OS 부팅 이미지를 수정합니다.

구문

Set-CMBootImage
   [-AddOptionalComponent <IResultObject[]>]
   [-BackgroundBitmapPath <String>]
   [-CopyToPackageShareOnDistributionPoint <Boolean>]
   [-CustomPackageShareName <String>]
   [-DeployFromPxeDistributionPoint <Boolean>]
   [-Description <String>]
   [-DisconnectUserFromDistributionPoint <Boolean>]
   [-DisconnectUserFromDistributionPointMins <UInt32>]
   [-DisconnectUserFromDistributionPointRetryCount <UInt32>]
   [-DistributionPointUpdateSchedule <IResultObject>]
   [-EnableBinaryDeltaReplication <Boolean>]
   [-EnableCommandSupport <Boolean>]
   [-EnablePrestartCommand <Boolean>]
   [-Force]
   [-IncludeFilesForPrestart <Boolean>]
   [-InputLocale <String>]
   -InputObject <IResultObject>
   [-NewName <String>]
   [-PassThru]
   [-Path <String>]
   [-PersistContentInCache <Boolean>]
   [-PrestageBehavior <PrestageBehavior>]
   [-PrestartCommandLine <String>]
   [-PrestartIncludeFilesDirectory <String>]
   [-Priority <Priority>]
   [-Reload]
   [-RemoveOptionalComponent <IResultObject[]>]
   [-ScratchSpace <UInt32>]
   [-SendToPreferredDistributionPoint <Boolean>]
   [-Version <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMBootImage
   [-AddOptionalComponent <IResultObject[]>]
   [-BackgroundBitmapPath <String>]
   [-CopyToPackageShareOnDistributionPoint <Boolean>]
   [-CustomPackageShareName <String>]
   [-DeployFromPxeDistributionPoint <Boolean>]
   [-Description <String>]
   [-DisconnectUserFromDistributionPoint <Boolean>]
   [-DisconnectUserFromDistributionPointMins <UInt32>]
   [-DisconnectUserFromDistributionPointRetryCount <UInt32>]
   [-DistributionPointUpdateSchedule <IResultObject>]
   [-EnableBinaryDeltaReplication <Boolean>]
   [-EnableCommandSupport <Boolean>]
   [-EnablePrestartCommand <Boolean>]
   [-Force]
   -Id <String>
   [-IncludeFilesForPrestart <Boolean>]
   [-InputLocale <String>]
   [-NewName <String>]
   [-PassThru]
   [-Path <String>]
   [-PersistContentInCache <Boolean>]
   [-PrestageBehavior <PrestageBehavior>]
   [-PrestartCommandLine <String>]
   [-PrestartIncludeFilesDirectory <String>]
   [-Priority <Priority>]
   [-Reload]
   [-RemoveOptionalComponent <IResultObject[]>]
   [-ScratchSpace <UInt32>]
   [-SendToPreferredDistributionPoint <Boolean>]
   [-Version <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMBootImage
   [-AddOptionalComponent <IResultObject[]>]
   [-BackgroundBitmapPath <String>]
   [-CopyToPackageShareOnDistributionPoint <Boolean>]
   [-CustomPackageShareName <String>]
   [-DeployFromPxeDistributionPoint <Boolean>]
   [-Description <String>]
   [-DisconnectUserFromDistributionPoint <Boolean>]
   [-DisconnectUserFromDistributionPointMins <UInt32>]
   [-DisconnectUserFromDistributionPointRetryCount <UInt32>]
   [-DistributionPointUpdateSchedule <IResultObject>]
   [-EnableBinaryDeltaReplication <Boolean>]
   [-EnableCommandSupport <Boolean>]
   [-EnablePrestartCommand <Boolean>]
   [-Force]
   [-IncludeFilesForPrestart <Boolean>]
   [-InputLocale <String>]
   -Name <String>
   [-NewName <String>]
   [-PassThru]
   [-Path <String>]
   [-PersistContentInCache <Boolean>]
   [-PrestageBehavior <PrestageBehavior>]
   [-PrestartCommandLine <String>]
   [-PrestartIncludeFilesDirectory <String>]
   [-Priority <Priority>]
   [-Reload]
   [-RemoveOptionalComponent <IResultObject[]>]
   [-ScratchSpace <UInt32>]
   [-SendToPreferredDistributionPoint <Boolean>]
   [-Version <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

이 cmdlet을 사용하여 OS 부팅 이미지를 수정합니다. 부팅 이미지는 OS를 설치하기 전에 클라이언트 컴퓨터를 부팅하는 Windows PE(Windows 사전 설치 환경) 이미지입니다.

부팅 이미지에 디바이스 드라이버를 추가하거나 해당 속성을 변경할 수 있습니다. 새 디바이스 드라이버를 추가하려면 먼저 드라이버를 Configuration Manager 드라이버 카탈로그로 가져와서 사용하도록 설정해야 합니다.

각 버전의 Configuration Manager는 특정 버전의 Windows ADK(Windows 평가 및 배포 키트)를 지원합니다. 지원되는 버전의 Windows ADK에서 Windows PE 버전을 기반으로 하는 경우 부팅 이미지를 서비스하거나 사용자 지정할 수 있습니다.

자세한 내용은 Configuration Manager를 사용하여 부팅 이미지 관리를 참조하세요.

참고

Configuration Manager 사이트 드라이브에서 Configuration Manager cmdlet을 실행합니다(예: PS XYZ:\>). 자세한 내용은 시작을 참조하세요.

예제

예제 1: 부팅 이미지 이름 바꾸기

이 명령은 패키지 ID로 부팅 이미지를 가져오고 이름을 바꿉니다.

Set-CMBootimage -Id "CM100004" -NewName "Custom boot image"

예제 2: 설명 속성 설정

이 명령은 이름으로 부팅 이미지를 가져오고 버전과 설명을 추가합니다.

Set-CMBootImage -Name "Custom boot image (x64)" -Version "Contoso v2.1" -Description "Managed by jqpublic"

예제 3: 키보드 레이아웃 설정

다음 예제에서는 부팅 이미지의 기본 키보드 레이아웃을 러시아어(러시아) 언어로 설정합니다. ID로 부팅 이미지를 식별합니다.

Set-CMBootimage -Id "CM100004" -InputLocale "ru-ru"

예제 4: 선택적 구성 요소 추가

이 예제에서는 .NET 및 PowerShell 선택적 구성 요소를 가져오고 부팅 이미지에 추가합니다.

$netfxOC = Get-CMWinPEOptionalComponentInfo -Architecture 'x64' -Name 'WinPE-NetFX' -LanguageId 1033
$pwshOC = Get-CMWinPEOptionalComponentInfo -Architecture 'x64' -Name 'WinPE-PowerShell' -LanguageId 1033
$OCs = @($netfxOC, $pwshOC)

Set-CMBootImage -Id 'XYZ00556' -AddOptionalComponent $OCs

매개 변수

-AddOptionalComponent

부팅 이미지에 추가할 선택적 구성 요소 개체의 배열을 지정합니다. 이 개체를 얻으려면 Get-CMWinPEOptionalComponentInfo cmdlet을 사용합니다.

일반적으로 사용되는 구성 요소는 다음과 같습니다.

  • Microsoft .NET(WinPE-NetFX): 이 구성 요소는 PowerShell의 필수 구성 요소입니다. 더 큰 선택적 구성 요소 중 하나입니다.
  • Windows PowerShell(WinPE-PowerShell): 이 구성 요소에는 .NET이 필요하고 제한된 PowerShell 지원이 추가됩니다. 작업 순서의 WinPE 단계에서 사용자 지정 PowerShell 스크립트를 실행하는 경우 이 구성 요소를 추가합니다. 다른 PowerShell cmdlet에 필요할 수 있는 다른 구성 요소가 있습니다.
  • HTML(WinPE-HTA): 작업 순서의 WinPE 단계에서 사용자 지정 HTML 애플리케이션을 실행하는 경우 이 구성 요소를 추가합니다.

자세한 내용은 부팅 이미지 관리 - 선택적 구성 요소를 참조하세요.

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

-BackgroundBitmapPath

Windows PE에서 사용할 사용자 지정 배경 이미지 파일의 네트워크 파일 경로를 지정합니다.

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

-Confirm

cmdlet을 실행하기 전에 확인 메시지를 표시합니다.

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

-CopyToPackageShareOnDistributionPoint

클라이언트는 항상 배포 지점에서 부팅 이미지를 다운로드할 수 있습니다. 이 매개 변수를 $true 설정하면 사이트에서 배포 지점에서 명명된 네트워크 공유를 통해 사용할 수 있습니다. CustomPackageShareName을 사용하여 사용자 지정 공유 이름을 지정합니다.

이 옵션을 사용하도록 설정하면 배포 지점에 더 많은 공간이 필요합니다. 이 부팅 이미지를 배포하는 모든 배포 지점에 적용됩니다.

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

-CustomPackageShareName

CopyToPackageShareOnDistributionPoint를 사용하도록 설정하는 경우 이 매개 변수를 사용하여 공유 이름을 사용자 지정할 수 있습니다. 최대 길이는 127자이며 다음 문자를 " / [ ] : | < > + = ; , ? *포함할 수 없습니다. 공유 이름과 폴더 이름을 지정할 수 있지만 각각에 대한 최대값은 80자입니다. 예를 들면 ShareName\FolderName와 같습니다.

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

-DeployFromPxeDistributionPoint

이 매개 변수를 $true 설정하여 PXE 지원 배포 지점에서 이 부팅 이미지를 사용할 수 있도록 합니다. 자세한 내용은 PXE를 사용하여 네트워크를 통해 Windows 배포를 참조하세요.

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

-Description

부팅 이미지를 식별하는 데 도움이 되는 선택적 설명을 지정합니다.

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

-DisableWildcardHandling

이 매개 변수는 와일드카드 문자를 리터럴 문자 값으로 처리합니다. ForceWildcardHandling과 결합할 수 없습니다.

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

-DisconnectUserFromDistributionPoint

이 옵션은 더 이상 사용되지 않습니다. 부팅 이미지의 ForcedDisconnectEnabled 속성을 설정합니다.

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

-DisconnectUserFromDistributionPointMins

이 옵션은 더 이상 사용되지 않습니다. 부팅 이미지의 ForcedDisconnectDelay 속성을 설정합니다.

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

-DisconnectUserFromDistributionPointRetryCount

이 옵션은 더 이상 사용되지 않습니다. 부팅 이미지의 ForcedDisconnectNumRetries 속성을 설정합니다.

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

-DistributionPointUpdateSchedule

이 매개 변수를 사용하여 일정에 따라 배포 지점을 업데이트합니다. 일정 개체를 얻으려면 New-CMSchedule cmdlet을 사용합니다.

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

-EnableBinaryDeltaReplication

이 매개 변수를 $true 설정하여 BDR(이진 차등 복제)을 사용하도록 설정합니다. 자세한 내용은 Configuration Manager의 콘텐츠 관리에 대한 기본 개념을 참조하세요.

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

-EnableCommandSupport

비프로덕션 테스트 환경에서만 이 매개 변수를 $true 설정하여 명령 지원을 사용하도록 설정할 수 있습니다. 디바이스가 이 이미지로 부팅되면 F8 키를 눌러 관리 명령 프롬프트를 열 수 있습니다. 이 옵션은 배포를 테스트하는 동안 문제 해결에 유용합니다. 프로덕션 배포에서 이 설정을 사용하는 것은 보안 문제로 인해 권장되지 않습니다.

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

-EnablePrestartCommand

이 매개 변수를 $true 설정하여 시작 전 명령을 사용하도록 설정합니다. 이 명령줄은 작업 순서가 시작되기 전에 실행됩니다.

IncludeFilesForPrestart, PrestartCommandLine, PrestartIncludeFilesDirectory 매개 변수도 구성합니다.

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

-Force

확인을 요청하지 않고 명령을 실행합니다.

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

-ForceWildcardHandling

이 매개 변수는 와일드카드 문자를 처리하고 예기치 않은 동작(권장되지 않음)으로 이어질 수 있습니다. DisableWildcardHandling과 결합할 수 없습니다.

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

-Id

구성할 부팅 이미지 ID를 지정합니다. 이 값은 표준 패키지 ID(예: ) XYZ00002입니다.

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

-IncludeFilesForPrestart

EnablePrestartCommand를 사용하도록 설정하는 경우 시작 전 명령에 다른 파일을 실행해야 하는 경우 이 매개 변수를 사용합니다. 그런 다음 PrestartIncludeFilesDirectory 매개 변수를 사용하여 포함할 파일의 위치를 지정합니다.

예를 들어 일괄 처리 스크립트를 실행하려면 이 옵션을 사용하여 스크립트 파일을 포함합니다.

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

-InputLocale

이 매개 변수를 사용하여 부팅 이미지에 대한 기본 키보드 레이아웃을 구성합니다. 언어 태그를 지정합니다. 예를 들어 입력 로캘을 러시아어(러시아)로 설정하려면 문자열 ru-ru을 지정합니다. 자세한 내용은 [MS-LCID]: LCID(Windows 언어 코드 식별자) 참조를 참조하세요.

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

-InputObject

구성할 부팅 이미지 개체를 지정합니다. 이 개체를 얻으려면 Get-CMBootImage cmdlet을 사용합니다.

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

-Name

구성할 부팅 이미지의 이름을 지정합니다.

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

-NewName

부팅 이미지의 새 이름을 지정합니다.

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

-PassThru

작업 중인 항목을 나타내는 개체를 반환하려면 이 매개 변수를 추가합니다. 기본적으로 이 cmdlet은 출력을 생성하지 않을 수 있습니다.

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

-Path

이 부팅 이미지에서 사용하는 Windows PE 이미지의 네트워크 경로를 지정합니다. 기본 부팅 이미지의 경로는 변경할 수 없습니다.

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

-PersistContentInCache

이 패키지의 콘텐츠가 클라이언트 캐시에서 사용 중단되어 다른 콘텐츠의 공간을 확보하지 않으려면 이 매개 변수를 $true 설정하여 클라이언트 캐시에 유지합니다.

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

-PrestageBehavior

사전 준비된 콘텐츠에 배포 지점을 사용하도록 설정할 때 동작을 지정합니다.

  • ManualCopy: 이 패키지의 콘텐츠를 배포 지점에 수동으로 복사
  • DownloadDelta: 배포 지점에 콘텐츠 변경 내용만 다운로드
  • OnDemand: 패키지가 배포 지점에 할당되면 자동으로 콘텐츠 다운로드

자세한 내용은 사전 준비된 콘텐츠 사용을 참조하세요.

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

-PrestartCommandLine

EnablePrestartCommand를 사용하도록 설정하는 경우 이 매개 변수를 사용하여 실행할 명령줄을 지정합니다. 최대 길이는 4096자입니다.

명령줄에 Windows PE에 없는 파일이 필요한 경우 IncludeFilesForPrestartPrestartIncludeFilesDirectory 매개 변수를 사용합니다.

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

-PrestartIncludeFilesDirectory

EnablePrestartCommandIncludeFilesForPrestart를 사용하도록 설정하는 경우 이 매개 변수를 사용하여 부팅 이미지에 포함할 파일의 네트워크 경로를 지정합니다.

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

-Priority

사이트에서 콘텐츠를 다른 사이트와 이 사이트의 배포 지점으로 보내는 순서를 지정합니다.

사이트는 우선 순위가 중간 또는 낮은 패키지 전에 우선 순위가 높은 콘텐츠를 보냅니다. 우선 순위가 같은 패키지는 생성된 순서대로 전송됩니다.

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

-Reload

버전 2006 이상에 적용됩니다. 부팅 이미지의 Windows ADK 구성 요소 버전이 최신 버전이 아니면 이 매개 변수를 추가하여 Windows ADK의 현재 Windows PE 버전으로 부팅 이미지를 다시 로드합니다. 자세한 내용은 부팅 이미지를 사용하여 배포 지점 업데이트를 참조하세요.

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

-RemoveOptionalComponent

부팅 이미지에서 제거할 선택적 구성 요소 개체의 배열을 지정합니다. 이 개체를 얻으려면 Get-CMWinPEOptionalComponentInfo cmdlet을 사용합니다.

Configuration Manager에 필요한 다음 구성 요소를 제거하지 마세요.

  • 스크립팅(WinPE-Scripting)
  • 시작(WinPE-SecureStartup)
  • 네트워크(WinPE-WDS-Tools)
  • 스크립팅(WinPE-WMI)
형식:IResultObject[]
별칭:RemoveOptionalComponents
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ScratchSpace

WinPE에서 사용하는 임시 스토리지(RAM 드라이브)인 Windows PE 스크래치 공간을 구성합니다. 예를 들어 애플리케이션이 WinPE 내에서 실행되고 임시 파일을 작성해야 하는 경우 WinPE는 파일을 메모리의 스크래치 공간으로 리디렉션하여 하드 디스크의 존재를 시뮬레이션합니다. 기본적으로 이 크기는 RAM이 1GB를 초과하는 디바이스의 경우 512MB이고, 그렇지 않으면 기본값은 32MB입니다.

형식:UInt32
허용되는 값:32, 64, 128, 256, 512
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-SendToPreferredDistributionPoint

기본 배포 지점에 주문형 콘텐츠 배포를 사용하도록 설정하려면 이 매개 변수를 $true 설정합니다. 이 설정을 사용하도록 설정하면 클라이언트가 패키지에 대한 콘텐츠를 요청하고 배포 지점에서 콘텐츠를 사용할 수 없는 경우 관리 지점에서 콘텐츠를 배포합니다. 자세한 내용은 주문형 콘텐츠 배포를 참조하세요.

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

-Version

부팅 이미지의 버전을 지정합니다. 이 값은 OS 버전이 아니라 관리하는 문자열입니다.

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

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여줍니다. cmdlet이 실행되지 않습니다.

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

입력

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

출력

System.Object