Partilhar via

Set-SmaAdminConfiguration

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

Modifica as definições de configuração administrativa no SMA.

Sintaxe

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 definições de configuração de administração no Service Management Automation (SMA). 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 deseja compartilhar dados de diagnóstico e uso com a Microsoft
  • Tempo de drenagem
  • Política de execução de scripts
  • Tamanho da amostra da 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 expurgado

Exemplos

Exemplo 1: Modificar uma definição de configuração administrativa

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

Este comando define o tempo de drenagem para 60 segundos.

Parâmetros

-AuthenticationType

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

  • Básico
  • Mac OS

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

Tipo:String
Valores aceites:Basic, Windows
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ChartTimeSliceSampleSize

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

  • Pequeno
  • Média
  • Grande
  • ExtraGrande
Tipo:ChartTimeSliceSampleSize
Valores aceites:Small, Medium, Large, ExtraLarge
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Confirm

Solicita confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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.

Tipo:PSCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DrainTimeInSeconds

Especifica o tempo, em segundos, após o qual os hosts runbook worker encerram trabalhos em execução após uma parada de serviço de runbook worker ter sido iniciada. Enquanto o host está esgotando, os trabalhos existentes recebem os segundos de tempo de drenagem especificados para suspender ou encerrar naturalmente, e nenhum novo trabalho é aceito.

Tipo:Int32
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Force

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

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-MaxJobRecords

Especifica o número máximo de registros de trabalho que são mantidos.

Tipo:Int32
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Port

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

Tipo:Int32
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PurgeJobsOlderThanCountDays

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

Tipo:Int32
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ScriptExecutionPolicy

Determina a política de execução do 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 este parâmetro são:

  • Restrito. Não é possível executar scripts. Você pode usar o Windows PowerShell somente no modo interativo.
  • AllSigned. Você pode executar apenas scripts assinados por um editor confiável.
  • RemoteSigned. Os scripts baixados devem ser assinados por um editor confiável antes que você possa executá-los.
  • Sem restrições. Sem restrições; você pode executar todos os scripts do Windows PowerShell.
Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Telemetry

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

  • $True. Partilhe dados de diagnóstico e utilização com a Microsoft.
  • $False. Não partilhe dados de diagnóstico e utilização com a Microsoft.
Tipo:Boolean
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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://.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False