共用方式為

Get-SCOMMaintenanceMode

  • 參考
模組:
OperationsManager

取得維護模式專案。

語法

Get-SCOMMaintenanceMode
   [[-Instance] <MonitoringObject[]>]
   [-History]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

Description

Get-SCOMMaintenanceMode Cmdlet 會取得維護模式專案。 您可以使用此 Cmdlet 將物件提供給 Set-SCOMMaintenanceMode Cmdlet，或單獨查看維護模式專案的詳細數據。

當資源處於維護模式時，System Center - Operations Manager 會隱藏警示、通知、規則、監視器、自動響應、狀態變更，以及新的警示。

當您單獨使用此 Cmdlet 時，它會呈現當地時間的資訊。 如果您將其結果傳送至 Format-Table Cmdlet，Cmdlet 會以國際標準時間 （UTC） 提供資訊。 如需 Format-Table的詳細資訊，請輸入 Get-Help Format-Table。

根據預設，此 Cmdlet 會使用與管理群組的作用中持續性連線。 使用 SCSession 參數來指定不同的持續性連線。 您可以使用 ComputerName 和 Credential 參數，建立與管理群組的暫時連線。 如需詳細資訊，請輸入 Get-Help about_OpsMgr_Connections。

範例

範例 1：取得所有作用中的維護模式專案

PS C:\>Get-SCOMMaintenanceMode

此命令會取得所有作用中的維護模式專案。 若要包含非使用中的專案，請指定 History 參數。

範例 2：取得指定網域的所有使用中維護模式專案

PS C:\>Get-SCOMMaintenanceMode -Instance (Get-SCOMClassInstance -Name "*.Contoso.com") -ErrorAction SilentlyContinue

此命令會取得 Contoso.com 網域中類別實例的所有使用中維護模式專案。 此命令會使用 Get-SCOMClassInstance Cmdlet 來取得包含 Contoso.com 的實例。

如果命令遇到缺少作用中維護模式項目的類別實例，ErrorAction 參數可讓命令繼續，而不會顯示錯誤。

範例 3：取得指定網域的所有維護模式專案

PS C:\>Get-SCOMClassInstance -Name "*.Contoso.com" | Get-SCOMMaintenanceMode -History

此命令會取得 Contoso.com 網域中的所有類別實例，然後使用管線運算符 （|） 將類別實例對象傳遞至 Get-SCOMMaintenanceMode Cmdlet。 此範例使用 History 參數;因此，命令會取得所有維護模式專案，包括非使用中的專案。

參數

-ComputerName

指定計算機名稱的陣列。 Cmdlet 會為這些電腦建立管理群組的暫時連線。 您可以使用 NetBIOS 名稱、IP 位址或完整功能變數名稱 （FQDN）。 若要指定本機計算機，請輸入計算機名稱、localhost 或點 （.）。

System Center 資料存取服務必須在電腦上執行。 如果您未指定計算機，Cmdlet 會使用計算機進行目前的管理群組連線。

類型:String[]
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Credential

指定管理群組連線 PSCredential 物件。 若要取得 PSCredential 物件，請使用 get-Credential Cmdlet 。 如需詳細資訊，請輸入 Get-Help Get-Credential。

如果您在 ComputerName 參數中指定電腦，請使用可存取該電腦的帳戶。 預設值為目前的使用者。

類型:PSCredential
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-History

表示 Cmdlet 會取得所有維護模式專案，包括非使用中專案。 如果沒有此參數，Cmdlet 只會取得使用中的維護模式專案。

類型:SwitchParameter
Position:2
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Instance

指定表示實例的監視物件陣列。 若要取得監視物件，請使用 Get-SCOMClassInstance Cmdlet。

此參數也接受群組物件。 若要取得群組物件，請使用 get-SCOMGroup Cmdlet 。

類型:MonitoringObject[]
Position:1
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-SCSession

指定 connection 物件的 陣列。 若要取得 Connection 物件，請使用 Get-SCOMManagementGroupConnection Cmdlet。

類型:Connection[]
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False