Share via

設定和使用 Service Manager Cmdlet Windows PowerShell

  • 發行項

重要

此版本的 Service Manager 已終止支援。 建議您升級至 Service Manager 2022。

本文提供 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 參數來存取最新的線上說明：

    • 現用說明：輸入下列命令。 以您想要取得協助的 Cmdlet 名稱取代 Cmdlet-name ，例如 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

Cmdlet Description
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 預設使用的作用中聯機，其中您未指定 ComputerName 和 Credential，或 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 從 Operations Manager CI 連接器在同步處理期間在同步處理期間使用的類別清單移除指定的類別 Service Manager。
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 將 Operations Manager CI Connector 在 Service Manager 中使用的 [允許] 類別清單重設為預設的 [允許] 清單。
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 更新工作流程屬性。

Data Warehouse Microsoft.EnterpriseManagement.Warehouse.Cmdlet 模組中的 Cmdlet

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

下一步