Set-​CM​Distribution​Point

Sets a distribution point.

Syntax

Set-CMDistributionPoint
   [-InputObject] <IResultObject>
   [-AddBoundaryGroupName <String[]>]
   [-AddMacAddressForRespondingPxeRequest <String[]>]
   [-AllowFallbackForContent <Boolean>]
   [-AllowPreStaging <Boolean>]
   [-AllowProxyTraffic <Boolean>]
   [-AllowPxeResponse <Boolean>]
   [-CertificateExpirationTimeUtc <DateTime>]
   [-CertificatePassword <SecureString>]
   [-CertificatePath <String>]
   [-ClearMacAddressForRespondingPxeRequest]
   [-ClientCommunicationType <ComputerCommunicationType>]
   [-ClientConnectionType <ClientConnectionTypes>]
   [-ClientTransferRate <NetworkProfile>]
   [-Confirm]
   [-ContentMonitoringPriority <Priority>]
   [-ContentValidationSchedule <IResultObject>]
   [-Description <String>]
   [-DisableWildcardHandling]
   [-EnableAnonymous <Boolean>]
   [-EnableBranchCache <Boolean>]
   [-EnableContentValidation <Boolean>]
   [-EnableMulticast <Boolean>]
   [-EnablePullDP <Boolean>]
   [-EnablePxe <Boolean>]
   [-EnableScheduledMulticast <Boolean>]
   [-EnableUnknownComputerSupport <Boolean>]
   [-EndIPAddress <String>]
   [-EndUdpPort <Int32>]
   [-ForceWildcardHandling]
   [-KeepWds <Boolean>]
   [-MacAddressForRespondingPxeRequest <String[]>]
   [-MinimumSessionSize <Int32>]
   [-MulticastMaximumClientCount <Int32>]
   [-PassThru]
   [-PxePassword <SecureString>]
   [-PxeServerResponseDelaySec <Int32>]
   [-RemoveBoundaryGroupName <String[]>]
   [-RemoveMacAddressForRespondingPxeRequest <String[]>]
   [-RespondToAllNetwork]
   [-SessionStartDelayMins <Int32>]
   [-SourceDPRank <Int32[]>]
   [-SourceDistributionPoint <String[]>]
   [-StartIPAddress <String>]
   [-StartUdpPort <Int32>]
   [-UseAnyRangeIP]
   [-UseComputerAccount]
   [-UserDeviceAffinity <UserDeviceAffinityType>]
   [-UserName <String>]
   [-WhatIf]
   [<CommonParameters>]
Set-CMDistributionPoint
   [-SiteSystemServerName] <String>
   [-AddBoundaryGroupName <String[]>]
   [-AddMacAddressForRespondingPxeRequest <String[]>]
   [-AllowFallbackForContent <Boolean>]
   [-AllowPreStaging <Boolean>]
   [-AllowProxyTraffic <Boolean>]
   [-AllowPxeResponse <Boolean>]
   [-CertificateExpirationTimeUtc <DateTime>]
   [-CertificatePassword <SecureString>]
   [-CertificatePath <String>]
   [-ClearMacAddressForRespondingPxeRequest]
   [-ClientCommunicationType <ComputerCommunicationType>]
   [-ClientConnectionType <ClientConnectionTypes>]
   [-ClientTransferRate <NetworkProfile>]
   [-Confirm]
   [-ContentMonitoringPriority <Priority>]
   [-ContentValidationSchedule <IResultObject>]
   [-Description <String>]
   [-DisableWildcardHandling]
   [-EnableAnonymous <Boolean>]
   [-EnableBranchCache <Boolean>]
   [-EnableContentValidation <Boolean>]
   [-EnableMulticast <Boolean>]
   [-EnablePullDP <Boolean>]
   [-EnablePxe <Boolean>]
   [-EnableScheduledMulticast <Boolean>]
   [-EnableUnknownComputerSupport <Boolean>]
   [-EndIPAddress <String>]
   [-EndUdpPort <Int32>]
   [-ForceWildcardHandling]
   [-KeepWds <Boolean>]
   [-MacAddressForRespondingPxeRequest <String[]>]
   [-MinimumSessionSize <Int32>]
   [-MulticastMaximumClientCount <Int32>]
   [-PassThru]
   [-PxePassword <SecureString>]
   [-PxeServerResponseDelaySec <Int32>]
   [-RemoveBoundaryGroupName <String[]>]
   [-RemoveMacAddressForRespondingPxeRequest <String[]>]
   [-RespondToAllNetwork]
   [-SessionStartDelayMins <Int32>]
   [-SiteCode <String>]
   [-SourceDPRank <Int32[]>]
   [-SourceDistributionPoint <String[]>]
   [-StartIPAddress <String>]
   [-StartUdpPort <Int32>]
   [-UseAnyRangeIP]
   [-UseComputerAccount]
   [-UserDeviceAffinity <UserDeviceAffinityType>]
   [-UserName <String>]
   [-WhatIf]
   [<CommonParameters>]

Description

The Set-CMDistributionPoint cmdlet modifies a distribution point on a site system server.

Examples

Example 1: Set properties of a distribution point

PS C:\> $DP = Get-CMDistributionPoint -SiteSystemServerName "MySiteSys_11310.Contoso.com"
PS C:\> Set-CMDistributionPoint -InputObject $DP -AllowFallbackForContent $True -AllowPreStaging $True -AllowPxeResponse $False -ClientCommunicationType Http -ClientConnectionType Internet -ContentMonitoringPriority High

The first command gets the distribution point object for the site system server named MySiteSys_11310.Contoso.com and stores the object in the $DP variable.

The second command modifies the distribution point object stored in $DP.

Example 2: Set properties of a distribution point by using the pipeline

PS C:\> Get-CMDistributionPoint -SiteSystemServerName "MySiteSys_11310.Contoso.com" | Set-CMDistributionPoint -AllowFallbackForContent $True -AllowPreStaging $True -AllowPxeResponse $True -ClientCommunicationType Http -ClientConnectionType Internet -ContentMonitoringPriority High

This command gets the distribution point object for the site system server named MySiteSys_11310.Contoso.com and uses the pipeline operator to pass the object to Set-CMDistributionPoint, which modifies the distribution point object.

Required Parameters

-InputObject

Specifies a distribution point object. To obtain a distribution point object, use the Get-CMDistributionPoint cmdlet.

Type:IResultObject
Aliases:DistributionPoint
Position:0
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-SiteSystemServerName

Specifies the name of a server that hosts a site system role.

Type:String
Aliases:Name, ServerName
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Optional Parameters

-AddBoundaryGroupName

Adds an array of boundary groups, by name, to a distribution point.

Type:String[]
Aliases:AddBoundaryGroupNames
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-AddMacAddressForRespondingPxeRequest

Adds an array of media access control (MAC) addresses that respond to Pre-boot eXecution Environment (PXE) requests for a PXE-enabled distribution point.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-AllowFallbackForContent

Indicates whether clients outside of the boundary groups associated with a site system can fall back and use this site system as a source location for content when no other site systems are available.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-AllowPreStaging

Indicates whether the distribution point is enabled for prestaged content.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-AllowProxyTraffic

{{Fill AllowProxyTraffic Description}}

Type:Boolean
Aliases:EnableCloudGateway
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-AllowPxeResponse

Indicates whether the distribution point can respond to PXE requests.

Type:Boolean
Aliases:AllowRespondIncomingPxeRequest
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-CertificateExpirationTimeUtc

Specifies, in UTC format, the date and time when the certificate expires.

Type:DateTime
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-CertificatePassword

Specifies, as a secure string, the password for a PKI client certificate.

Type:SecureString
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-CertificatePath

Specifies the import path for a PKI client certificate.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ClearMacAddressForRespondingPxeRequest

Indicates that the cmdlet removes the array of MAC addresses that the distribution point uses to respond to PXE requests.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ClientCommunicationType

Specifies how clients or devices communicate with the distribution point. Valid values are: - HTTP

  • HTTPS
Type:ComputerCommunicationType
Parameter Sets:Http, Https
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ClientConnectionType

Specifies the client connection type. Valid values are:- Internet

  • InternetAndIntranet
  • Intranet
Type:ClientConnectionTypes
Parameter Sets:Intranet, Internet, InternetAndIntranet
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ClientTransferRate

Specifies the client transfer rate. Valid values are:- None

  • Profile100Mbps
  • Profile10Mbps
  • Profile1Gbps
  • ProfileCustom
Type:NetworkProfile
Parameter Sets:None, ProfileCustom, Profile10Mbps, Profile100Mbps, Profile1Gbps
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-ContentMonitoringPriority

Specifies the content monitoring priority. Valid values are:- High

  • Highest
  • Low
  • Lowest
  • Medium
Type:Priority
Parameter Sets:Lowest, Low, Medium, High, Highest
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ContentValidationSchedule

Specifies a schedule token object that the distribution point uses to validate content on a scheduled basis. To create a schedule token object, use the New-CMSchedule cmdlet.

Type:IResultObject
Aliases:ValidateContentSchedule
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Description

Specifies a description for the distribution point.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DisableWildcardHandling

