共用方式為

Get-CMMaintenanceWindow

  • 參考
模組:
ConfigurationManager

取得集合的維護期間。

語法

Get-CMMaintenanceWindow
   [-InputObject] <IResultObject>
   [-MaintenanceWindowName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMMaintenanceWindow
   [-CollectionId] <String>
   [-MaintenanceWindowName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMMaintenanceWindow
   [-CollectionName] <String>
   [-MaintenanceWindowName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

使用此 Cmdlet 來取得指定集合的維護期間。 您也可以將結果篩選到特定的維護期間。

如需維護期間的詳細資訊，請參閱 How to use maintenance windows in Configuration Manager。

注意事項

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

範例

範例 1：依標識符取得集合的啟用維護期間

此命令會取得針對指定集合啟用的維護期間。

Get-CMMaintenanceWindow -CollectionID "XYZ0004D" | Where-Object { $_.IsEnabled }

範例 2：取得集合物件的所有維護期間

此範例會先取得集合物件，然後在管線上傳遞該物件，以依名稱取得維護時段。

$coll = Get-CMCollection -CollectionID 'XYZ0003F'
$coll | Get-CMMaintenanceWindow -MaintenanceWindowName 'nightly SUM window'

範例 3：取得維護期間的排程

此範例會先取得特定集合的維護期間。 然後，它會轉換 ServiceWindowSchedules 屬性，以顯示維護時段的排程。

$mw = Get-CMMaintenanceWindow -CollectionID "XYZ000AB"
Convert-CMSchedule -ScheduleString $mw.ServiceWindowSchedules

參數

-CollectionId

指定要查詢其維護期間的集合標識碼。 這個識別碼是標準集合識別碼，例如 XYZ0003F。

類型:String
Position:0
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-CollectionName

指定要查詢其維護期間的集合名稱。

類型:String
Position:0
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-DisableWildcardHandling

此參數會將通配符視為常值字元值。 您無法將其與 ForceWildcardHandling 結合。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ForceWildcardHandling

此參數會處理通配符，並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling 結合。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-InputObject

指定要查詢其維護期間的集合物件。 若要取得此物件，請使用 Get-CMCollection Cmdlet。

類型:IResultObject
別名:Collection, Site
Position:0
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-MaintenanceWindowName

指定目標集合上維護時段的名稱。 根據預設， Get-CMMaintenanceWindow 會 傳回所有維護時段。 使用此參數可將結果篩選為指定的視窗名稱。

您可以使用通配符：

  • *：多個字元
  • ?：單一字元
類型:String
別名:Name
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:True

輸入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

輸出

IResultObject[]

備註

如需此傳回物件及其屬性的詳細資訊，請 參閱SMS_ServiceWindow伺服器 WMI 類別。