Remove-CMDistributionPoint
Remove-CMDistributionPoint
Removes a distribution point.
構文
Parameter Set: SearchByNameMandatory
Remove-CMDistributionPoint -SiteCode <String> -SiteSystemServerName <String> [-Force] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SearchByValueMandatory
Remove-CMDistributionPoint -InputObject <IResultObject> [-Force] [-Confirm] [-WhatIf] [ <CommonParameters>]
詳細説明
The Remove-CMDistributionPoint cmdlet removes a distribution point. When you remove a distribution point, you remove the designation of a site system server to function as a distribution center for content files for applications, packages, software updates, and operating system deployment.
パラメーター
-Force
Performs the action without a confirmation message.
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-InputObject<IResultObject>
Specifies a CMDistributionPoint object. To obtain a CMDistributionPoint object, use the Get-CMDistributionPoint cmdlet.
エイリアス |
なし |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-SiteCode<String>
Specifies the site code that is associated with the distribution point.
エイリアス |
なし |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-SiteSystemServerName<String>
Specifies a fully qualified domain name (FQDN) of the server that hosts the site system role.
エイリアス |
なし |
必須? |
true |
位置は? |
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: Remove a distribution point by using a site code and site system role
This command removes the distribution point that is associated with the site code CM1 and the site system role named CMCEN-DIST02.TSQA.CORP.CONTOSCO.COM.
PS C:\> Remove-CMDistributionPoint -SiteSystemServerName "CMCEN-DIST02.TSQA.CORP.CONTOSCO.COM" -SiteCode "CM1"
Example 2: Remove a distribution point by using an object variable
The first command gets a distribution that is associated with the site code ST1 and the site system role named PptCmdv-1.DIST01.CORP.CONTOSCO.com. The command stores the results to the $Di variable.
The second command removes the distribution point stored in the $Di variable.
PS C:\> $Di = Get-CMDistributionPoint -SiteSystemServerName "PptCmdv-1.DIST01.CORP.CONTOSCO.com" -SiteCode "ST1"
PS C:\> Remove-CMDistributionPoint -InputObject $Di