Set-SmaAdminConfiguration
Modifica las opciones de configuración administrativa en SMA.
Sintaxis
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
El cmdlet Set-SmaAdminConfiguration modifica las opciones de configuración de administración en Service Management Automation (SMA). Especifique el punto de conexión del servicio web y, si es necesario, un puerto.
Use este cmdlet para configurar las opciones siguientes:
- Si se comparten datos de diagnóstico y uso con Microsoft
- Tiempo de purga
- Directiva de ejecución de scripts
- Tamaño de muestra del segmento de tiempo del gráfico
- Número máximo de registros de trabajo que se van a almacenar antes de purgar los trabajos más antiguos
- Antigüedad máxima de un trabajo antes de purgar
Ejemplos
Ejemplo 1: Modificar una configuración administrativa
PS C:\> Set-SmaAdminConfiguration -WebServiceEndpoint "https://contoso.com/app01" -DrainTimeInSeconds 60
Este comando establece el tiempo de purga en 60 segundos.
Parámetros
-AuthenticationType
Especifica el tipo de autenticación. Los valores válidos son:
- Básico
- Windows
El valor predeterminado de este parámetro es Windows.
Si usa la autenticación básica, debe proporcionar credenciales mediante el parámetro credential
Tipo: | String |
Valores aceptados: | Basic, Windows |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-ChartTimeSliceSampleSize
Especifica el tamaño de muestra del segmento de tiempo del gráfico. Los valores válidos son:
- Pequeño
- Medio
- Grande
- ExtraLarge
Tipo: | ChartTimeSliceSampleSize |
Valores aceptados: | Small, Medium, Large, ExtraLarge |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Confirm
Le pide confirmación antes de ejecutar el cmdlet.
Tipo: | SwitchParameter |
Alias: | cf |
Posición: | Named |
Valor predeterminado: | False |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Credential
Especifica un objeto PSCredential para la conexión al servicio web SMA.
Para obtener un objeto de credencial, use el cmdlet Get-Credential.
Para obtener más información, escriba Get-Help Get-Credential
.
Tipo: | PSCredential |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-DrainTimeInSeconds
Especifica el tiempo, en segundos, después del cual los hosts de runbook worker finalizan los trabajos en ejecución después de que se haya iniciado una detención del servicio de trabajo de runbook. Mientras el host está purgando, los trabajos existentes reciben el tiempo de purga especificado segundos para suspender o finalizar de forma natural, y no se aceptan nuevos trabajos.
Tipo: | Int32 |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Force
Obliga a que el comando se ejecute sin pedir confirmación del usuario.
Tipo: | SwitchParameter |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-MaxJobRecords
Especifica el número máximo de registros de trabajo que se conservan.
Tipo: | Int32 |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Port
Especifica el número de puerto del servicio web SMA.
Tipo: | Int32 |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-PurgeJobsOlderThanCountDays
Especifica el número de días que se mantiene el historial de trabajos. Los trabajos anteriores a este valor se purgan.
Tipo: | Int32 |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-ScriptExecutionPolicy
Determina la directiva de ejecución de Windows PowerShell para los trabajos de runbook en los hosts de trabajo.
Para obtener información sobre las directivas de ejecución, escriba Get-Help about_Execution_Policies
.
Los valores válidos para este parámetro son:
- Restringido. No se pueden ejecutar scripts. Solo puede usar Windows PowerShell en modo interactivo.
- AllSigned. Solo puede ejecutar scripts firmados por un publicador de confianza.
- RemoteSigned. Los scripts descargados deben estar firmados por un publicador de confianza para poder ejecutar los scripts.
- Irrestricto. Sin restricciones; puede ejecutar todos los scripts de Windows PowerShell.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Telemetry
Indica si se deben compartir datos de diagnóstico y uso con Microsoft. Los valores aceptables para este parámetro son:
- $True. Comparta datos de diagnóstico y uso con Microsoft.
- $False. No comparta datos de diagnóstico y uso con Microsoft.
Tipo: | Boolean |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-WebServiceEndpoint
Especifica el punto de conexión, como una dirección URL, del servicio web SMA. Debe incluir el protocolo, por ejemplo, http:// o https://.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-WhatIf
Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.
Tipo: | SwitchParameter |
Alias: | wi |
Posición: | Named |
Valor predeterminado: | False |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |