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:\>)。 詳細については、「作業の 開始」を参照してください。

例

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

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

-MaintenanceWindowName

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

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

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

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

IResultObject[]

メモ

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