Edit

Share via

Start-CMDistributionPointUpgrade

Module:
ConfigurationManager Module

Upgrades a shared distribution point.

Syntax

UseImportCertificate (Default) 

Start-CMDistributionPointUpgrade
    -CertificatePath <String>
    -DestinationSiteCode <String>
    -InputObject <IResultObject>
    [-AllowFallbackForContent <Boolean>]
    [-AllowPreStaging <Boolean>]
    [-AllowRespondIncomingPxeRequest <Boolean>]
    [-CertificatePassword <SecureString>]
    [-ClientCommunicationMode <ComputerCommunicationType>]
    [-ClientConnectionType <ClientConnectionTypes>]
    [-ContentValidationPriority <Priority>]
    [-EnableAnonymous <Boolean>]
    [-EnableNonWdsPxe <Boolean>]
    [-EnablePxeSupport <Boolean>]
    [-EnableUnknownComputerSupport <Boolean>]
    [-ForceWhenDuplicateCertificate <Boolean>]
    [-InitiateConnection <Boolean>]
    [-InstallationAccount <IResultObject>]
    [-InstallIis <Boolean>]
    [-MacAddressForRespondingPxeRequest <String[]>]
    [-MinFreeSpaceMB <Int32>]
    [-PathForSavingMigratedPackage <String>]
    [-PrimaryContentLibraryLocation <DriveType>]
    [-PrimaryPackageShareLocation <DriveType>]
    [-PublicFqdn <String>]
    [-PxePassword <SecureString>]
    [-PxeServerResponseDelaySec <Int32>]
    [-SecondaryContentLibraryLocation <DriveType>]
    [-SecondaryPackageShareLocation <DriveType>]
    [-UserDeviceAffinity <UserDeviceAffinityType>]
    [-ValidateContentSchedule <IResultObject>]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UseSelfSignedCertificate 

Start-CMDistributionPointUpgrade
    -CertificateExpirationTimeUtc <DateTime>
    -DestinationSiteCode <String>
    -InputObject <IResultObject>
    [-AllowFallbackForContent <Boolean>]
    [-AllowPreStaging <Boolean>]
    [-AllowRespondIncomingPxeRequest <Boolean>]
    [-ClientCommunicationMode <ComputerCommunicationType>]
    [-ClientConnectionType <ClientConnectionTypes>]
    [-ContentValidationPriority <Priority>]
    [-EnableAnonymous <Boolean>]
    [-EnableNonWdsPxe <Boolean>]
    [-EnablePxeSupport <Boolean>]
    [-EnableUnknownComputerSupport <Boolean>]
    [-InitiateConnection <Boolean>]
    [-InstallationAccount <IResultObject>]
    [-InstallIis <Boolean>]
    [-MacAddressForRespondingPxeRequest <String[]>]
    [-MinFreeSpaceMB <Int32>]
    [-PathForSavingMigratedPackage <String>]
    [-PrimaryContentLibraryLocation <DriveType>]
    [-PrimaryPackageShareLocation <DriveType>]
    [-PublicFqdn <String>]
    [-PxePassword <SecureString>]
    [-PxeServerResponseDelaySec <Int32>]
    [-SecondaryContentLibraryLocation <DriveType>]
    [-SecondaryPackageShareLocation <DriveType>]
    [-UserDeviceAffinity <UserDeviceAffinityType>]
    [-ValidateContentSchedule <IResultObject>]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

The Start-CMDistributionPointUpgrade cmdlet upgrades a shared distribution point to a Configuration Manager distribution point.

When you migrate from a Configuration Manager 2007 source hierarchy, you can upgrade a shared distribution point to make it a Configuration Manager distribution point. You can upgrade distribution points at both primary sites and secondary sites. The upgrade process removes the distribution point from the Configuration Manager 2007 hierarchy and makes it a site system server in the Configuration Manager hierarchy. This process also copies the existing content that is on the distributing point to a new ___location on the distribution point computer. The upgrade process then modifies the copy of the content to create the Configuration Manager single instance store for use with Configuration Manager content deployment. Therefore, when you upgrade a distribution point, you do not have to redistribute migrated content that was hosted on the Configuration Manager 2007 distribution point.

Note

Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.

Examples

Example 1: Upgrade a shared distribution point

The first command gets the distribution point object that has the ID 6617708D-0F98-4898-8D05-9E882C23DCB2, and stores the object in the $CIObj variable.

The second command upgrades the shared distribution point stored in $CIObj to the Configuration Manager site that has the site code CM1. The command specifies the import path for the PKI issued certificate that the distribution point uses, and specifies that the distribution point can pre-stage contents.

$CIObj = Get-CMDistributionPoint -DistributionPointGroupId "{6617708D-0F98-4898-8D05-9E882C23DCB2}"
Start-CMDistributionPointUpgrade -AllowPreStaging $True -CertificatePath "\\Contoso01\CM\Toolbox\BaseCert.txt" -SharedDistributionPoint $CIObj -SiteCode "CM1"

Parameters

-AllowFallbackForContent

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

Parameter properties

Type:Boolean
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-AllowPreStaging

Indicates whether the distribution point can pre-stage contents.

Parameter properties

Type:Boolean
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-AllowRespondIncomingPxeRequest

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

Parameter properties

Type:Boolean
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-CertificateExpirationTimeUtc

Specifies the date and time when the certificate expires.

Parameter properties

Type:DateTime
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

UseSelfSignedCertificate
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-CertificatePassword

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

Parameter properties

Type:SecureString
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

UseImportCertificate
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-CertificatePath

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

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

UseImportCertificate
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ClientCommunicationMode

The Start-CMDistributionPointUpgrade cmdlet upgrades a shared distribution point to a Configuration Manager distribution point.

When you migrate from a Configuration Manager 2007 source hierarchy, you can upgrade a shared distribution point to make it a Configuration Manager distribution point. You can upgrade distribution points at both primary sites and secondary sites. The upgrade process removes the distribution point from the Configuration Manager 2007 hierarchy and makes it a site system server in the Configuration Manager hierarchy. This process also copies the existing content that is on the distributing point to a new ___location on the distribution point computer. The upgrade process then modifies the copy of the content to create the Configuration Manager single instance store for use with Configuration Manager content deployment. Therefore, when you upgrade a distribution point, you do not have to redistribute migrated content that was hosted on the Configuration Manager 2007 distribution point.

Note

Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.

Parameter properties

Type:ComputerCommunicationType
Default value:None
Accepted values:Http, Https
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ClientConnectionType

Specifies the client connection type. Valid values are:

  • Internet
  • InternetAndIntranet
  • Intranet

Parameter properties

Type:ClientConnectionTypes
Default value:None
Accepted values:Intranet, Internet, InternetAndIntranet
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Confirm

Prompts you for confirmation before running the cmdlet.

Parameter properties

Type:SwitchParameter
Default value:False
Supports wildcards:False
DontShow:False
Aliases:cf

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ContentValidationPriority

Specifies the content validation priority. Valid values are:

  • High
  • Highest
  • Low
  • Lowest
  • Medium

The default value is Lowest.

Parameter properties

Type:Priority
Default value:None
Accepted values:Lowest, Low, Medium, High, Highest
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-DestinationSiteCode

The Start-CMDistributionPointUpgrade cmdlet upgrades a shared distribution point to a Configuration Manager distribution point.

When you migrate from a Configuration Manager 2007 source hierarchy, you can upgrade a shared distribution point to make it a Configuration Manager distribution point. You can upgrade distribution points at both primary sites and secondary sites. The upgrade process removes the distribution point from the Configuration Manager 2007 hierarchy and makes it a site system server in the Configuration Manager hierarchy. This process also copies the existing content that is on the distributing point to a new ___location on the distribution point computer. The upgrade process then modifies the copy of the content to create the Configuration Manager single instance store for use with Configuration Manager content deployment. Therefore, when you upgrade a distribution point, you do not have to redistribute migrated content that was hosted on the Configuration Manager 2007 distribution point.

Note

Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False
Aliases:SiteCode

Parameter sets

(All)
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-DisableWildcardHandling

This parameter treats wildcard characters as literal character values. You can't combine it with ForceWildcardHandling.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-EnableAnonymous

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

Parameter properties

Type:Boolean
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-EnableNonWdsPxe

Indicates whether the Configuration Manager PXE responder is enabled on the distribution point. When you enable a PXE responder without Windows Deployment Service (WDS), Configuration Manager installs its PXE responder service on the distribution point.

Parameter properties

Type:Boolean
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-EnablePxeSupport

Indicates whether to enable PXE 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.

Parameter properties

Type:Boolean
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-EnableUnknownComputerSupport

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

Parameter properties

Type:Boolean
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ForceWhenDuplicateCertificate

Indicates whether Configuration Manager overwrites a duplicate certificate when you import a PKI client certificate for the distribution point.

Parameter properties

Type:Boolean
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

UseImportCertificate
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ForceWildcardHandling

This parameter processes wildcard characters and may lead to unexpected behavior (not recommended). You can't combine it with DisableWildcardHandling.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-InitiateConnection

Indicates whether the distribution point initiates the connection with the clients.

Parameter properties

Type:Boolean
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-InputObject

The Start-CMDistributionPointUpgrade cmdlet upgrades a shared distribution point to a Configuration Manager distribution point.

When you migrate from a Configuration Manager 2007 source hierarchy, you can upgrade a shared distribution point to make it a Configuration Manager distribution point. You can upgrade distribution points at both primary sites and secondary sites. The upgrade process removes the distribution point from the Configuration Manager 2007 hierarchy and makes it a site system server in the Configuration Manager hierarchy. This process also copies the existing content that is on the distributing point to a new ___location on the distribution point computer. The upgrade process then modifies the copy of the content to create the Configuration Manager single instance store for use with Configuration Manager content deployment. Therefore, when you upgrade a distribution point, you do not have to redistribute migrated content that was hosted on the Configuration Manager 2007 distribution point.

Note

Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.

Parameter properties

Type:IResultObject
Default value:None
Supports wildcards:False
DontShow:False
Aliases:SharedDistributionPoint

Parameter sets

(All)
Position:Named
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

-InstallationAccount

Specifies a Site System Installation Account. Configuration Manager 2007 Site Component Manager service uses Site System Installation Accounts to install, reinstall, uninstall, and configure site systems.

Parameter properties

Type:IResultObject
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-InstallIis

The Start-CMDistributionPointUpgrade cmdlet upgrades a shared distribution point to a Configuration Manager distribution point.

When you migrate from a Configuration Manager 2007 source hierarchy, you can upgrade a shared distribution point to make it a Configuration Manager distribution point. You can upgrade distribution points at both primary sites and secondary sites. The upgrade process removes the distribution point from the Configuration Manager 2007 hierarchy and makes it a site system server in the Configuration Manager hierarchy. This process also copies the existing content that is on the distributing point to a new ___location on the distribution point computer. The upgrade process then modifies the copy of the content to create the Configuration Manager single instance store for use with Configuration Manager content deployment. Therefore, when you upgrade a distribution point, you do not have to redistribute migrated content that was hosted on the Configuration Manager 2007 distribution point.

Note

Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.

Parameter properties

Type:Boolean
Default value:None
Supports wildcards:False
DontShow:False
Aliases:InstallInternetServer

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-MacAddressForRespondingPxeRequest

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

Parameter properties

Type:

