Start-CMDistributionPointUpgrade
Start-CMDistributionPointUpgrade
Upgrades a shared distribution point.
構文
Parameter Set: StartDistributionPointUpgradeByImportCertificate
Start-CMDistributionPointUpgrade -AllowPreStaging <Boolean> -CertificatePath <String> -SharedDistributionPoint <IResultObject> -SiteCode <String> [-AllowFallbackForContent <Boolean> ] [-AllowRespondIncomingPxeRequest <Boolean> ] [-BoundaryGroup <IResultObject[]> ] [-CertificatePassword <SecureString> ] [-ClientConnectionType <ClientConnectionTypes> {Internet | InternetAndIntranet | Intranet} ] [-ComputersUsePxePassword <SecureString> ] [-ContentValidationPriority <Priority> {High | Highest | Low | Lowest | Medium} ] [-EnableAnonymous <Boolean> ] [-EnablePxeSupport <Boolean> ] [-EnableUnknownComputerSupport <Boolean> ] [-ForceWhenDuplicateCertificate <Boolean> ] [-InitiateConnection <Boolean> ] [-InstallationAccount <IResultObject> ] [-InstallInternetServer <Boolean> ] [-MacAddressForRespondingPxeRequest <String[]> ] [-MinFreeSpaceMB <Int32> ] [-PathForSavingMigratedPackage <String> ] [-PrimaryContentLibraryLocation <DriveType> {A | Automatic | 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} ] [-PrimaryPackageShareLocation <DriveType> {A | Automatic | 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} ] [-PublicFqdn <String> ] [-PxeServerResponseDelaySeconds <Int32> ] [-SecondaryContentLibraryLocation <DriveType> {A | Automatic | 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} ] [-SecondaryPackageShareLocation <DriveType> {A | Automatic | 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} ] [-UserDeviceAffinity <UserDeviceAffinityType> {AllowWithAutomaticApproval | AllowWithManualApproval | DoNotUse} ] [-ValidateContentSchedule <IResultObject> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: StartDistributionPointUpgradeBySelfSignedCertificate
Start-CMDistributionPointUpgrade -AllowPreStaging <Boolean> -CertificateExpirationTimeUtc <DateTime> -SharedDistributionPoint <IResultObject> -SiteCode <String> [-AllowFallbackForContent <Boolean> ] [-AllowRespondIncomingPxeRequest <Boolean> ] [-BoundaryGroup <IResultObject[]> ] [-ClientConnectionType <ClientConnectionTypes> {Internet | InternetAndIntranet | Intranet} ] [-ComputersUsePxePassword <SecureString> ] [-ContentValidationPriority <Priority> {High | Highest | Low | Lowest | Medium} ] [-EnableAnonymous <Boolean> ] [-EnablePxeSupport <Boolean> ] [-EnableUnknownComputerSupport <Boolean> ] [-InitiateConnection <Boolean> ] [-InstallationAccount <IResultObject> ] [-InstallInternetServer <Boolean> ] [-MacAddressForRespondingPxeRequest <String[]> ] [-MinFreeSpaceMB <Int32> ] [-PathForSavingMigratedPackage <String> ] [-PrimaryContentLibraryLocation <DriveType> {A | Automatic | 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} ] [-PrimaryPackageShareLocation <DriveType> {A | Automatic | 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} ] [-PublicFqdn <String> ] [-PxeServerResponseDelaySeconds <Int32> ] [-SecondaryContentLibraryLocation <DriveType> {A | Automatic | 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} ] [-SecondaryPackageShareLocation <DriveType> {A | Automatic | 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} ] [-UserDeviceAffinity <UserDeviceAffinityType> {AllowWithAutomaticApproval | AllowWithManualApproval | DoNotUse} ] [-ValidateContentSchedule <IResultObject> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
詳細説明
The Start-CMDistributionPointUpgrade cmdlet upgrades a shared distribution point to a Microsoft System Center 2012 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 2012 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 2012 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 2012 Configuration Manager single instance store for use with System Center 2012 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.
パラメーター
-AllowFallbackForContent<Boolean>
Indicates whether clients can use a fallback source location for content.
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-AllowPreStaging<Boolean>
Indicates whether the distribution point can pre-stage contents.
エイリアス |
なし |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-AllowRespondIncomingPxeRequest<Boolean>
Indicates whether the distribution point can respond to pre-boot execution environment (PXE) requests.
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-BoundaryGroup<IResultObject[]>
Specifies an array of boundry group objects. To obtain a CMBoundaryGroup object, use the Get-CMBoundaryGroup cmdlet.
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-CertificateExpirationTimeUtc<DateTime>
Specifies the date and time when the certificate expires.
エイリアス |
なし |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-CertificatePassword<SecureString>
Specifies the password, as a secure string, for the public key infrastructure (PKI) client certificate for the distribution point.
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-CertificatePath<String>
Specifies the import path for the PKI issued certificate that the distribution point uses.
エイリアス |
なし |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-ClientConnectionType<ClientConnectionTypes>
Specifies the client connection type. Valid values are:
-- Internet
-- InternetAndIntranet
-- Intranet
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-ComputersUsePxePassword<SecureString>
Specifies the password, as a secure string, for computers that use PXE.
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-ContentValidationPriority<Priority>
Specifies the content validation priority. Valid values are:
-- High
-- Highest
-- Low
-- Lowest
-- Medium
The default value is Lowest.
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-EnableAnonymous<Boolean>
Indicates whether the distribution point permits anonymous connections from Configuration Manager clients to the content library.
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-EnablePxeSupport<Boolean>
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.
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-EnableUnknownComputerSupport<Boolean>
Indicates whether support for unknown computers is enabled. Unknown computers are computers that are not managed by Configuration Manager.
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-ForceWhenDuplicateCertificate<Boolean>
Indicates whether Configuration Manager overwrites a duplicate certificate when you import a PKI client certificate for the distribution point.
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-InitiateConnection<Boolean>
Indicates whether the distribution point initiates the connection with the clients.
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-InstallationAccount<IResultObject>
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.
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-InstallInternetServer<Boolean>
Indicates whether Configuration Manager installs and configures Internet Information Services (IIS) on the server if it is not already installed. IIS must be installed on all distribution points.
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
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.
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-MinFreeSpaceMB<Int32>
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.
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-PathForSavingMigratedPackage<String>
Specifies the path for a copy of the migrated content.
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-PrimaryContentLibraryLocation<DriveType>
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:.
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-PrimaryPackageShareLocation<DriveType>
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:.
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-PublicFqdn<String>
Specifies the fully qualified domain name (FQDN) of the site system server that hosts the distribution point.
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-PxeServerResponseDelaySeconds<Int32>
Specifies, in seconds, how long 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.
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-SecondaryContentLibraryLocation<DriveType>
Specifies the secondary content location. Valid values are:
-- Automatic.
-- Drive letter from A: through Z:.
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-SecondaryPackageShareLocation<DriveType>
Specifies the secondary package share location. Valid values are:
-- Automatic.
-- Drive letter from A: through Z:.
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-SharedDistributionPoint<IResultObject>
Specifies a CMDistributionPoint object. To obtain a CMDistributionPoint object, use the Get-CMDistributionPoint cmdlet.
You can use shared distribution points to make content that you have migrated from a source hierarchy immediately available to clients in the destination hierarchy without having to recreate that content, and then distribute it to new distribution points in the destination hierarchy. When clients in the destination hierarchy request content that is deployed to distribution points that you have shared, the shared distribution points are offered to the clients as valid content locations.
エイリアス |
なし |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-SiteCode<String>
Specifies the site code for the Configuration Manager site that hosts this site system role.
エイリアス |
なし |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-UserDeviceAffinity<UserDeviceAffinityType>
Specify how the distribution point associates users with the destination computer for PXE deployments. Valid values are:
-- AllowWithAutomaticApproval
-- AllowWithManualApproval
-- DoNotUse
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
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.
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-Confirm
コマンドレットを実行する前に、ユーザーに確認を求めます。
必須? |
false |
位置は? |
named |
既定値 |
false |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-WhatIf
コマンドレットを実行するとどのような結果になるかを表示します。コマンドレットは実行されません。
必須? |
false |
位置は? |
named |
既定値 |
false |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
<CommonParameters>
このコマンドレットは次の共通パラメーターをサポートします。-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、-OutVariable.詳細については、以下を参照してください。 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。
入力
入力型は、コマンドレットにパイプできるオブジェクトの型です。
出力
出力型は、コマンドレットによって生成されるオブジェクトの型です。
例
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.
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"