Get-CMMaintenanceWindow

  • 參考
模組:
ConfigurationManager

取得集合的維護期間。

Syntax

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 來取得指定集合的維護期間。 您也可以將結果篩選到特定的維護期間。

如需維護期間的詳細資訊，請參閱如何在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 。

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

-DisableWildcardHandling

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

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

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

您可以使用萬用字元：

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

輸入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

輸出

IResultObject[]

備註

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