Share via

Remove-CMDistributionPoint

  • リファレンス
モジュール:
ConfigurationManager

配布ポイントを削除します。

構文

Remove-CMDistributionPoint
      [-Force]
      -InputObject <IResultObject>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMDistributionPoint
      [-Force]
      [-SiteCode <String>]
      [-SiteSystemServerName] <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

説明

Remove-CMDistributionPoint コマンドレットは、配布ポイントを削除します。 配布ポイントを削除すると、アプリケーション、パッケージ、ソフトウェア更新プログラム、およびオペレーティング システム展開のコンテンツ ファイルの配布センターとして機能するサイト システム サーバーの指定を削除します。

注:

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

例

例 1: パイプラインを使用して配布ポイントを削除する

PS XYZ:\> Get-CMDistributionPoint -SiteSystemServerName "MySiteSys_11310.Contoso.com" | Remove-CMDistributionPoint -Force

このコマンドは、MySiteSys_11310.Contoso.com という名前のサイト システム サーバーの配布ポイント オブジェクトを取得し、パイプライン演算子を使用して、配布ポイント オブジェクトを 削除する Remove-CMDistributionPoint にオブジェクトを渡します。 Force パラメーターを指定すると、配布ポイントが削除される前にユーザーにプロンプトが表示されないことを示します。

例 2: オブジェクト変数を使用して配布ポイントを削除する

PS XYZ:\> $DP = Get-CMDistributionPoint -SiteSystemServerName "MySiteSys_11310.Contoso.com"
PS XYZ:\> Remove-CMDistributionPoint -InputObject $DP -Force

最初のコマンドは、MySiteSys_11310.Contoso.com という名前のサイト システム サーバーの配布ポイント オブジェクトを取得し、そのオブジェクトを $DP 変数に格納します。

2 番目のコマンドは、$DPに格納されている配布ポイントを削除します。 Force パラメーターを指定すると、配布ポイントが削除される前にユーザーにプロンプトが表示されないことを示します。

パラメーター

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
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

-Force

ユーザーの確認を求めずにコマンドを強制的に実行します。

Type:SwitchParameter
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

-InputObject

配布ポイント オブジェクトを指定します。 配布ポイント オブジェクトを取得するには、 Get-CMDistributionPoint コマンドレットを使用します。

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

-SiteCode

このサイト システムの役割をホストするConfiguration Manager サイトのサイト コードを指定します。

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

-SiteSystemServerName

サイト システムの役割をホストするサーバーの FQDN を指定します。

Type:String
Aliases:Name, ServerName
Position:0
Default value:None
Required:True
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