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 配布ポイントでホストされていた移行されたコンテンツを再配布する必要はありません。

注:

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

例

例 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

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

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-AllowPreStaging

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

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-AllowRespondIncomingPxeRequest

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

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-CertificateExpirationTimeUtc

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

型:	DateTime
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-CertificatePassword

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

型:	SecureString
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-CertificatePath

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

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ClientCommunicationMode

型:	ComputerCommunicationType
指定可能な値:	Http, Https
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ClientConnectionType

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

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

型:	ClientConnectionTypes
指定可能な値:	Intranet, Internet, InternetAndIntranet
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Confirm

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

型:	SwitchParameter
Aliases:	cf
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ContentValidationPriority

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

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

既定値は [最小] です。

型:	Priority
指定可能な値:	Lowest, Low, Medium, High, Highest
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DestinationSiteCode

型:	String
Aliases:	SiteCode
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DisableWildcardHandling

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

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-EnableAnonymous

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

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-EnableNonWdsPxe

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

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-EnablePxeSupport

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

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

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-EnableUnknownComputerSupport

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

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ForceWhenDuplicateCertificate

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

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ForceWildcardHandling

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

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-InitiateConnection

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

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-InputObject

型:	IResultObject
Aliases:	SharedDistributionPoint
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-InstallationAccount

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

型:	IResultObject
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-InstallIis

型:	Boolean
Aliases:	InstallInternetServer
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-MacAddressForRespondingPxeRequest

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

型:	String[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-MinFreeSpaceMB

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

型:	Int32
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-PathForSavingMigratedPackage

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

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-PrimaryContentLibraryLocation

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

• 自動
• A から Z: までのドライブ文字。

型:	DriveType
指定可能な値:	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
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-PrimaryPackageShareLocation

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

• 自動
• A から Z: までのドライブ文字。

型:	DriveType
指定可能な値:	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
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-PublicFqdn

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

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-PxePassword

型:	SecureString
Aliases:	ComputersUsePxePassword
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-PxeServerResponseDelaySec

型:	Int32
Aliases:	PxeServerResponseDelaySeconds
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-SecondaryContentLibraryLocation

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

• 自動
• A から Z: までのドライブ文字。

型:	DriveType
指定可能な値:	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
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-SecondaryPackageShareLocation

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

• 自動
• A から Z: までのドライブ文字。

型:	DriveType
指定可能な値:	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
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-UserDeviceAffinity

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

• AllowWithAutomaticApproval
• AllowWithManualApproval
• DoNotUse

型:	UserDeviceAffinityType
指定可能な値:	DoNotUse, AllowWithManualApproval, AllowWithAutomaticApproval
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ValidateContentSchedule

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

型:	IResultObject
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-WhatIf

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

型:	SwitchParameter
Aliases:	wi
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

関連リンク

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