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 でメンテナンス期間を使用する方法」を参照してください。

注:

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

例

例 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 は、 XYZ0003Fなど、標準のコレクション ID です。

型:String
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-CollectionName

メンテナンス期間を照会するコレクション名を指定します。

型:String
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DisableWildcardHandling

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

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-InputObject

メンテナンス期間を照会するコレクション オブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMCollection コマンドレットを 使用します。

型:IResultObject
Aliases:Collection, Site
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-MaintenanceWindowName

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

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

  • *: 複数の文字
  • ?: 1 文字
型:String
Aliases:Name
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:True

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

IResultObject[]

メモ

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