DisableWildcardHandling treats wildcard characters as literal character values. Cannot be combined with ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-EnableAnonymous

Indicates that the distribution point permits anonymous connections from Configuration Manager clients to the content library.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-EnableBranchCache

Indicates that clients that use Windows BranchCache are allowed to download content from an on-premises distribution point. Content downloads from cloud-based distribution points can always be shared by clients that use Windows BranchCache.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-EnableContentValidation

Indicates that content validation is enabled for this distribution point.

Type:Boolean
Aliases:EnableValidateContent
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-EnableMulticast

Indicates whether multicast is enabled for the distribution point.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-EnablePullDP

Enables, when set to $True, the distribution point is able to pull content from other distribution points.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-EnablePxe

Indicates whether PXE is enabled on the distribution point.When you enable PXE, Configuration Manager installs Windows Deployment Services on the server, if required. Windows Deployment Services is the service that performs the PXE boot to install operating systems. After you create the distribution point, Configuration Manager installs a provider in Windows Deployment Services that uses the PXE boot functions.

Type:Boolean
Aliases:EnablePxeSupport
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-EnableScheduledMulticast

Indicates whether you can schedule when Configuration Manager deploys the operating system image from the distribution point.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-EnableUnknownComputerSupport

Indicates whether support for unknown computers is enabled. Unknown computers are computers that are not managed by Configuration Manager.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-EndIPAddress

Specifies the ending IP address in a range of multicast addresses that Configuration Manager uses to send data to clients.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-EndUdpPort

Specifies the ending UDP port in a range of multicast UDP ports that Configuration Manager uses to send data to clients.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ForceWildcardHandling

ForceWildcardHandling processes wildcard characters and may lead to unexpected behavior (not recommended). Cannot be combined with DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-KeepWds

Indicates whether the distribution point keeps Windows Deployment Services (WDS) or removes WDS when PXE is disabled.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-MacAddressForRespondingPxeRequest

Specifies an array of MAC addresses that the distribution point uses to respond to PXE requests.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-MinimumSessionSize

Specifies how many client requests must be received before a scheduled multicast starts to deploy the operating system.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-MulticastMaximumClientCount

Specifies the maximum number of clients that can download the operating system from this distribution point.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PassThru

Returns the current working object. By default, this cmdlet does not generate any output.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PxePassword

Specifies, as a secure string, the PXE password.

Type:SecureString
Aliases:ComputersUsePxePassword
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PxeServerResponseDelaySec

Specifies, in seconds, how long the distribution point delays before it responds to computer requests when you are using multiple PXE-enabled distribution points. By default, the Configuration Manager PXE service point responds first to network PXE requests.

Type:Int32
Aliases:PxeServerResponseDelaySeconds
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-RemoveBoundaryGroupName

Removes an array of boundary groups, by name, from the distribution point.

Type:String[]
Aliases:RemoveBoundaryGroupNames
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-RemoveMacAddressForRespondingPxeRequest

Removes an array of MAC addresses that the distribution point uses to respond to PXE requests.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-RespondToAllNetwork

Indicates that the distribution point responds to PXE requests that arrive on any of its network interfaces.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SessionStartDelayMins

Specifies the number of minutes that Configuration Manager waits before it responds to the first deployment request.

Type:Int32
Aliases:SessionStartDelayMinutes
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SiteCode

Specifies the site code for the Configuration Manager site that hosts this site system role.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SourceDPRank

Specifies an array that contains the priorities for the distribution point sources from which this distribution point can pull content. Source distribution points that have the same priority are randomly selected.

Type:Int32[]
Aliases:SourceDPRanks
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SourceDistributionPoint

Specifies an array of distribution point sources from which this distribution point can pull content.

Type:String[]
Aliases:SourceDistributionPoints
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-StartIPAddress

Specifies the starting IP address in a range of multicast addresses that Configuration Manager uses to send data to clients.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-StartUdpPort

Specifies the starting UDP port in a range of multicast UDP ports that Configuration Manager uses to send data to clients.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-UseAnyRangeIP

Indicates that multicast uses IP addresses within any range.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-UseComputerAccount

Indicates that the distribution point uses its computer account as the multicast connection account when it connects to the primary site database.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-UserDeviceAffinity

Specifies how you want the distribution point to associate users with their devices for PXE deployments. Valid values are:- AllowWithAutomaticApproval

  • AllowWithManualApproval
  • DoNotUse
Type:UserDeviceAffinityType
Parameter Sets:DoNotUse, AllowWithManualApproval, AllowWithAutomaticApproval
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-UserName

Specifies the name of the user that the distribution point uses to connect to the primary site database. Use the format domain\username.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False