Start-CMDistributionPointUpgrade

モジュール:

ConfigurationManager

共有配布ポイントをアップグレードします。

構文

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

説明

Start-CMDistributionPointUpgrade コマンドレットは、共有配布ポイントをConfiguration Manager配布ポイントにアップグレードします。

Configuration Manager 2007 ソース階層から移行する場合は、共有配布ポイントをアップグレードしてConfiguration Manager配布ポイントにすることができます。 配布ポイントは、プライマリ サイトとセカンダリ サイトの両方でアップグレードできます。 アップグレード プロセスは、Configuration Manager 2007 階層から配布ポイントを削除し、Configuration Manager階層内のサイト システム サーバーにします。 このプロセスでは、配布ポイント上にある既存のコンテンツも配布ポイント コンピューター上の新しい場所にコピーされます。 次に、アップグレード プロセスによってコンテンツのコピーが変更され、Configuration Managerコンテンツデプロイで使用するConfiguration Managerの単一インスタンス ストアが作成されます。 そのため、配布ポイントをアップグレードするときに、Configuration Manager 2007 配布ポイントでホストされていた移行されたコンテンツを再配布する必要はありません。

注:

Configuration Manager サイト ドライブからConfiguration Managerコマンドレットを実行します (例: PS XYZ:\>)。 詳細については、「作業の 開始」を参照してください。

例

例 1: 共有配布ポイントをアップグレードする

最初のコマンドは、ID 6617708D-0F98-4898-8D05-9E882C23DCB2 を持つ配布ポイント オブジェクトを取得し、そのオブジェクトを$CIObj変数に格納します。

2 番目のコマンドは、$CIObjに格納されている共有配布ポイントを、サイト コード CM1 を持つConfiguration Manager サイトにアップグレードします。 コマンドは、配布ポイントが使用する PKI 発行証明書のインポート パスを指定し、配布ポイントがコンテンツを事前にステージングできることを指定します。

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

パラメーター

-AllowFallbackForContent

クライアントがコンテンツにフォールバック ソースの場所を使用できるかどうかを示します。

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

-AllowPreStaging

配布ポイントがコンテンツを事前にステージできるかどうかを示します。

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

-AllowRespondIncomingPxeRequest

配布ポイントがブート前実行環境 (PXE) 要求に応答できるかどうかを示します。

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

-CertificateExpirationTimeUtc

証明書の有効期限が切れる日時を指定します。

Type:	DateTime
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-CertificatePassword

配布ポイントの公開キー インフラストラクチャ (PKI) クライアント証明書のパスワードをセキュリティで保護された文字列として指定します。

Type:	SecureString
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CertificatePath

配布ポイントが使用する PKI 発行証明書のインポート パスを指定します。

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

クライアント接続の種類を指定します。 有効な値は次のとおりです。

• インターネット
• InternetAndIntranet
• イントラネット

Type:	ClientConnectionTypes
Accepted values:	Intranet, Internet, InternetAndIntranet
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

コマンドレットを実行する前に確認メッセージを表示します。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ContentValidationPriority

コンテンツ検証の優先順位を指定します。 有効な値は次のとおりです。

• 高
• 最高
• 低
• 最低
• 中

既定値は [最小] です。

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

このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableAnonymous

配布ポイントが、Configuration Manager クライアントからコンテンツ ライブラリへの匿名接続を許可するかどうかを示します。

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

-EnableNonWdsPxe

Configuration Manager PXE レスポンダーが配布ポイントで有効になっているかどうかを示します。 Windows 展開サービス (WDS) を使用せずに PXE レスポンダーを有効にすると、Configuration Managerは PXE レスポンダー サービスを配布ポイントにインストールします。

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

-EnablePxeSupport

配布ポイントで PXE を有効にするかどうかを示します。

PXE を有効にすると、Configuration Manager必要に応じてサーバーに Windows 展開サービスがインストールされます。 Windows 展開サービスは、オペレーティング システムをインストールするために PXE ブートを実行するサービスです。 配布ポイントを作成した後、Configuration Managerは PXE ブート機能を使用するプロバイダーを Windows 展開サービスにインストールします。

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

-EnableUnknownComputerSupport

不明なコンピューターのサポートが有効かどうかを示します。 不明なコンピューターは、Configuration Managerによって管理されていないコンピューターです。

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

-ForceWhenDuplicateCertificate

配布ポイントの PKI クライアント証明書をインポートするときに、重複する証明書Configuration Manager上書きするかどうかを示します。

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

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InitiateConnection

配布ポイントがクライアントとの接続を開始するかどうかを示します。

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

サイト システムのインストール アカウントを指定します。 Configuration Manager 2007 サイト コンポーネント マネージャー サービスでは、サイト システムのインストール アカウントを使用して、サイト システムのインストール、再インストール、アンインストール、構成を行います。

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

ブート前実行環境 (PXE) 要求に応答するために配布ポイントが使用するメディア アクセス コントローラー (MAC) アドレスの配列を指定します。

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MinFreeSpaceMB

別のドライブを選択Configuration Manager前のドライブ上の空き領域の量を指定し、そのドライブへのコピー プロセスを続行します。 コンテンツ ファイルは複数のドライブにまたがる場合があります。

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

-PathForSavingMigratedPackage

移行されたコンテンツのコピーのパスを指定します。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PrimaryContentLibraryLocation

プライマリ コンテンツの場所を指定します。 Configuration Managerは、空き領域の量が MinFreeSpaceMB パラメーターに指定した値に達するまで、コンテンツをプライマリ コンテンツの場所にコピーします。 有効な値は次のとおりです。

• 自動
• A から 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

プライマリ パッケージ共有の場所を指定します。 Configuration Managerは、空き領域の量が MinFreeSpaceMB パラメーターに指定した値に達するまで、コンテンツをプライマリ パッケージ共有の場所にコピーします。 有効な値は次のとおりです。

• 自動
• A から 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

配布ポイントをホストするサイト システム サーバーの完全修飾ドメイン名 (FQDN) を指定します。

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

セカンダリ コンテンツの場所を指定します。 有効な値は次のとおりです。

• 自動
• A から 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

セカンダリ パッケージ共有の場所を指定します。 有効な値は次のとおりです。

• 自動
• A から 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

配布ポイントが PXE 展開の対象コンピューターにユーザーを関連付ける方法を指定します。 有効な値は次のとおりです。

• 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

CMSchedule オブジェクトを指定します。 CMSchedule オブジェクトは、配布ポイント上のコンテンツ ファイルの整合性を検証するためのスケジュールを定義します。 CMSchedule オブジェクトを作成するには、 New-CMSchedule コマンドレットを 使用します。

Type:	IResultObject
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

関連リンク

• Get-CMDistributionPointGroup
• Get-CMBoundaryGroup
• Get-CMDistributionPoint
• New-CMSchedule