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>]
说明
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
此参数的默认值为 Windows。 如果使用基本身份验证,则必须使用 Credential 参数提供凭据。
Type: | String |
Accepted values: | Basic, Windows |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ChartTimeSliceSampleSize
指定图表时间切片样本大小。 有效值为:
- 小型
- 中型
- 大型
- 超大型
Type: | ChartTimeSliceSampleSize |
Accepted values: | Small, Medium, Large, ExtraLarge |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
提示你在运行 cmdlet 之前进行确认。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
指定连接到 SMA Web 服务的 PSCredential 对象。
若要获取凭据对象,请使用 Get-Credential cmdlet。
要了解详情,请键入 Get-Help Get-Credential
。
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DrainTimeInSeconds
指定在启动 Runbook 辅助角色服务停止后 Runbook 辅助角色主机终止正在运行的作业的时间(以秒为单位)。 主机正在清空时,会为现有作业提供指定的排空时间秒以自然挂起或终止,并且不接受任何新作业。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
强制运行命令而不要求用户确认。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MaxJobRecords
指定保留的最大作业记录数。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Port
指定 SMA Web 服务的端口号。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PurgeJobsOlderThanCountDays
指定保留作业历史记录的天数。 清除大于此值的作业。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ScriptExecutionPolicy
确定辅助角色主机上 Runbook 作业的Windows PowerShell执行策略。
有关执行策略的信息,请键入 Get-Help about_Execution_Policies
。
此参数的有效值是:
- 受限。 无法运行脚本。 只能在交互模式下使用Windows PowerShell。
- AllSigned。 只能运行受信任的发布者签名的脚本。
- RemoteSigned。 下载的脚本必须由受信任的发布者签名,然后才能运行脚本。
- Unrestricted。 无限制;可以运行所有Windows PowerShell脚本。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Telemetry
指示是否与 Microsoft 共享诊断和使用情况数据。 此参数的可接受值为:
- $True。 与 Microsoft 共享诊断和使用情况数据。
- $False。 不要与 Microsoft 共享诊断和使用情况数据。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WebServiceEndpoint
将终结点指定为 SMA Web 服务的 URL。 必须包括协议,例如 http:// 或 https://。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
显示在此 cmdlet 运行的情况下将会发生什么。 此 cmdlet 未运行。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |