Remove-CMMaintenanceWindow

移除維護期間。

Syntax

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>]

Description

使用此 Cmdlet 從集合中移除維護期間。

如需維護期間的詳細資訊,請參閱如何在Configuration Manager中使用維護時段

注意事項

從Configuration Manager月臺磁片磁碟機執行 Configuration Manager Cmdlet,例如 PS XYZ:\> 。 如需詳細資訊,請 參閱開始使用

範例

範例 1:依識別碼從集合中依名稱移除維護時段

此命令會移除名為 發佈點維護的維護期間。 視窗位於識別碼為 XYZ0004D 的集合上。

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

範例 2:移除集合上的所有維護時段

此範例會先取得集合物件,然後使用萬用字元移除所有視窗,而不提示確認。

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

參數

-CollectionId

指定要從中移除維護期間之集合的識別碼。 此識別碼是標準集合識別碼,例如 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

新增此參數以在執行 Cmdlet 之前提示確認。

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 Cmdlet。

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

-MaintenanceWindowName

指定要從目標集合中移除的維護時段名稱。

您可以使用萬用字元:

  • *:多個字元
  • ?:單一字元
Type:String
Aliases:Name
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:True

-WhatIf

顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。

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