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

説明

このコマンドレットを使用して、指定したコレクションのメンテナンス ウィンドウを取得します。 結果を特定のメンテナンス ウィンドウにフィルター処理することもできます。

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

注意

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

例

例 1: コレクションの有効なメンテナンス ウィンドウを ID で取得する

このコマンドは、指定したコレクションに対して有効になっているメンテナンス ウィンドウを取得します。

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

メンテナンス ウィンドウのクエリを実行するコレクション ID を指定します。 この ID は、たとえば、標準のコレクション ID です XYZ0003F 。

Type:String
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-CollectionName

メンテナンス ウィンドウのクエリを実行するコレクション名を指定します。

Type:String
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DisableWildcardHandling

このパラメーターは、ワイルドカード文字をリテラル文字値として扱います。 ForceWildcardHandling と組み合わせは使用できない。

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作を引き起こします (推奨されません)。 DisableWildcardHandling と組み合わせは使用できない。

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-InputObject

メンテナンス ウィンドウのクエリを実行するコレクション オブジェクトを指定します。 このオブジェクトを取得するには 、Get-CMCollection コマンドレットを使用 します。

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

対象のコレクションのメンテナンス ウィンドウの名前を指定します。 既定では、Get-CMMaintenanceWindow は、すべてのメンテナンス ウィンドウを返します。 このパラメーターを使用して、指定したウィンドウ名に結果をフィルター処理します。

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

  • *: 複数の文字
  • ?: 1 文字
Type:String
Aliases:Name
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:True

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

IResultObject[]

メモ

この戻り値オブジェクトとそのプロパティの詳細については、「SMS_ServiceWindow WMI クラス」を参照してください。