共用方式為


設定及使用適用於 Windows PowerShell 的 Service Manager Cmdlet

本文提供 Windows PowerShell 命令行介面的 Service Manager Cmdlet 簡介。

您必須先將執行原則設定為 RemoteSigned,才能在 Service Manager 的 Windows PowerShell 命令行介面中執行任何命令。 您必須先手動匯入數據倉儲 Cmdlet 模組,才能執行數據倉儲 Cmdlet。

Service Manager Cmdlet 會在下列兩個模組中實作:

  • System.Center.Service.Manager。 每次開啟 Service Manager Windows PowerShell 工作階段時,就會自動匯入此模組。

  • Microsoft.EnterpriseManagement.Warehouse.Cmdlet。 此模組必須手動匯入。

開始使用 Service Manager Cmdlet

Windows PowerShell 是 Windows 命令行殼層,其中包含互動式提示和腳本環境。 Windows PowerShell 使用 Cmdlet 來操作 Windows PowerShell 物件。 Service Manager 包含許多 Cmdlet,可讓您在不使用 Service Manager 控制台的情況下執行各種 Service Manager 相關工作。 例如,您可以使用 Import-SCSMManagementPack Cmdlet 匯入管理元件。

Service Manager Cmdlet 會在下列兩個模組中傳遞。 在 Service Manager 中,這些 Cmdlet 模組不會安裝在 $env:PSModulePath 變數中列出的一般路徑中。 因此,如果您執行 Get-Module -List Cmdlet,就不會列出 Service Manager 模組。

  • 系統管理員 Cmdlet:System.Center.Service.Manager 模組,其中包含常見系統管理工作所需的 Cmdlet。

  • 數據倉儲 Cmdlet:Microsoft.EnterpriseManagement.Warehouse.Cmdlet 模組,其中包含在 Service Manager 數據倉儲上操作所需的 Cmdlet。

數據倉儲 Cmdlet 會在數據倉儲資料庫上運作,而且您可以在 Service Manager 管理伺服器或數據倉儲管理伺服器上執行它們。

從 Windows PowerShell 命令傳回的數據可能包含比預設 Windows PowerShell 命令視窗中顯示更多的資訊。 建議增加命令視窗的寬度:以滑鼠右鍵按兩下標題列,選取 [屬性],然後在 [版面配置] 索引標籤中,將 [螢幕緩衝區大小] 寬度設定為120。

下列程式可協助您開始使用 Service Manager Cmdlet。

從 Service Manager 控制台開啟 Service Manager Windows PowerShell 會話

  1. 在 Service Manager 控制台中,選取 [ 系統管理]。

  2. 在 [ 工作] 窗格中,選取 [ 啟動 PowerShell 會話]。

系統管理員 Cmdlet 模組會自動在此工作階段中預先匯入。

從 Windows 開啟 Service Manager Windows PowerShell 會話

  1. 在裝載 Service Manager 管理伺服器的電腦上,選取 任務欄上的 [開始]、指向 [所有程式],然後選取 [Microsoft System Center]。

  2. 選取 [Service Manager <版本>],然後選取 [Service Manager Shell]。

系統管理員 Cmdlet 模組會自動在此工作階段中預先匯入。

列出所有 Service Manager Cmdlet

  1. 開啟 Service Manager Windows PowerShell 工作階段。

  2. 若要列出系統管理員模組中包含的 Cmdlet,請在 Service Manager Windows PowerShell 會話中輸入下列命令,然後按 ENTER:

    Get-Command -module System.Center.Service.Manager
    
  3. 若要列出數據倉儲模組中包含的 Cmdlet,請在 Service Manager Windows PowerShell 會話中輸入下列命令,然後按 ENTER:

    Get-Command -module Microsoft.EnterpriseManagement.Warehouse.Cmdlets
    

取得 Cmdlet 的說明

  1. 開啟 Service Manager Windows PowerShell 工作階段。

  2. 您現在可以存取現用的說明,也可以使用 -online 參數來存取最新的線上說明:

    • On-the-the-box Help:輸入下列命令。 將 Cmdlet-name 取代為您想要取得協助的 Cmdlet 名稱,例如 Import-SCSMManagementPack

      Get-help <cmdlet-name> -detailed
      
    • 在線、最新說明:輸入下列命令,然後按 ENTER:

      Get-help <cmdlet-name> -online
      

      此命令會 -online 使用 參數來存取 Cmdlet 的最新在線說明。 它會開啟網頁瀏覽器,並顯示 Cmdlet-name 可用的在線說明。

Service Manager Cmdlet 的清單

Service Manager 支援下列 Windows PowerShell Cmdlet,這些 Cmdlet 會在兩個模組中實作:系統管理員模組和數據倉儲模組。

System.Center.Service.Manager 模組中的系統管理員 Cmdlet

指令程式 描述
Add-SCSMAllowListClass 將指定的類別新增至 Service Manager Operations Manager CI 連接器在同步處理期間使用的類別允許清單。
Export-SCSMManagementPack 將管理元件導出為有效的 XML 格式檔案,以供稍後匯入 Service Manager 或 Operations Manager。
Get-SCSMAllowList 擷取 Service Manager Operations Manager CI 連接器在同步處理期間使用的類別允許清單。
Get-SCSMAnnouncement 擷取 Service Manager 中定義的公告。
Get-SCSMChannel 擷取 Service Manager 中定義的電子郵件通知通道。
Get-SCSMClass 擷取類別。
Get-SCSMClassInstance 擷取類別實例物件。
Get-SCSMCommand
Get-SCSMConnector 擷取 Service Manager 中定義的連接器。
Get-SCSMDCMWorkflow 擷取 Service Manager 中定義的所需組態管理工作流程清單。
Get-SCSMDeletedItem 擷取已在 Service Manager 中標示要刪除的專案。
Get-SCSMDiscovery 從 Operations Manager 和 Service Manager 擷取探索資訊。
Get-SCSMEmailTemplate 擷取 Service Manager 中定義的電子郵件範本。
Get-SCSMEmailTemplateContent 擷取 Service Manager 電子郵件範本的內容。
Get-SCSMGroup 從 Operations Manager 和 Service Manager 擷取群組。
Get-SCSMManagementGroupConnection 擷取所有管理群組連線,包括這些連線的IsActive狀態。 只有一個聯機會將其IsActive狀態設定為True,因為隨時只能有一個連線作用中。
Get-SCSMManagementPack 擷取代表已匯入之管理元件的物件。
Get-SCSMObjectTemplate 擷取物件範本。
Get-SCSMQueue 擷取 Service Manager 中定義的佇列。
Get-SCSMRelationship 從 Operations Manager 和 Service Manager 擷取關聯性對象的相關信息。
Get-SCSMRelationshipInstance 從 Operations Manager 和 Service Manager 擷取關聯性的實例。
Get-SCSMRunAsAccount 擷取執行身分帳戶。
Get-SCSMSetting 擷取 System Center Service Manager 的組態設定。
Get-SCSMSubscription 擷取 Service Manager 中設定的訂用帳戶。
Get-SCSMTask 擷取 Service Manager 中定義的工作。
Get-SCSMUser 擷取 Service Manager 中定義的使用者。
Get-SCSMUserRole 擷取 Service Manager 中定義的使用者角色。
Get-SCSMView 擷取 Service Manager 中定義的檢視。
Get-SCSMWorkflow 擷取 Service Manager 工作流程的組態資訊。
Get-SCSMWorkflowStatus 擷取 Service Manager 中工作流程的狀態。
Import-SCSMInstance 將對象和關聯性從逗號分隔值 (.csv) 檔案匯入 Service Manager。
Import-SCSMManagementPack 匯入管理元件。
New-SCOrchestratorConnector 建立新的 Service Manager Orchestrator 連接器。
New-SCRelationshipInstance 建立關聯性的實例。
New-SCSMADConnector 建立新的 Active Directory 連接器。
New-SCSMAlertRule 建立警示規則,以與 Service Manager 中的 Operations Manager 警示連接器搭配使用。
New-SCSMAnnouncement 在 Service Manager 中建立新的公告。
New-SCSMClassInstance 將類別實例加入至資料庫。
New-SCSMCMConnector 在 Service Manager 中建立新的 Configuration Manager 連接器。
New-SCSMDCMWorkflow 在 Service Manager 中建立新的所需組態管理工作流程。
New-SCSMEmailTemplate 建立 Service Manager 的新電子郵件範本。
New-SCSMManagementGroupConnection 為指定的管理群組建立新的連線。 建立的最新管理群組連線是 Get- Cmdlet 預設使用的作用中聯機,其中您未指定 ComputerNameCredential,或 SCSession 參數。
New-SCSMManagementPack 建立新的管理元件。
New-SCSMManagementPackBundle 組合個別管理元件及其資源,建立新的管理元件套件組合。
New-SCSMOMAlertConnector 在 Service Manager 中建立新的 Operations Manager 警示連接器。
New-SCSMOMConfigurationItemConnector 在 Service Manager 中建立新的 Operations Manager CI 連接器。
New-SCSMRunAsAccount 建立新的執行身分帳戶。
New-SCSMSubscription 在 Service Manager 中建立新的訂用帳戶。
New-SCSMUserRole 在 Service Manager 中建立新的使用者角色。
New-SCSMWorkflow 在 Service Manager 中建立新的工作流程。
New-SCVMMConnector 建立新的 Service Manager Virtual Machine Manager 連接器。
Protect-SCSMManagementPack 密封管理元件,以防止修改它。
Remove-SCSMAllowListClass 從 Service Manager 同步處理期間 Operations Manager CI 連接器所使用的類別清單移除指定的類別。
Remove-SCSMAnnouncement 從 Service Manager 移除公告。
Remove-SCSMClassInstance 拿掉組態項目物件的實例。
Remove-SCSMConnector 從 Service Manager 移除連接器。
Remove-SCSMDCMWorkflow 從 Service Manager 移除所需的組態管理工作流程。
Remove-SCSMEmailTemplate 從 Service Manager 移除電子郵件範本。
Remove-SCSMManagementGroupConnection 拿掉管理群組連線。
Remove-SCSMManagementPack 拿掉管理元件。
Remove-SCSMRunAsAccount 拿掉執行身分帳戶。
Remove-SCSMSubscription 從 Service Manager 移除訂用帳戶。
Remove-SCSMUserRole 從 Service Manager 移除使用者角色。
Remove-SCSMWorkflow 從 Service Manager 移除工作流程。
Reset-SCSMAllowList 將 Service Manager 中 Operations Manager CI Connector 所使用的 [允許] 類別清單重設為預設的 [允許] 列表。
Restore-SCSMDeletedItem 還原先前在 Service Manager 中刪除的專案。
Set-SCSMChannel 設定 Service Manager 中電子郵件通知通道的屬性。
Set-SCSMManagementGroupConnection 將指定的連接設定為使用中的連接。 使用中連接是當您執行 Get- Cmdlet 時隱含使用的連線,而不指定 -ComputerName-Credential-SCSession 參數。 任何時間只能使用一個連線,而且根據預設,使用中聯機是使用 New-SCManagementGroupConnection Cmdlet 所建立的最後一個連線。
Start-SCSMConnector 啟動 Service Manager 連接器。
Test-SCSMManagementPack 測試管理元件的有效性。
Update-SCSMAnnouncement 更新 Service Manager 公告的屬性。
Update-SCSMClassInstance 更新組態項目類別實例的屬性值。
Update-SCSMConnector 更新 Service Manager 連接器的屬性。
Update-SCSMDCMWorkflow 更新所需組態管理工作流程的屬性。
Update-SCSMEmailTemplate 更新電子郵件範本的屬性。
Update-SCSMRunAsAccount 更新與執行身分帳戶相關聯的認證。
Update-SCSMSetting 更新 Service Manager 的組態設定。
Update-SCSMSubscription 更新 Service Manager 中的訂用帳戶屬性。
Update-SCSMUserRole 設定 Service Manager 使用者的 UserRole 屬性。
Update-SCSMWorkflow 更新工作流程屬性。

