Set-WdsInstallImage

Windows Server 2012 R2 and Windows 8.1

Set-WdsInstallImage

Modifies the properties of an install image.

구문

Parameter Set: AutoStart
Set-WdsInstallImage -ImageName <String> -Multicast [-AsJob] [-CimSession <CimSession[]> ] [-ClientCount <UInt32> ] [-DisplayOrder <UInt32> ] [-FileName <String> ] [-ImageGroup <String> ] [-NewDescription <String> ] [-NewImageName <String> ] [-OverwriteUnattend] [-StartTime <DateTime> ] [-ThrottleLimit <Int32> ] [-TransmissionName <String> ] [-UnattendFile <String> ] [-UserFilter <String> ] [ <CommonParameters>]

Parameter Set: ManualStart
Set-WdsInstallImage -ImageName <String> -ManualStart -Multicast [-AsJob] [-CimSession <CimSession[]> ] [-DisplayOrder <UInt32> ] [-FileName <String> ] [-ImageGroup <String> ] [-NewDescription <String> ] [-NewImageName <String> ] [-OverwriteUnattend] [-ThrottleLimit <Int32> ] [-TransmissionName <String> ] [-UnattendFile <String> ] [-UserFilter <String> ] [ <CommonParameters>]

Parameter Set: SingleImage
Set-WdsInstallImage -ImageName <String> [-AsJob] [-CimSession <CimSession[]> ] [-DisplayOrder <UInt32> ] [-FileName <String> ] [-ImageGroup <String> ] [-NewDescription <String> ] [-NewImageName <String> ] [-OverwriteUnattend] [-ThrottleLimit <Int32> ] [-UnattendFile <String> ] [-UserFilter <String> ] [ <CommonParameters>]

Parameter Set: StartTransmission
Set-WdsInstallImage -ImageName <String> -StartScheduledCast [-AsJob] [-CimSession <CimSession[]> ] [-DisplayOrder <UInt32> ] [-FileName <String> ] [-ImageGroup <String> ] [-NewDescription <String> ] [-NewImageName <String> ] [-OverwriteUnattend] [-ThrottleLimit <Int32> ] [-UnattendFile <String> ] [-UserFilter <String> ] [ <CommonParameters>]

Parameter Set: StopTransmission
Set-WdsInstallImage -ImageName <String> -StopMulticastTransmission [-AsJob] [-CimSession <CimSession[]> ] [-DisplayOrder <UInt32> ] [-FileName <String> ] [-Force] [-ImageGroup <String> ] [-NewDescription <String> ] [-NewImageName <String> ] [-OverwriteUnattend] [-ThrottleLimit <Int32> ] [-UnattendFile <String> ] [-UserFilter <String> ] [ <CommonParameters>]




자세한 설명

The Set-WdsInstallImage cmdlet modifies the properties of an install image in the Windows Deployment Services image store. Use this cmdlet to do any of the following:

-- Change the name of an install image.
-- Change the description of an install image.
-- Set the display order of an install image in the image menu.
-- Specify an answer file for unattended setup of an install image.
-- Set permissions for users or groups to access the image.

When you work with multicast transmissions that use an install image as content, you can:

-- Create and name an AutoCast transmission.
-- Create and name a ScheduledCast transmission which begins when a preset number of clients are ready to start, at a specific time, or both.
-- Create a manually started ScheduledCast transmission.
-- Start a ScheduledCast transmission.
-- Stop a multicast transmission in progress, and then either disconnect clients immediately, or allow them to finish, but not allow any new clients to join.

An AutoCast transmission is a multicast transmission. When a client requests an install image, the multicast transmission begins. Clients that request the same image are joined to the multicast transmission.

A ScheduledCast transmission is a multicast transmission. When a specified number of clients request an image, or a specified time of day is reached, the multicast transmission begins. If you do not specify either of these conditions, you must manually start the transmission.

Specify the install image by using the image name and image group name. If the image name and image group name do not uniquely identify the install image, specify the file name.

