Set-CMBootImage
OS 부팅 이미지를 수정합니다.
Syntax
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 애플리케이션을 실행하는 경우 이 구성 요소를 추가합니다.
자세한 내용은 부팅 이미지 관리 - 선택적 구성 요소를 참조하세요.
| Type: | IResultObject[] |
| Aliases: | AddOptionalComponents |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BackgroundBitmapPath
Windows PE에서 사용할 사용자 지정 배경 이미지 파일의 네트워크 파일 경로를 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
cmdlet을 실행하기 전에 확인 메시지를 표시합니다.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CopyToPackageShareOnDistributionPoint
클라이언트는 항상 배포 지점에서 부팅 이미지를 다운로드할 수 있습니다. 이 매개 변수를 $true 설정하면 사이트에서 배포 지점에서 명명된 네트워크 공유를 통해 사용할 수 있습니다. CustomPackageShareName을 사용하여 사용자 지정 공유 이름을 지정합니다.
이 옵션을 사용하도록 설정하면 배포 지점에 더 많은 공간이 필요합니다. 이 부팅 이미지를 배포하는 모든 배포 지점에 적용됩니다.
| Type: | Boolean |
| Aliases: | CopyToPackageShareOnDistributionPoints |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CustomPackageShareName
CopyToPackageShareOnDistributionPoint를 사용하도록 설정하는 경우 이 매개 변수를 사용하여 공유 이름을 사용자 지정할 수 있습니다. 최대 길이는 127자이며 다음 문자를 " / [ ] : | < > + = ; , ? *포함할 수 없습니다. 공유 이름과 폴더 이름을 지정할 수 있지만 각각에 대한 최대값은 80자입니다. 예를 들면 ShareName\FolderName와 같습니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DeployFromPxeDistributionPoint
이 매개 변수를 $true 설정하여 PXE 지원 배포 지점에서 이 부팅 이미지를 사용할 수 있도록 합니다. 자세한 내용은 PXE를 사용하여 네트워크를 통해 Windows 배포를 참조하세요.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
부팅 이미지를 식별하는 데 도움이 되는 선택적 설명을 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableWildcardHandling
이 매개 변수는 와일드카드 문자를 리터럴 문자 값으로 처리합니다. ForceWildcardHandling과 결합할 수 없습니다.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisconnectUserFromDistributionPoint
이 옵션은 더 이상 사용되지 않습니다. 부팅 이미지의 ForcedDisconnectEnabled 속성을 설정합니다.
| Type: | Boolean |
| Aliases: | DisconnectUsersFromDistributionPoints |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisconnectUserFromDistributionPointMins
이 옵션은 더 이상 사용되지 않습니다. 부팅 이미지의 ForcedDisconnectDelay 속성을 설정합니다.
| Type: | UInt32 |
| Aliases: | DisconnectUsersFromDistributionPointsMinutes |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisconnectUserFromDistributionPointRetryCount
이 옵션은 더 이상 사용되지 않습니다. 부팅 이미지의 ForcedDisconnectNumRetries 속성을 설정합니다.
| Type: | UInt32 |
| Aliases: | DisconnectUsersFromDistributionPointsRetries |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DistributionPointUpdateSchedule
이 매개 변수를 사용하여 일정에 따라 배포 지점을 업데이트합니다. 일정 개체를 얻으려면 New-CMSchedule cmdlet을 사용합니다.
| Type: | IResultObject |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableBinaryDeltaReplication
이 매개 변수를 $true 설정하여 BDR(이진 차등 복제)을 사용하도록 설정합니다. 자세한 내용은 Configuration Manager 콘텐츠 관리의 기본 개념을 참조하세요.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableCommandSupport
비프로덕션 테스트 환경에서만 이 매개 변수를 $true 설정하여 명령 지원을 사용하도록 설정할 수 있습니다. 디바이스가 이 이미지로 부팅되면 F8 키를 눌러 관리 명령 프롬프트를 열 수 있습니다. 이 옵션은 배포를 테스트하는 동안 문제 해결에 유용합니다. 프로덕션 배포에서 이 설정을 사용하는 것은 보안 문제로 인해 권장되지 않습니다.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnablePrestartCommand
이 매개 변수를 $true 설정하여 시작 전 명령을 사용하도록 설정합니다. 이 명령줄은 작업 순서가 시작되기 전에 실행됩니다.
IncludeFilesForPrestart, PrestartCommandLine, PrestartIncludeFilesDirectory 매개 변수도 구성합니다.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Force
확인을 요청하지 않고 명령을 실행합니다.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ForceWildcardHandling
이 매개 변수는 와일드카드 문자를 처리하고 예기치 않은 동작(권장되지 않음)으로 이어질 수 있습니다. DisableWildcardHandling과 결합할 수 없습니다.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Id
구성할 부팅 이미지 ID를 지정합니다. 이 값은 표준 패키지 ID(예: ) XYZ00002입니다.
| Type: | String |
| Aliases: | PackageId |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IncludeFilesForPrestart
EnablePrestartCommand를 사용하도록 설정하는 경우 시작 전 명령에 다른 파일을 실행해야 하는 경우 이 매개 변수를 사용합니다. 그런 다음 PrestartIncludeFilesDirectory 매개 변수를 사용하여 포함할 파일의 위치를 지정합니다.
예를 들어 일괄 처리 스크립트를 실행하려면 이 옵션을 사용하여 스크립트 파일을 포함합니다.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputLocale
이 매개 변수를 사용하여 부팅 이미지에 대한 기본 키보드 레이아웃을 구성합니다. 언어 태그를 지정합니다. 예를 들어 입력 로캘을 러시아어(러시아)로 설정하려면 문자열 ru-ru을 지정합니다. 자세한 내용은 [MS-LCID]: LCID(Windows 언어 코드 식별자) 참조를 참조하세요.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
구성할 부팅 이미지 개체를 지정합니다. 이 개체를 얻으려면 Get-CMBootImage cmdlet을 사용합니다.
| Type: | IResultObject |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
구성할 부팅 이미지의 이름을 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NewName
부팅 이미지의 새 이름을 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PassThru
작업 중인 항목을 나타내는 개체를 반환하려면 이 매개 변수를 추가합니다. 기본적으로 이 cmdlet은 출력을 생성하지 않을 수 있습니다.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Path
이 부팅 이미지에서 사용하는 Windows PE 이미지의 네트워크 경로를 지정합니다. 기본 부팅 이미지의 경로는 변경할 수 없습니다.
| Type: | String |
| Aliases: | ImagePath |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PersistContentInCache
이 패키지의 콘텐츠가 다른 콘텐츠의 공간을 확보하기 위해 클라이언트 캐시에서 사용이 중단되지 않도록 하려면 이 매개 변수를 $true 설정하여 클라이언트 캐시에 유지합니다.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PrestageBehavior
사전 준비된 콘텐츠에 배포 지점을 사용하도록 설정할 때 동작을 지정합니다.
ManualCopy: 이 패키지의 콘텐츠를 배포 지점에 수동으로 복사DownloadDelta: 배포 지점에 콘텐츠 변경 내용만 다운로드OnDemand: 패키지가 배포 지점에 할당되면 자동으로 콘텐츠 다운로드
자세한 내용은 사전 준비된 콘텐츠 사용을 참조하세요.
| Type: | PrestageBehavior |
| Accepted values: | ManualCopy, DownloadDelta, OnDemand |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PrestartCommandLine
EnablePrestartCommand를 사용하도록 설정하는 경우 이 매개 변수를 사용하여 실행할 명령줄을 지정합니다. 최대 길이는 4096자입니다.
명령줄에 Windows PE에 없는 파일이 필요한 경우 IncludeFilesForPrestart 및 PrestartIncludeFilesDirectory 매개 변수를 사용합니다.
| Type: | String |
| Aliases: | CommandLine |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PrestartIncludeFilesDirectory
EnablePrestartCommand 및 IncludeFilesForPrestart를 사용하도록 설정하는 경우 이 매개 변수를 사용하여 부팅 이미지에 포함할 파일의 네트워크 경로를 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Priority
사이트에서 콘텐츠를 다른 사이트와 이 사이트의 배포 지점으로 보내는 순서를 지정합니다.
사이트는 우선 순위가 중간 또는 낮은 패키지 전에 우선 순위가 높은 콘텐츠를 보냅니다. 우선 순위가 같은 패키지는 생성된 순서대로 전송됩니다.
| Type: | Priority |
| Accepted values: | High, Medium, Low |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Reload
버전 2006 이상에 적용됩니다. 부팅 이미지의 Windows ADK 구성 요소 버전이 최신 버전이 아니면 이 매개 변수를 추가하여 Windows ADK의 현재 Windows PE 버전으로 부팅 이미지를 다시 로드합니다. 자세한 내용은 부팅 이미지를 사용하여 배포 지점 업데이트를 참조하세요.
| Type: | SwitchParameter |
| Aliases: | ReloadImage |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveOptionalComponent
부팅 이미지에서 제거할 선택적 구성 요소 개체의 배열을 지정합니다. 이 개체를 얻으려면 Get-CMWinPEOptionalComponentInfo cmdlet을 사용합니다.
Configuration Manager 필요한 다음 구성 요소를 제거하지 마세요.
- 스크립팅(WinPE-Scripting)
- 시작(WinPE-SecureStartup)
- 네트워크(WinPE-WDS-Tools)
- 스크립팅(WinPE-WMI)
| Type: | IResultObject[] |
| Aliases: | RemoveOptionalComponents |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ScratchSpace
WinPE에서 사용하는 임시 스토리지(RAM 드라이브)인 Windows PE 스크래치 공간을 구성합니다. 예를 들어 애플리케이션이 WinPE 내에서 실행되고 임시 파일을 작성해야 하는 경우 WinPE는 파일을 메모리의 스크래치 공간으로 리디렉션하여 하드 디스크의 존재를 시뮬레이션합니다. 기본적으로 이 크기는 RAM이 1GB를 초과하는 디바이스의 경우 512MB이고, 그렇지 않으면 기본값은 32MB입니다.
| Type: | UInt32 |
| Accepted values: | 32, 64, 128, 256, 512 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SendToPreferredDistributionPoint
기본 배포 지점에 주문형 콘텐츠 배포를 사용하도록 설정하려면 이 매개 변수를 $true 설정합니다. 이 설정을 사용하도록 설정하면 클라이언트가 패키지에 대한 콘텐츠를 요청하고 배포 지점에서 콘텐츠를 사용할 수 없는 경우 관리 지점에서 콘텐츠를 배포합니다. 자세한 내용은 주문형 콘텐츠 배포를 참조하세요.
| Type: | Boolean |
| Aliases: | SendToPreferredDistributionPoints |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Version
부팅 이미지의 버전을 지정합니다. 이 값은 OS 버전이 아니라 관리하는 문자열입니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
cmdlet이 실행되면 어떻게 되는지 보여줍니다. cmdlet이 실행되지 않습니다.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
입력
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
출력
System.Object
관련 링크
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기