Microsoft.EnterpriseManagement.Warehouse.Cmdlet 模組中的數據倉儲 Cmdlet

指令程式 描述
Disable-SCDWJob 停用數據倉儲作業以防止它執行。
Disable-SCDWJobSchedule Disable-SCDWJobSchedule Cmdlet 會停用數據倉儲作業排程,這會導致作業排程停止起始作業。 如果先前已啟用作業排程,停用作業排程會保留作業排程設定。 若要修改作業排程設定,請執行 Set-SCDWJobSchedule Cmdlet。
Disable-SCDWSource 啟用與指定數據源相關聯的所有作業。
Enable-SCDWJob 啟用數據倉儲作業,使其可以根據排程執行。
Enable-SCDWJobSchedule Enable-SCDWJobSchedule Cmdlet 可讓數據倉儲系統管理員啟用作業排程,讓作業根據指定的排程執行。 若要停用作業排程,請使用 Disable-SCDWJobSchedule Cmdlet。
Enable-SCDWSource 啟用與指定數據源相關聯的所有作業。
Get-SCDWEntity 取得存在於數據倉儲中的事實數據表、維度、數據表和外線清單。
Get-SCDWJob 取得所有週期性作業的作業狀態,包括擷取、轉換和載入 (ETL) 作業。
Get-SCDWJobModule 傳回指定作業的詳細資訊。 這項資訊包括作業模組,這些模組會作為作業的一部分執行。
Get-SCDWJobSchedule Get-SCDWJobSchedule Cmdlet 會顯示數據倉儲作業的排程資訊。 您可以使用 JobName 參數來指定要顯示排程資訊的作業。 否則, Get-SCDWJobSchedule Cmdlet 會顯示所有數據倉儲作業的排程資訊。
Get-SCDWModule
Get-SCDWRetentionPeriod 數據倉儲會在預先定義的保留期間之後清理數據列。 此 Cmdlet 會在幾分鐘內提供特定實體的保留期間。 如果未提供任何實體,則會傳回所有實體的預設保留期間。
Get-SCDWSource 啟用與指定數據源相關聯的所有作業。
Get-SCDWSourceType 取得可註冊至數據倉儲的數據源類型。
Get-SCDWWatermark 取得指定作業模組的最新浮浮浮浮水印。
New-SCDWSourceType 若要向數據倉儲註冊來源,必須先向數據倉儲註冊數據源類型。 此 Cmdlet 可藉由匯入適當的管理元件並執行適當的組態變更,來協助註冊新的數據源類型。
Register-SCDWSource 向數據倉儲註冊數據源類型的實例,例如 Service Manager、Operations Manager 和 Configuration Manager。
Set-SCDWJobSchedule 設定數據倉儲作業的排程。
Set-SCDWRetentionPeriod 為特定數據倉儲資料庫中的特定事實數據表設定以分鐘為單位的數據保留期間,或設定資料庫內事實數據表的預設值。
Set-SCDWSource 更新可以針對數據源實例填入的類別和關聯性定義。
Set-SCDWWatermark - 設定後續數據處理應繼續的水位線。
Start-SCDWJob 啟動數據倉儲作業。
Unregister-SCDWManagememtPack
Unregister-SCDWSource 從數據倉儲取消註冊數據源。

下一步