매개 변수

-AsJob

별칭

없음

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

-CimSession<CimSession[]>

원격 세션에서 또는 원격 컴퓨터에서 cmdlet을 실행합니다. New-CimSession 또는 Get-CimSession cmdlet의 출력과 같은 컴퓨터 이름이나 세션 개체를 입력합니다. 기본값은 로컬 컴퓨터의 현재 세션입니다.


별칭

Session

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

-ClientCount<UInt32>

Specifies the number of clients that must connect to a transmission. If you also specify the MulticastTransmission parameter, the client count specifies the number of clients that must connect to the ScheduledCast transmission in order for it to begin. Use the StartScheduledCast parameter to begin a transmission before reaching the client count. If you specify the ClientCount parameter and the StartTime parameter, the transmission begins when either a sufficient number of clients have connected or at the time specified by the StartTime parameter.

You may not specify this parameter together with the ManualStart parameter.


별칭

없음

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

-DisplayOrder<UInt32>

Specifies the order in which images appear in the boot menu on Pre-Boot Execution Environment (PXE) clients. The menu lists the boot images in ascending order, smallest number to largest number.


별칭

없음

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

-FileName<String>

Specifies a file name. This is the file name of the install image. Use this parameter to specify the file name for the install image if the install image name does not uniquely identify the image.


별칭

없음

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-Force

Indicates that the cmdlet disconnects any clients currently connected to the multicast transmission. If you do not specify this parameter for an AutoCast transmission, existing clients finish receiving the content, but no new clients join.


별칭

없음

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

-ImageGroup<String>

Specifies the name of an image group. This image group contains the image to modify.. If you do not specify an image group, and only one image group exists on the server, the cmdlet uses that image group by default. If more than one image group exists on the server, you must specify the image group.


별칭

없음

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-ImageName<String>

Specifies the name of an image. This is the name of the image to modify.


별칭

없음

필수 여부

true

위치

named

기본값

없음

파이프라인 입력 적용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-ManualStart

Indicates that the transmission uses a manual start. If you also specify the MulticastTransmission parameter, the cmdlet creates a ScheduledCast transmission that does not begin until a StartScheduledCast command is given.


별칭

없음

필수 여부

true

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

-Multicast

Indicates that the cmdlet enables an AutoCast transmission on the image. If you do not specify a name by using the TransmissionName parameter, the multicast transmission uses the image name


별칭

없음

필수 여부

true

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

-NewDescription<String>

Specifies a new description for the install image to create in the set operation.


별칭

없음

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

-NewImageName<String>

Specifies a new name for the image file to create in the set operation.


별칭

없음

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

-OverwriteUnattend

Indicates that the cmdlet can overwrite an existing answer file. If you specify the UnattendFile parameter, the cmdlet overwrites an existing answer file associated with the image.


별칭

없음

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

-StartScheduledCast

Indicates that the cmdlet enables and begins a ScheduledCast transmission on the image. If there are no clients connected to the transmission, the transmission fails to start.


별칭

없음

필수 여부

true

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

-StartTime<DateTime>

Specifies a day and time, in MM/DD/YYYY.hh:mm:ss format, that denotes the start time. If you specify the MulticastTransmission parameter, this parameter denotes the time the ScheduledCast transmission begins. The StartScheduledCast command can start a transmission before reaching the client count. If you specify both the StartTime parameter and the ClientCount parameter, the transmission begins when either a sufficient number of clients connect, or the time specified in this parameter is reached. Do not specify this parameter together with the ManualStart parameter.


별칭

없음

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

-StopMulticastTransmission

Indicates that Windows Deployment Services stop the multicast transmission of the image. If you specify the Force parameter, the cmdlet disconnects any clients connected to the multicast transmission. If you do not specify the Force parameter, and the transmission is autocast, current clients finish receiving the content, but no additional clients can join the transmission.


별칭

없음

필수 여부

true

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

-ThrottleLimit<Int32>

