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