Set-CMDistributionPoint

Set-CMDistributionPoint

Modifies a Configuration Manager distribution point on a site system server.

Syntax

Parameter Set: SetByName
Set-CMDistributionPoint -SiteCode <String> -SiteSystemServerName <String> [-AddBoundaryGroupName <String[]> ] [-AllowFallbackForContent <Boolean> ] [-AllowPreStaging <Boolean> ] [-AllowRespondIncomingPxeRequest <Boolean> ] [-CertificateExpirationTimeUtc <DateTime> ] [-CertificatePassword <SecureString> ] [-CertificatePath <String> ] [-ClientCommunicationType <ComputerCommunicationType> {HTTP | HTTPS} ] [-ClientConnectionType <ClientConnectionTypes> {Internet | InternetAndIntranet | Intranet} ] [-ClientTransfterRate <NetworkProfile> {None | Profile100Mbps | Profile10Mbps | Profile1Gbps | ProfileCustom} ] [-ComputersUsePxePassword <SecureString> ] [-ContentMonitoringPriority <Priority> {High | Highest | Low | Lowest | Medium} ] [-EnableAnonymous <Boolean> ] [-EnableMulticast <Boolean> ] [-EnablePullDP <Boolean> ] [-EnablePxeSupport <Boolean> ] [-EnableScheduledMultiCast <Boolean> ] [-EnableUnknownComputerSupport <Boolean> ] [-EnableValidateContent <Boolean> ] [-EndIpAddress <String> ] [-EndUdpPort <Int32> ] [-MacAddressForRespondingPxeRequest <String[]> ] [-MinimumSessionSize <Int32> ] [-MulticastMaximumClientCount <Int32> ] [-PxeServerResponseDelaySeconds <Int32> ] [-RemoveBoundaryGroupName <String[]> ] [-RespondToAllNetwork] [-SessionStartDelayMinutes <Int32> ] [-SourceDistributionPoints <String[]> ] [-SourceDPRanks <Int32[]> ] [-StartIpAddress <String> ] [-StartUdpPort <Int32> ] [-UseAnyRangeIP] [-UseComputerAccount] [-UserDeviceAffinity <UserDeviceAffinityType> {AllowWithAutomaticApproval | AllowWithManualApproval | DoNotUse} ] [-UserName <String> ] [-ValidateContentSchedule <IResultObject> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SetByValue
Set-CMDistributionPoint -InputObject <IResultObject> [-AddBoundaryGroupName <String[]> ] [-AllowFallbackForContent <Boolean> ] [-AllowPreStaging <Boolean> ] [-AllowRespondIncomingPxeRequest <Boolean> ] [-CertificateExpirationTimeUtc <DateTime> ] [-CertificatePassword <SecureString> ] [-CertificatePath <String> ] [-ClientCommunicationType <ComputerCommunicationType> {HTTP | HTTPS} ] [-ClientConnectionType <ClientConnectionTypes> {Internet | InternetAndIntranet | Intranet} ] [-ClientTransfterRate <NetworkProfile> {None | Profile100Mbps | Profile10Mbps | Profile1Gbps | ProfileCustom} ] [-ComputersUsePxePassword <SecureString> ] [-ContentMonitoringPriority <Priority> {High | Highest | Low | Lowest | Medium} ] [-EnableAnonymous <Boolean> ] [-EnableMulticast <Boolean> ] [-EnablePullDP <Boolean> ] [-EnablePxeSupport <Boolean> ] [-EnableScheduledMultiCast <Boolean> ] [-EnableUnknownComputerSupport <Boolean> ] [-EnableValidateContent <Boolean> ] [-EndIpAddress <String> ] [-EndUdpPort <Int32> ] [-MacAddressForRespondingPxeRequest <String[]> ] [-MinimumSessionSize <Int32> ] [-MulticastMaximumClientCount <Int32> ] [-PxeServerResponseDelaySeconds <Int32> ] [-RemoveBoundaryGroupName <String[]> ] [-RespondToAllNetwork] [-SessionStartDelayMinutes <Int32> ] [-SourceDistributionPoints <String[]> ] [-SourceDPRanks <Int32[]> ] [-StartIpAddress <String> ] [-StartUdpPort <Int32> ] [-UseAnyRangeIP] [-UseComputerAccount] [-UserDeviceAffinity <UserDeviceAffinityType> {AllowWithAutomaticApproval | AllowWithManualApproval | DoNotUse} ] [-UserName <String> ] [-ValidateContentSchedule <IResultObject> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SetSecurityScopeById
Set-CMDistributionPoint -Id <String> -SecurityScopeAction <SecurityScopeActionType> {AddMembership | RemoveMembership} -SecurityScopeName <String> [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SetSecurityScopeByName
Set-CMDistributionPoint -Name <String> -SecurityScopeAction <SecurityScopeActionType> {AddMembership | RemoveMembership} -SecurityScopeName <String> [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SetSecurityScopeByValue
Set-CMDistributionPoint -InputObject <IResultObject> -SecurityScopeAction <SecurityScopeActionType> {AddMembership | RemoveMembership} -SecurityScopeName <String> [-Confirm] [-WhatIf] [ <CommonParameters>]

Detailed Description

The Set-CMDistributionPoint cmdlet modifies a distribution point on a site system server. A distribution point is a site system role that Microsoft System Center 2012 SP1 Configuration Manager uses to store files for clients to download, such as application content, software packages, software updates, operating system images, and boot images.

Parameters

-AddBoundaryGroupName<String[]>

Specifies an array of names of boundary groups to add to the distribution point.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-AllowFallbackForContent<Boolean>

Indicates whether clients can use a fallback source location for content.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-AllowPreStaging<Boolean>

Indicates whether the distribution point can pre-stage contents.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-AllowRespondIncomingPxeRequest<Boolean>

Indicates whether the distribution point can respond to pre-boot execution environment (PXE) requests.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-CertificateExpirationTimeUtc<DateTime>

Specifies the date and time when the certificate expires as Coordinated Universal Time (UTC).

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-CertificatePassword<SecureString>

Specifies the password, as a secure string, for the public key infrastructure (PKI) client certificate for the distribution point.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-CertificatePath<String>

Specifies the import path for the PKI issued certificate that the distribution point uses.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-ClientCommunicationType<ComputerCommunicationType>

Specifies the client communication type. The acceptable values for this parameter are:

-- HTTP
-- HTTPS

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-ClientConnectionType<ClientConnectionTypes>

Specifies the type of connection that clients use. The acceptable values for this parameter are:

-- Internet
-- InternetAndIntranet
-- Intranet

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-ClientTransfterRate<NetworkProfile>

Specifies the client transfer rate. The acceptable values for this parameter are:

-- None
-- Profile100Mbps
-- Profile10Mbps
-- Profile1Gbps
-- ProfileCustom

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-ComputersUsePxePassword<SecureString>

Specifies the password, as a secure string, for computers that use PXE.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-ContentMonitoringPriority<Priority>

Specifies the content monitoring priority. The acceptable values for this parameter are:

-- High
-- Highest
-- Low
-- Lowest
-- Medium

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-EnableAnonymous<Boolean>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-EnableMulticast<Boolean>

Indicates whether multicast is enabled on the distribution point.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-EnablePullDP<Boolean>

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-EnablePxeSupport<Boolean>

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 Service 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.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-EnableScheduledMultiCast<Boolean>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-EnableUnknownComputerSupport<Boolean>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-EnableValidateContent<Boolean>

Indicates whether the distribution point validates the integrity of the content files in the package.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-EndIpAddress<String>

Specifies the ending IP address in the range of IP addresses that Configuration Manager uses to send data to the destination computers.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-EndUdpPort<Int32>

Specifies the ending port in the range of user datagram protocol (UDP) ports that Configuration Manager uses to send data to the destination computers.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Id<String>

Specifies the ID of a distribution point.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-InputObject<IResultObject>

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

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-MacAddressForRespondingPxeRequest<String[]>

Specifies an array of media access controller (MAC) addresses that the distribution point uses to respond to pre-boot execution environment (PXE) requests.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-MinimumSessionSize<Int32>

Specifies how many requests must be received before Configuration Manager starts to deploy the operating system.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-MulticastMaximumClientCount<Int32>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Name<String>

Specifies the name of a computer that hosts a distribution point.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-PxeServerResponseDelaySeconds<Int32>

Specifies how long, in seconds, 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.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-RemoveBoundaryGroupName<String[]>

Specifies an array of names of boundary groups to remove from the distribution point.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-RespondToAllNetwork

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-SecurityScopeAction<SecurityScopeActionType>

Specifies an action for a security scope. The acceptable values for this parameter are: AddMembership and RemoveMembership.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-SecurityScopeName<String>

Specifies the name of a security scope. A security scope name can be Default or the name of a custom security scope.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-SessionStartDelayMinutes<Int32>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-SiteCode<String>

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

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-SiteSystemServerName<String>

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

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-SourceDistributionPoints<String[]>

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-SourceDPRanks<Int32[]>

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-StartIpAddress<String>

Specifies the starting IP address in the range of IP addresses that Configuration Manager uses to send data to the destination computers.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-StartUdpPort<Int32>

Specifies the starting port in the range of UDP ports that Configuration Manager uses to send data to the destination computers.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-UseAnyRangeIP

Indicates that multicast uses addresses within any range.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-UseComputerAccount

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-UserDeviceAffinity<UserDeviceAffinityType>

Specifies how you want the distribution point to associate users with the destination computer for PXE deployments. The acceptable values for this parameter are:

-- AllowWithAutomaticApproval
-- AllowWithManualApproval
-- DoNotUse

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-UserName<String>

Specifies the name of the user that the distribution site system components use to connect to the primary site database.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-ValidateContentSchedule<IResultObject>

Specifies a CMSchedule object. A CMSchedule object defines the schedule for validating the integrity of content files on the distribution point. To create a CMSchedule object, use the New-CMSchedule cmdlet.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Confirm

Prompts you for confirmation before running the cmdlet.

Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-WhatIf

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

Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

Examples

Example 1: Add a security scope to a distribution point by using role name

This command adds the security scope named Scope22 to a distribution point. The computer named CMDistribution.Western.Contoso.com hosts the distribution point.

PS C:\> Set-CMDistributionPoint -Name "CMDistribution.Western.Contoso.com" -SecurityScopeAction AddMembership -SecurityScopeName "Scope22" 

Example 2: Remove a security scope by using role ID

This command removes a security scope named Scope22 from the distribution point that has the specified ID.

PS C:\> Set-CMDistributionPoint -Id "SMS00073" -SecurityScopeAction RemoveMembership -SecurityScopeName "Scope22" 

Add-CMDistributionPoint

Get-CMDistributionPoint

Remove-CMDistributionPoint

Update-CMDistributionPoint

New-CMSchedule