Compartilhar via

Set-SmaAdminConfiguration

Módulo:
Microsoft.SystemCenter.ServiceManagementAutomation Module

Modifica as configurações administrativas no SMA.

Sintaxe

Default (Padrão) 

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:

  • Básico
  • Windows

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Valores aceitos:Basic, Windows
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ChartTimeSliceSampleSize

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

  • Pequeno
  • Média
  • Grande
  • ExtraLarge

Propriedades do parâmetro

Tipo:ChartTimeSliceSampleSize
Valor padrão:None
Valores aceitos:Small, Medium, Large, ExtraLarge
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Confirm

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:PSCredential
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:Int32
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Force

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-MaxJobRecords

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

Propriedades do parâmetro

Tipo:Int32
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Port

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

Propriedades do parâmetro

Tipo:Int32
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:Int32
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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ê só pode executar scripts assinados por um editor 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 do Windows PowerShell.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Telemetry

Indica se os dados de diagnóstico e de uso devem ser compartilhados com a Microsoft. Os valores aceitáveis para este 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.

Propriedades do parâmetro

Tipo:Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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://.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-WhatIf

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.