Set-CMDistributionPoint
Modifies a Configuration Manager distribution point on a site system server.
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>]
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.
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
Prompts you for confirmation before running the cmdlet.
Required? |
false |
Position? |
named |
Default Value |
false |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
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 |
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).
The input type is the type of the objects that you can pipe to the cmdlet.
The output type is the type of the objects that the cmdlet emits.
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"
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"