Add-CMDistributionPoint
Add-CMDistributionPoint
Creates a distribution point.
構文
Parameter Set: DistributionPointWithSelfCert
Add-CMDistributionPoint -CertificateExpirationTimeUtc <DateTime> -MinimumFreeSpaceMB <Int32> -SiteCode <String> -SiteSystemServerName <String> [-AllowPreStaging] [-AllowRespondIncomingPxeRequest] [-ClientConnectionType <ClientConnectionTypes> {Internet | InternetAndIntranet | Intranet} ] [-ComputersUsePxePassword <SecureString> ] [-ContentMonitoringPriority <Priority> {High | Highest | Low | Lowest | Medium} ] [-EnableAnonymous] [-EnableMulticast] [-EnablePullDP] [-EnablePxeSupport] [-EnableScheduledMulticast <Boolean> ] [-EnableUnknownComputerSupport] [-EnableValidateContent] [-EndIpAddress <String> ] [-EndUdpPort <Int32> ] [-InstallInternetServer] [-MacAddressForRespondingPxeRequest <String[]> ] [-MinimumSessionSize <Int32> ] [-MulticastMaximumClientCount <Int32> ] [-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} ] [-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} ] [-SessionStartDelayMinutes <Int32> ] [-SourceDistributionPoints <String[]> ] [-SourceDPRanks <Int32[]> ] [-StartIpAddress <String> ] [-StartUdpPort <Int32> ] [-UserDeviceAffinity <UserDeviceAffinityType> {AllowWithAutomaticApproval | AllowWithManualApproval | DoNotUse} ] [-UserName <String> ] [-ValidateContentSchedule <IResultObject> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: DistributionPointwithUserSpecifiedCert
Add-CMDistributionPoint -CertificatePassword <SecureString> -CertificatePath <String> -MinimumFreeSpaceMB <Int32> -SiteCode <String> -SiteSystemServerName <String> [-AllowPreStaging] [-AllowRespondIncomingPxeRequest] [-ClientConnectionType <ClientConnectionTypes> {Internet | InternetAndIntranet | Intranet} ] [-ComputersUsePxePassword <SecureString> ] [-ContentMonitoringPriority <Priority> {High | Highest | Low | Lowest | Medium} ] [-EnableAnonymous] [-EnableMulticast] [-EnablePullDP] [-EnablePxeSupport] [-EnableScheduledMulticast <Boolean> ] [-EnableUnknownComputerSupport] [-EnableValidateContent] [-EndIpAddress <String> ] [-EndUdpPort <Int32> ] [-InstallInternetServer] [-MacAddressForRespondingPxeRequest <String[]> ] [-MinimumSessionSize <Int32> ] [-MulticastMaximumClientCount <Int32> ] [-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} ] [-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} ] [-SessionStartDelayMinutes <Int32> ] [-SourceDistributionPoints <String[]> ] [-SourceDPRanks <Int32[]> ] [-StartIpAddress <String> ] [-StartUdpPort <Int32> ] [-UserDeviceAffinity <UserDeviceAffinityType> {AllowWithAutomaticApproval | AllowWithManualApproval | DoNotUse} ] [-UserName <String> ] [-ValidateContentSchedule <IResultObject> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
詳細説明
The Add-CMDistributionPoint cmdlet creates a distribution point on a site system server. A distribution point is a site system role that Microsoft System Center 2012 Configuration Manager uses to store files for clients to download, such as application content, software packages, software updates, operating system images, and boot images.
You must designate a site system server as a distribution point before you can make content available to client computers. You can add the distribution point site role to a new site system server or add the site role to an existing site system server.
パラメーター
-AllowPreStaging
Indicates that the distribution point can pre-stage contents.
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-AllowRespondIncomingPxeRequest
Indicates that the distribution point can respond to pre-boot execution environment (PXE) requests.
エイリアス |
なし |
必須? |
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.
エイリアス |
なし |
必須? |
true |
位置は? |
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 |
-ContentMonitoringPriority<Priority>
Specifies the content monitoring priority. Valid values are:
-- High
-- Highest
-- Low
-- Lowest
-- Medium
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-EnableAnonymous
Indicates that the distribution point permits anonymous connections from Configuration Manager clients to the content library.
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-EnableMulticast
Indicates that multicast is enabled on this distribution point.
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-EnablePullDP
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-EnablePxeSupport
Indicates that PXE is enabled 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 |
-EnableScheduledMulticast<Boolean>
Indicates whether you can configure when Configuration Manager deploys the operating system image from the distribution point.
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-EnableUnknownComputerSupport
Indicates that support for unknown computers is enabled. Unknown computers are computers that are not managed by Configuration Manager.
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-EnableValidateContent
Indicates that the distribution point validates the integrity of the content files in the package.
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-EndIpAddress<String>
Specifies the ending IP address in the range of ID addresses that Configuration Manager uses to send data to the destination computers.
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-EndUdpPort<Int32>
Specifies the ending port in the range of user datagram protocol (UDP) ports that Configuration Manager uses to send data to the destination computers.
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-InstallInternetServer
Indicates that 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 |
-MinimumFreeSpaceMB<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.
エイリアス |
なし |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-MinimumSessionSize<Int32>
Specifies how many requests must be received before Configuration Manager starts to deploy the operating system.
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-MulticastMaximumClientCount<Int32>
Specifies the maximum number of destination computers that can download the operating system from this distribution point.
エイリアス |
なし |
必須? |
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 MinimumFreeSpaceMB 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 MinimumFreeSpaceMB parameter. Valid values are:
-- Automatic.
-- Drive letter from A: through Z:.
エイリアス |
なし |
必須? |
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 |
-SessionStartDelayMinutes<Int32>
Specifies the number of minutes that Configuration Manager waits before it responds to the first deployment request.
エイリアス |
なし |
必須? |
false |
位置は? |
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 |
-SiteSystemServerName<String>
Specifies the name of a server that hosts a site system role.
エイリアス |
なし |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-SourceDistributionPoints<String[]>
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-SourceDPRanks<Int32[]>
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-StartIpAddress<String>
Specifies the starting IP address in the range of ID addresses that Configuration Manager uses to send data to the destination computers.
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-StartUdpPort<Int32>
Specifies the starting port in the range of user datagram protocol (UDP) ports that Configuration Manager uses to send data to the destination computers.
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-UserDeviceAffinity<UserDeviceAffinityType>
Specifies how you want the distribution point to associate users with the destination computer for PXE deployments. Valid values are:
-- AllowWithAutomaticApproval
-- AllowWithManualApproval
-- DoNotUse
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-UserName<String>
Specifies the name of the user that the distribution site system components use to connect to the primary site database.
エイリアス |
なし |
必須? |
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: Add a distribution point
This command installs and configures a distribution point to the site server named CMDIV-WEST04.CORP.CONTOSO.COM that is hosted on the Configuration Manager site that has the site code CM2.
PS C:\> Add-CMDistributionPoint -SiteSystemServerName "CMDIV-WEST04.CORP.CONTOSO.COM" -SiteCode "CM2" -InstallInternetServer -SslState $True -ClientConnectionType Intranet -EnableAnonymous -CertificateExpirationDate "2111/11/13 17:45:00" -EnablePrestage -MinimumFreeSpace 500 -PrimaryLocation A -SecondaryLocation B -PrimaryShare C -SecondaryShare D -EnablePxe -AllowRespondToPxeRequest -EnableUnknownMachinesSupport -UserDeviceAffinity AllowUserDeviceAffinityWithManualApproval -PxeResponseDelay 10 -EnableMulticast -UserName "contoso\evan" -StartUdpPort 1000 -EndUdpPort 64000 -ClientTransfterRate Profile10Mbps -MulticaseMaximumClient 101 -EnableSchedule -SessionStartDelay 16 -MinimumSessionSize 21