이 cmdlet을 실행하도록 설정할 수 있는 최대 동시 작업 수를 지정합니다. 이 매개 변수가 생략되거나 값 0이 입력되면 Windows PowerShell®은 컴퓨터에서 실행 중인 CIM cmdlet의 수에 따라 cmdlet에 대한 최적의 제한 한도를 계산합니다. 제한 한도는 현재 cmdlet에만 적용되며 세션이나 컴퓨터에는 적용되지 않습니다.


별칭

없음

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

-TransmissionName<String>

Specifies a name for the multicast transmission.


별칭

없음

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

-UnattendFile<String>

Specifies the full path for the answer file associated with the image.


별칭

없음

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

-UserFilter<String>

Specifies the access controls on the image, in Security Descriptor Definition Language (SDDL) format. To restrict access to the file resources, and access to all images within an image group, set access controls on the image group itself.


별칭

없음

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

<CommonParameters>

이 cmdlet은 일반 매개 변수 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer 및 -OutVariable을 지원합니다. 자세한 내용은 다음을 참조하세요. about_CommonParameters(http://go.microsoft.com/fwlink/p/?LinkID=113216).

입력

입력 유형은 cmdlet에 파이프할 수 있는 개체의 유형입니다.

출력

출력 유형은 cmdlet이 내보내는 개체의 유형입니다.

  • Microsoft.Management.Infrastructure.CimInstance#MSFT_WdsInstallImage

예제

Example 1: Modify an install image

This command modifies an install image for automatic installation.


PS C:\> Set-WdsInstallImage -ImageName "Fabrikam Latest with LOB apps" -ImageGroup "Fabrikam Latest Images" -FileName "install-3.wim" -DisplayOrder 0 -NewImageName "Fabrikam Latest with LOB v2.0 apps" -UnattendFile "D:\images\unattend\FabrikamwLOB.xml" -OverwriteUnattend -UserFilter "O:BAG:DUD:(A;OICI;FA;;;SY)(A;OICI;FA;;;BA)(A;OICI;0x1200a9;;;AU)(A;OICI;FA;;;S-1-5-80-1688844526-3235337491-1375791646-891369040-3692469510)"

Example 2: Modify an install image for multicast transmission

This command modifies an install image for multicast transmission.


PS C:\> Set-WdsInstallImage -ImageName "Fabrikam Latest with LOB apps" -ImageGroup "Fabrikam Latest Images" -FileName "install-3.wim" -Multicast -TransmissionName "Fabrikam Latest AutoCast"

Example 3: Modify start time and client count conditions for an install image

This command modifies an install image by using the ClientCount and StartTime parameters.


PS C:\> Set-WdsInstallImage -ImageName "Fabrikam Latest with LOB apps" -ImageGroup "Fabrikam Latest Images" -FileName "install-3.wim" -Multicast -ClientCount 50 -StartTime 2014/12/01:11:00 -TransmissionName "Fabrikam Latest ScheduledCast with automatic start"

Example 4: Modify an install image for manual start

This command modifies an install image by using the ManualStart parameter.


PS C:\> Set-WdsInstallImage -ImageName "Fabrikam Latest with LOB apps" -ImageGroup "Fabrikam Latest Images" -FileName "install-3.wim" -Multicast -ManualStart -TransmissionName "Fabrikam Latest ScheduledCast with manual start"

Example 5: Modify an install image to start

This command modifies an install image to begin a scheduled transmission.


PS C:\> Set-WdsInstallImage -ImageName "Fabrikam Latest with LOB apps" -ImageGroup "Fabrikam Latest Images" -FileName "install-3.wim" -StartScheduledCast

Example 6: Modify an install image to stop a transmission

This command stops a multicast transmission for an install image.


PS C:\> Set-WdsInstallImage -ImageName "Fabrikam Latest with LOB apps" -ImageGroup "Fabrikam Latest Images" -FileName "install-3.wim" -StopMulticastTransmission

관련 항목

커뮤니티 추가 항목

추가
표시: