Share via


/remove-MulticastTransmission

Updated: April 17, 2012

Applies To: Windows Server 2008, Windows Server 2008 R2

Disables multicast transmitting for an image. Unless you specify /Force, existing clients will complete the image transfer but new clients will not be allowed to join.

Syntax

Windows Server 2008

WDSUTIL /Remove-MulticastTransmission /Image:<Image name> [/Server:<Server name>] /ImageType:Install [/ImageGroup:<Image Group>] [/Filename:<File name>] [/Force]

Windows Server 2008 R2

For boot images:

WDSUTIL [Options] /Remove-MulticastTransmission /Image:<Image name>
\x20    [/Server:<Server name>]
\x20    /ImageType:Boot
\x20    /Architecture:{x86 | ia64 | x64}
\x20    [/Filename:<File name>]

For install images:

WDSUTIL [Options] /Remove-MulticastTransmission /Image:<Image name>
        [/Server:<Server name>]
        /ImageType:Install
        [/ImageGroup:<Image Group
        [/Filename:<File name>]

Parameters

Parameter Description

/Image:<Image name>

Specifies the name of the image.

[/Server:<Server name>]

Specifies the name of the server. This can be the NetBIOS name or the fully qualified domain name (FQDN). If no server name is specified, the local server is used.

/ImageType:{Install|Boot}

Specifies the image type. Note that this option must be set to Install for Windows Server 2008.

/Architecture:{x86 | ia64 | x64}

Specifies the architecture of the boot image that is associated with the transmission to start. Because it is possible to have the same image name for boot images in different architectures, you should specify the architecture to ensure that the correct transmission is used.

[/ImageGroup:<Image group name>]

Specifies the image group that contains the image. If no image group name is specified and only one image group exists on the server, that image group is used. If more than one image group exists on the server, you must use this option to specify the image group name.

[/Filename:<File name>]

Specifies the file name. If the source image cannot be uniquely identified by name, you must use this option to specify the file name.

[/Force]

Removes the transmission and terminates all clients. Unless you specify a value for the /Force option, existing clients can complete the image transfer but new clients are not able to join.

Examples

To stop a namespace (current clients will complete the transmission, but new clients will not be able to join), type:

WDSUTIL /Remove-MulticastTransmission /Image:"Vista with Office"
/ImageType:Install

WDSUTIL /Remove-MulticastTransmission /Image:"x64 Boot Image"
/ImageType:Boot /Architecture:x64

To force termination of all clients, type:

WDSUTIL /Remove-MulticastTransmission /Server:MyWDSServer
/Image:"Vista with Office" /ImageType:Install /ImageGroup:ImageGroup1
/Filename:install.wim /Force

Additional references

Command-Line Syntax Key

/get-AllMulticastTransmissions

/get-MulticastTransmission

/new-MulticastTransmission

/start-MulticastTransmission