Start-CMDistributionPointUpgrade
Upgrades a shared distribution point.
Syntax
Start-CMDistributionPointUpgrade
[-AllowFallbackForContent <Boolean>]
[-AllowPreStaging <Boolean>]
[-AllowRespondIncomingPxeRequest <Boolean>]
[-CertificatePassword <SecureString>]
-CertificatePath <String>
[-ClientCommunicationMode <ComputerCommunicationType>]
[-ClientConnectionType <ClientConnectionTypes>]
[-ContentValidationPriority <Priority>]
-DestinationSiteCode <String>
[-EnableAnonymous <Boolean>]
[-EnableNonWdsPxe <Boolean>]
[-EnablePxeSupport <Boolean>]
[-EnableUnknownComputerSupport <Boolean>]
[-ForceWhenDuplicateCertificate <Boolean>]
[-InitiateConnection <Boolean>]
-InputObject <IResultObject>
[-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>] Start-CMDistributionPointUpgrade
[-AllowFallbackForContent <Boolean>]
[-AllowPreStaging <Boolean>]
[-AllowRespondIncomingPxeRequest <Boolean>]
-CertificateExpirationTimeUtc <DateTime>
[-ClientCommunicationMode <ComputerCommunicationType>]
[-ClientConnectionType <ClientConnectionTypes>]
[-ContentValidationPriority <Priority>]
-DestinationSiteCode <String>
[-EnableAnonymous <Boolean>]
[-EnableNonWdsPxe <Boolean>]
[-EnablePxeSupport <Boolean>]
[-EnableUnknownComputerSupport <Boolean>]
[-InitiateConnection <Boolean>]
-InputObject <IResultObject>
[-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.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 |
| Required: | False |
| 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CertificateExpirationTimeUtc
Specifies the date and time when the certificate expires.
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | True |
| 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 |
| Required: | False |
| 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 |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ClientCommunicationMode
| Type: | ComputerCommunicationType |
| Accepted values: | Http, Https |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ClientConnectionType
Specifies the client connection type. Valid values are:
- Internet
- InternetAndIntranet
- Intranet
| Type: | ClientConnectionTypes |
| Accepted values: | Intranet, Internet, InternetAndIntranet |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 |
| Required: | 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 |
| Accepted values: | Lowest, Low, Medium, High, Highest |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DestinationSiteCode
| Type: | String |
| Aliases: | SiteCode |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableWildcardHandling
This parameter treats wildcard characters as literal character values. You can't combine it with ForceWildcardHandling.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 |
| Required: | False |
| 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 |
| Required: | False |
| 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ForceWildcardHandling
This parameter processes wildcard characters and may lead to unexpected behavior (not recommended). You can't combine it with DisableWildcardHandling.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
| Type: | IResultObject |
| Aliases: | SharedDistributionPoint |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InstallIis
| Type: | Boolean |
| Aliases: | InstallInternetServer |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 |
| Required: | False |
| 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 |
| Required: | False |
| 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 |
| Required: | False |
| 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 |
| 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 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 |
| 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 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PxePassword
| Type: | SecureString |
| Aliases: | ComputersUsePxePassword |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PxeServerResponseDelaySec
| Type: | Int32 |
| Aliases: | PxeServerResponseDelaySeconds |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 |
| 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 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 |
| 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 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 |
| Accepted values: | DoNotUse, AllowWithManualApproval, AllowWithAutomaticApproval |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet doesn't run.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Inputs
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Related Links
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for