Set-CMSiteMaintenanceTask
Configuration Manager メンテナンス タスクの設定を変更します。
構文
Set-CMSiteMaintenanceTask
[-FixedRun]
[-RunIntervalMins <Int32>]
[-RunNow]
-SummaryTask <SummaryTask>
[-PassThru]
[-SiteCode <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMSiteMaintenanceTask
[-BeginTime <DateTime>]
[-DaysOfWeek <DaysOfWeek[]>]
[-DeleteOlderThanDays <Int32>]
[-DeviceName <String>]
[-EnableAlert <Boolean>]
[-Enabled <Boolean>]
-InputObject <IResultObject>
[-LatestBeginTime <DateTime>]
[-SiteBackupPath <String>]
[-SqlBackupPath <String>]
[-PassThru]
[-SiteCode <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMSiteMaintenanceTask
[-BeginTime <DateTime>]
[-DaysOfWeek <DaysOfWeek[]>]
[-DeleteOlderThanDays <Int32>]
[-DeviceName <String>]
[-EnableAlert <Boolean>]
[-Enabled <Boolean>]
[-LatestBeginTime <DateTime>]
-Name <String>
[-SiteBackupPath <String>]
[-SqlBackupPath <String>]
[-PassThru]
[-SiteCode <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMSiteMaintenanceTask
[-BeginTime <DateTime>]
[-DaysOfWeek <DaysOfWeek[]>]
[-DeleteOlderThanDays <Int32>]
[-DeviceName <String>]
[-EnableAlert <Boolean>]
[-Enabled <Boolean>]
[-LatestBeginTime <DateTime>]
-MaintenanceTask <MaintenanceTask>
[-SiteBackupPath <String>]
[-SqlBackupPath <String>]
[-PassThru]
[-SiteCode <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
Set-CMSiteMaintenanceTask コマンドレットは、Configuration Manager メンテナンス タスクの設定を変更します。 詳細については、「 メンテナンス タスク」を参照してください。
注:
PS XYZ:\>
など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。
例
例 1: 週に 1 回実行するようにメンテナンス タスクを設定する
この例では、Backup SMS Site Server という名前のメンテナンス タスクが、サイト コード CM1 を持つ Configuration Manager サイトで毎週金曜日に実行されることを指定します。
Set-CMSiteMaintenanceTask -SiteCode "CM1" -MaintenanceTaskName "Backup SMS Site Server" -DaysOfWeek Friday
例 2: バックアップ先を構成する
Set-CMSiteMaintenanceTask -Name $TaskName -SiteBackupPath "c:\site-backup" -SqlBackupPath "c:\sql-backup" -BeginTime (Get-Date) -DaysOfWeek Sunday,Monday -EnableAlert $true -Enabled $true
パラメーター
-BeginTime
メンテナンス タスクを開始する日時を指定します。
型: | DateTime |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
型: | SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DaysOfWeek
メンテナンス タスクを実行する各週の曜日を決定する日名の配列を指定します。
型: | DaysOfWeek[] |
指定可能な値: | Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DeleteOlderThanDays
期限切れのデータを削除するメンテナンス タスクの場合は、このパラメーターを使用して日数を指定します。
型: | Int32 |
Aliases: | DeleteOlderThan, DeleteThanOlderDays |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DeviceName
メンテナンス タスクを実行するデバイスの名前を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DisableWildcardHandling
このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-EnableAlert
タスクがサポートしている場合は、このパラメーターを $true
に設定して、タスクエラーのアラートを有効にします。
型: | Boolean |
Aliases: | EnabledAlert |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Enabled
Configuration Manager でメンテナンス タスクが有効かどうかを示します。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-FixedRun
このコマンドレットは、メンテナンス タスクを固定実行として変更することを示します。
型: | SwitchParameter |
Aliases: | FixedRunInterval, DisableFixedRunInterval |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ForceWildcardHandling
このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-InputObject
構成するメンテナンス タスク オブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMSiteMaintenanceTask コマンドレットを 使用します。
型: | IResultObject |
Aliases: | MaintenanceTaskObject |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-LatestBeginTime
メンテナンス タスクが実行される将来の日付と時刻を指定します。
型: | DateTime |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-MaintenanceTask
構成するメンテナンス タスクの名前を指定します。
型: | MaintenanceTask |
指定可能な値: | BackupSiteServer, CheckApplicationTitleWithInventoryInformation, ClearUndiscoveredClients, DeleteAgedApplicationRequestData, DeleteUnusedApplicationRevisions, DeleteAgedClientOperations, DeleteAgedCollectedFiles, DeleteAgedComputerAssociationData, DeleteAgedDeleteDetectionData, DeleteAgedDeviceWipeRecord, DeleteAgedDiscoveryData, DeleteAgedEnrolledDevices, DeleteAgedEndpointProtectionHealthStatusHistoryData, DeleteAgedDevicesManagedByTheExchangeServerConnector, DeleteAgedInventoryHistory, DeleteAgedLogData, DeleteAgedSoftwareMeteringData, DeleteAgedSoftwareMeteringSummaryData, DeleteAgedClientPresenceHistory, DeleteAgedNotificationTaskHistory, DeleteAgedReplicationTrackingData, DeleteAgedReplicationSummaryData, DeleteAgedStatusMessages, DeleteAgedThreatData, DeleteAgedUnknownComputers, DeleteAgedUserDeviceAffinityData, DeleteInactiveClientDiscoveryData, DeleteObsoleteAlerts, DeleteObsoleteClientDiscoveryData, DeleteObsoleteForestDiscoverySitesAndSubnets, EvaluateProvisionedAmtComputerCertificates, MonitorKeys, RebuildIndexes, SummarizeSoftwareMeteringFileUsageData, SummarizeInstalledSoftwareData, SummarizeSoftwareMeteringMonthlyUsageData, DeleteAgedDistributionPointUsageStats, DeleteAgedProxyTrafficData |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Name
構成するメンテナンス タスク オブジェクトの名前を指定します。
型: | String |
Aliases: | MaintenanceTaskName, TaskName, ItemName |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | True |
-PassThru
作業中のアイテムを表す オブジェクトを返します。 既定では、このコマンドレットは出力を生成しない場合があります。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-RunIntervalMins
型: | Int32 |
Aliases: | RunIntervalMinutes |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-RunNow
Configuration Manager でメンテナンス タスクをすぐに実行するには、このパラメーターを追加します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-SiteBackupPath
バージョン 2010 以降に適用されます。 [Backup Site Server]\(サイト サーバーのバックアップ\) タスクで、サイトのバックアップ先を指定します。 サイト サーバー コンピューター アカウントは、コピー先フォルダーを完全に制御する必要があります。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-SiteCode
サイト システムの役割をホストする Configuration Manager サイトのサイト コードを指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-SqlBackupPath
バージョン 2010 以降に適用されます。 [バックアップ サイト サーバー] タスクで、SQL バックアップ先を指定します。 サイト サーバー コンピューター アカウントは、コピー先フォルダーを完全に制御する必要があります。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-SummaryTask
概要メンテナンス タスクを指定します。
型: | SummaryTask |
指定可能な値: | UpdateApplicationCatalogTables |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
型: | SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
出力
IResultObject