Share via

Set-SmaAdminConfiguration

  • Referência
Módulo:
Microsoft.SystemCenter.ServiceManagementAutomation

Modifica as configurações administrativas no SMA.

Syntax

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

O cmdlet Set-SmaAdminConfiguration modifica as configurações de administração no SMA (Service Management Automation). Especifique o ponto de extremidade do serviço Web e, se necessário, uma porta.

Use este cmdlet para definir as seguintes configurações:

  • Se os dados de diagnóstico e uso devem ser compartilhados com a Microsoft
  • Tempo de drenagem
  • Política de execução de script
  • Tamanho da amostra de fatia de tempo do gráfico
  • O máximo de registros de trabalho a serem armazenados antes de limpar os trabalhos mais antigos
  • A idade máxima de um trabalho antes de ser limpo

Exemplos

Exemplo 1: Modificar uma configuração administrativa

PS C:\> Set-SmaAdminConfiguration -WebServiceEndpoint "https://contoso.com/app01" -DrainTimeInSeconds 60

Esse comando define o tempo de drenagem como 60 segundos.

Parâmetros

-AuthenticationType

Especifica o tipo de autenticação. Os valores válidos são:

  • Basic
  • Windows

O valor padrão para esse parâmetro é o Windows. Se você usar a autenticação básica, deverá fornecer credenciais usando o parâmetro Credencial .

Type:String
Accepted values:Basic, Windows
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ChartTimeSliceSampleSize

Especifica o tamanho da amostra de fatia de tempo do gráfico. Os valores válidos são:

  • Small
  • Médio
  • Grande
  • ExtraLarge
Type:ChartTimeSliceSampleSize
Accepted values:Small, Medium, Large, ExtraLarge
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Especifica um objeto PSCredential para a conexão com o serviço Web SMA. Para obter um objeto de credencial, use o cmdlet Get-Credential. Para obter mais informações, digite Get-Help Get-Credential.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DrainTimeInSeconds

Especifica o tempo, em segundos, após o qual os hosts de trabalho do runbook terminam os trabalhos em execução depois que uma parada de serviço do runbook Worker é iniciada. Enquanto o host está sendo esvaziado, os trabalhos existentes recebem os segundos de tempo de drenagem especificados para suspender ou encerrar naturalmente e nenhum novo trabalho é aceito.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Força o comando a ser executado sem solicitar a confirmação do usuário.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaxJobRecords

Especifica o número máximo de registros de trabalho retidos.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Port

Especifica o número da porta do serviço Web SMA.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PurgeJobsOlderThanCountDays

Especifica o número de dias em que o histórico de trabalho é mantido. Trabalhos mais antigos que esse valor são limpos.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ScriptExecutionPolicy

Determina a política de execução Windows PowerShell para trabalhos de runbook nos hosts de trabalho. Para obter informações sobre políticas de execução, digite Get-Help about_Execution_Policies. Os valores válidos para esse parâmetro são:

  • Restrito. Você não pode executar scripts. Você pode usar Windows PowerShell somente no modo interativo.
  • Allsigned. Você só pode executar scripts assinados por um publicador confiável.
  • Remotesigned. Os scripts baixados devem ser assinados por um editor confiável antes que você possa executar os scripts.
  • Irrestrito. Sem restrições; você pode executar todos os scripts Windows PowerShell.
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Telemetry

Indica se os dados de diagnóstico e uso devem ser compartilhados com a Microsoft. Os valores aceitáveis para esse parâmetro são:

  • $True. Compartilhe dados de diagnóstico e uso com a Microsoft.
  • $False. Não compartilhe dados de diagnóstico e uso com a Microsoft.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WebServiceEndpoint

Especifica o ponto de extremidade, como uma URL, do serviço Web SMA. Você deve incluir o protocolo, por exemplo, http:// ou https://.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False