Set-SmaAdminConfiguration
修改 SMA 中的系統管理組態設定。
語法
Set-SmaAdminConfiguration
[-Telemetry <Boolean>]
[-DrainTimeInSeconds <Int32>]
[-ScriptExecutionPolicy <String>]
[-MaxJobRecords <Int32>]
[-PurgeJobsOlderThanCountDays <Int32>]
[-Force]
[-ChartTimeSliceSampleSize <ChartTimeSliceSampleSize>]
-WebServiceEndpoint <String>
[-Port <Int32>]
[-AuthenticationType <String>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
Set-SmaAdminConfiguration Cmdlet 會修改 Service Management Automation （SMA） 中的系統管理組態設定。 指定 Web 服務端點，並視需要指定埠。
使用此 Cmdlet 來設定下列設定：
- 是否要與Microsoft共用診斷和使用方式數據
- 清空時間
- 腳本執行原則
- 圖表時間配量範例大小
- 清除最舊工作之前要儲存的作業記錄上限
- 清除作業前的最長存留期
範例
範例 1：修改系統管理組態設定
PS C:\> Set-SmaAdminConfiguration -WebServiceEndpoint "https://contoso.com/app01" -DrainTimeInSeconds 60此命令會將清空時間設定為 60 秒。
參數
-AuthenticationType
指定驗證類型。 有效值為：
- 基本
- 窗戶
此參數的預設值為 Windows。 如果您使用基本身份驗證，則必須使用 Credential 參數來提供認證。
| 類型: | String |
| 接受的值: | Basic, Windows |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ChartTimeSliceSampleSize
指定圖表時間配量樣本大小。 有效值為：
- 小
- 中等
- 大
- ExtraLarge
| 類型: | ChartTimeSliceSampleSize |
| 接受的值: | Small, Medium, Large, ExtraLarge |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Confirm
在執行 Cmdlet 之前，提示您進行確認。
| 類型: | SwitchParameter |
| 別名: | cf |
| Position: | Named |
| 預設值: | False |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Credential
指定 SMA Web 服務的連線 PSCredential 物件。
若要取得認證物件，請使用 Get-Credential Cmdlet。
如需詳細資訊，請輸入 Get-Help Get-Credential。
| 類型: | PSCredential |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DrainTimeInSeconds
指定 Runbook 背景工作角色主機在啟動 Runbook 背景工作角色服務停止之後終止執行中作業的時間，以秒為單位。 當主機清空時，現有的作業會獲得指定的清空時間秒，以自然暫停或終止，而且不會接受任何新的作業。
| 類型: | Int32 |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Force
強制命令執行，而不要求使用者確認。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-MaxJobRecords
指定保留的作業記錄數目上限。
| 類型: | Int32 |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Port
指定 SMA Web 服務的埠號碼。
| 類型: | Int32 |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-PurgeJobsOlderThanCountDays
指定保留作業記錄的天數。 清除超過此值的作業。
| 類型: | Int32 |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ScriptExecutionPolicy
決定背景工作主機上 Runbook 作業的 Windows PowerShell 執行原則。
如需執行原則的相關信息，請輸入 Get-Help about_Execution_Policies。
此參數的有效值為：
- 限制。 您無法執行文稿。 您只能在互動式模式中使用 Windows PowerShell。
- AllSigned。 您只能執行由信任發行者簽署的腳本。
- RemoteSigned。 下載的腳本必須由受信任的發行者簽署，才能執行腳本。
- 無限制的。 沒有限制;您可以執行所有 Windows PowerShell 腳稿。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Telemetry
指出是否要與Microsoft共用診斷和使用方式數據。 此參數可接受的值為：
- $True。 使用 Microsoft 共用診斷和使用方式數據。
- $False。 請勿與Microsoft共享診斷和使用方式數據。
| 類型: | Boolean |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-WebServiceEndpoint
將端點指定為 SMA Web 服務的 URL。 您必須包含通訊協定，例如 http:// 或 https://。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-WhatIf
顯示 Cmdlet 執行時會發生什麼事。 Cmdlet 未執行。
| 類型: | SwitchParameter |
| 別名: | wi |
| Position: | Named |
| 預設值: | False |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |