Remove-CMMaintenanceWindow

モジュール:

ConfigurationManager

メンテナンス期間を削除します。

構文

Remove-CMMaintenanceWindow
      [-Force]
      [-InputObject] <IResultObject>
      -MaintenanceWindowName <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMMaintenanceWindow
      [-CollectionId] <String>
      [-Force]
      -MaintenanceWindowName <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMMaintenanceWindow
      [-CollectionName] <String>
      [-Force]
      -MaintenanceWindowName <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

説明

コレクションからメンテナンス期間を削除するには、このコマンドレットを使用します。

メンテナンス期間の詳細については、「Configuration Managerでメンテナンス期間を使用する方法」を参照してください。

注:

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

例

例 1: ID でコレクションから名前でメンテナンス期間を削除する

このコマンドは、 配布ポイントメンテナンスという名前のメンテナンス期間を削除します。 ウィンドウは、 ID XYZ0004D を持つコレクションにあります。

Remove-CMMaintenanceWindow -Name "Distribution Point Maintenance" -CollectionId "XYZ0004D"

例 2: コレクションのすべてのメンテナンス期間を削除する

この例では、最初にコレクション オブジェクトを取得し、次にワイルドカード文字を使用して、確認を求めずにすべてのウィンドウを削除します。

$coll = Get-CMCollection -CollectionId "XYZ0003f"
Remove-CMMaintenanceWindow -InputObject $coll -MaintenanceWindowName "*" -Force

パラメーター

-CollectionId

メンテナンス期間を削除するコレクションの ID を指定します。 この ID は、標準のコレクション ID です (例: XYZ0003F)。

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

-CollectionName

メンテナンス期間を削除するコレクションの名前を指定します。

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

-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-CMCollection コマンドレットを 使用します。

Type:	IResultObject
Aliases:	Collection, Site
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-MaintenanceWindowName

対象のコレクションから削除するメンテナンス期間の名前を指定します。

ワイルドカード文字を使用できます。

• *: 複数の文字
• ?: 1 文字

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

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object

関連リンク

• Get-CMMaintenanceWindow
• New-CMMaintenanceWindow
• Set-CMMaintenanceWindow
• Configuration Managerでメンテナンス期間を使用する方法