String[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-MinFreeSpaceMB

Specifies the amount of free space on a drive before Configuration Manager chooses a different drive and continues the copy process to that drive. Content files can span multiple drives.

Parameter properties

Type:Int32
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-PathForSavingMigratedPackage

Specifies the path for a copy of the migrated content.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-PrimaryContentLibraryLocation

Specifies the primary content ___location. Configuration Manager copies content to the primary content ___location until the amount of free space reaches the value that you specified for the MinFreeSpaceMB parameter. Valid values are:

  • Automatic.
  • Drive letter from A: through Z:.

Parameter properties

Type:DriveType
Default value:None
Accepted values:Automatic, A, B, C, D, E, F, G, H, I, J, K, L, M, N, O, P, Q, R, S, T, U, V, W, X, Y, Z
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-PrimaryPackageShareLocation

Specifies the primary package share ___location. Configuration Manager copies content to the primary package share ___location until the amount of free space reaches the value that you specified for the MinFreeSpaceMB parameter. Valid values are:

  • Automatic.
  • Drive letter from A: through Z:.

Parameter properties

Type:DriveType
Default value:None
Accepted values:Automatic, A, B, C, D, E, F, G, H, I, J, K, L, M, N, O, P, Q, R, S, T, U, V, W, X, Y, Z
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-PublicFqdn

Specifies the fully qualified ___domain name (FQDN) of the site system server that hosts the distribution point.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-PxePassword

The Start-CMDistributionPointUpgrade cmdlet upgrades a shared distribution point to a Configuration Manager distribution point.

When you migrate from a Configuration Manager 2007 source hierarchy, you can upgrade a shared distribution point to make it a Configuration Manager distribution point. You can upgrade distribution points at both primary sites and secondary sites. The upgrade process removes the distribution point from the Configuration Manager 2007 hierarchy and makes it a site system server in the Configuration Manager hierarchy. This process also copies the existing content that is on the distributing point to a new ___location on the distribution point computer. The upgrade process then modifies the copy of the content to create the Configuration Manager single instance store for use with Configuration Manager content deployment. Therefore, when you upgrade a distribution point, you do not have to redistribute migrated content that was hosted on the Configuration Manager 2007 distribution point.

Note

Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.

Parameter properties

Type:SecureString
Default value:None
Supports wildcards:False
DontShow:False
Aliases:ComputersUsePxePassword

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-PxeServerResponseDelaySec

The Start-CMDistributionPointUpgrade cmdlet upgrades a shared distribution point to a Configuration Manager distribution point.

When you migrate from a Configuration Manager 2007 source hierarchy, you can upgrade a shared distribution point to make it a Configuration Manager distribution point. You can upgrade distribution points at both primary sites and secondary sites. The upgrade process removes the distribution point from the Configuration Manager 2007 hierarchy and makes it a site system server in the Configuration Manager hierarchy. This process also copies the existing content that is on the distributing point to a new ___location on the distribution point computer. The upgrade process then modifies the copy of the content to create the Configuration Manager single instance store for use with Configuration Manager content deployment. Therefore, when you upgrade a distribution point, you do not have to redistribute migrated content that was hosted on the Configuration Manager 2007 distribution point.

Note

Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.

Parameter properties

Type:Int32
Default value:None
Supports wildcards:False
DontShow:False
Aliases:PxeServerResponseDelaySeconds

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-SecondaryContentLibraryLocation

Specifies the secondary content ___location. Valid values are:

  • Automatic.
  • Drive letter from A: through Z:.

Parameter properties

Type:DriveType
Default value:None
Accepted values:Automatic, A, B, C, D, E, F, G, H, I, J, K, L, M, N, O, P, Q, R, S, T, U, V, W, X, Y, Z
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-SecondaryPackageShareLocation

Specifies the secondary package share ___location. Valid values are:

  • Automatic.
  • Drive letter from A: through Z:.

Parameter properties

Type:DriveType
Default value:None
Accepted values:Automatic, A, B, C, D, E, F, G, H, I, J, K, L, M, N, O, P, Q, R, S, T, U, V, W, X, Y, Z
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-UserDeviceAffinity

Specify how the distribution point associates users with the destination computer for PXE deployments. Valid values are:

  • AllowWithAutomaticApproval
  • AllowWithManualApproval
  • DoNotUse

Parameter properties

Type:UserDeviceAffinityType
Default value:None
Accepted values:DoNotUse, AllowWithManualApproval, AllowWithAutomaticApproval
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ValidateContentSchedule

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.

Parameter properties

Type:IResultObject
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet doesn't run.

Parameter properties

Type:SwitchParameter
Default value:False
Supports wildcards:False
DontShow:False
Aliases:wi

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Inputs

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject