Start-CMDistributionPointUpgrade

Upgrades a shared distribution point.

Syntax

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

Description

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

When you migrate from a Microsoft System Center Configuration Manager 2007 source hierarchy, you can upgrade a shared distribution point to make it a System Center 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 System Center 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 System Center Configuration Manager single instance store for use with System Center 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.

Examples

Example 1: Upgrade a shared distribution point

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

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.

Required Parameters

-CertificateExpirationTimeUtc

Specifies the date and time when the certificate expires.

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

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DestinationSiteCode
Type:String
Aliases:SiteCode
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-InputObject
Type:IResultObject
Aliases:SharedDistributionPoint
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False

Optional Parameters

-AllowFallbackForContent

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

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

Indicates whether the distribution point can pre-stage contents.

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

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

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

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

Type:SecureString
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ClientCommunicationMode
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
-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
-ContentValidationPriority

Specifies the content validation priority. Valid values are:

  • High
  • Highest
  • Low
  • Lowest
  • Medium

The default value is Lowest.

Type:Priority
Parameter Sets:Lowest, Low, Medium, High, Highest
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 whether 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
-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.

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
-ForceWhenDuplicateCertificate

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

Type:Boolean
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
-InitiateConnection

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

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-InstallIis
Type:Boolean
Aliases:InstallInternetServer
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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.

Type:IResultObject
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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.

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

Specifies the path for a copy of the migrated content.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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:.
Type:DriveType
Parameter Sets: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
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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:.
Type:DriveType
Parameter Sets: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
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PublicFqdn

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PxePassword
Type:SecureString
Aliases:ComputersUsePxePassword
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PxeServerResponseDelaySec
Type:Int32
Aliases:PxeServerResponseDelaySeconds
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SecondaryContentLibraryLocation

Specifies the secondary content location. Valid values are:

  • Automatic.
  • Drive letter from A: through Z:.
Type:DriveType
Parameter Sets: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
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SecondaryPackageShareLocation

Specifies the secondary package share location. Valid values are:

  • Automatic.
  • Drive letter from A: through Z:.
Type:DriveType
Parameter Sets: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
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-UserDeviceAffinity

Specify how the distribution point associates users with the destination computer 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
-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.

Type:IResultObject
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