Remove-CMDistributionPoint
配布ポイントを削除します。
構文
Remove-CMDistributionPoint
[-Force]
-InputObject <IResultObject>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMDistributionPoint
[-Force]
[-SiteCode <String>]
[-SiteSystemServerName] <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
Remove-CMDistributionPoint コマンドレットは、配布ポイントを削除します。 配布ポイントを削除すると、アプリケーション、パッケージ、ソフトウェア更新プログラム、およびオペレーティング システム展開のコンテンツ ファイルの配布センターとして機能するサイト システム サーバーの指定を削除します。
注:
PS XYZ:\>
など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。
例
例 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
コマンドレットを実行する前に確認メッセージを表示します。
型: | SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DisableWildcardHandling
このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Force
ユーザーの確認を求めずにコマンドを強制的に実行します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ForceWildcardHandling
このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-InputObject
配布ポイント オブジェクトを指定します。 配布ポイント オブジェクトを取得するには、 Get-CMDistributionPoint コマンドレットを使用します。
型: | IResultObject |
Aliases: | DistributionPoint |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-SiteCode
このサイト システムの役割をホストする Configuration Manager サイトのサイト コードを指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | True |
-SiteSystemServerName
サイト システムの役割をホストするサーバーの FQDN を指定します。
型: | String |
Aliases: | Name, ServerName |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
型: | SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject