Datos de salida de Runbook
Presenta los resultados de runbook como tablas ordenables y filtrables en el RealmJoin Portal, y escribe runbooks que emitan objetos estructurados.
Resumen
Datos de salida es el equivalente estructurado de la Consola pestaña de una página de trabajo de runbook. La consola conserva el flujo de texto sin formato, línea por línea, de una ejecución; Datos de salida representa los objetos que esa misma ejecución emitió como tablas. Los valores largos, como GUID, se muestran completos en lugar de truncarse a … por el formateador de consola de PowerShell, y los conjuntos de resultados anchos siguen siendo legibles en lugar de ajustarse en varias líneas.
Características clave:
Sin configuración, sin permisos adicionales — la pestaña está disponible para cada runbook que emite objetos. No hay que habilitar nada, y quién puede iniciar un runbook no se ve afectado.
Objetos en lugar de texto preformateado — las tablas se construyen a partir de lo que el runbook escribe en el flujo de salida. Un runbook que preformatea sus resultados con
Format-Tableno produce Datos de salida en absoluto.Tablas interactivas — cada tabla se puede ordenar, filtrar, paginar y exportar a Excel o CSV independientemente de las demás.
Los datos anidados siguen siendo inspeccionables — los objetos y matrices dentro de una celda se pueden expandir en lugar de aplanarse en una sola cadena ilegible.
La pestaña Consola no cambia — la salida de texto completa sigue disponible y se puede copiar, que es lo que normalmente necesita un servicio o un ticket ITIL.
Inicio rápido
El runbook mínimo viable emite un objeto marcador con el nombre de la tabla, y luego los datos:
[PSCustomObject]@{ RjTableTitle = 'Non-compliant devices' }
Write-Output $nonCompliantDevicesEsto produce una tabla titulada Dispositivos no conformes en la pestaña Datos de salida — una fila por dispositivo, una columna por propiedad — además de una línea de resumen compacta en la pestaña Consola que enlaza con ella.
Leer Datos de salida en el portal
Abra un trabajo desde Registros de runbook y cambie a la Datos de salida pestaña. Consulte Detalles del trabajo del runbook para ver las demás pestañas de esa página.
Tablas y navegación
Cada conjunto de objetos que emite un runbook se convierte en una tabla. Una tabla contiene:
Un título — ya sea el nombre que asignó el runbook (véase Nombrar una tabla) o el valor alternativo
Tabla 1,Tabla 2y así sucesivamente.Una entrada en la barra lateral — cada tabla aparece en la izquierda; al hacer clic en un título se va a ella.
Un contador de filas —
12 / 340 filasmuestra cuántas filas coinciden con el filtro actual de entre el total de la tabla.
Filtro
El Filtrar… el cuadro encima de una tabla conserva solo las filas que contienen el texto introducido. El filtro es una coincidencia de subcadena sin distinción entre mayúsculas y minúsculas en todas las columnas de esa tabla. Cada tabla se filtra de forma independiente.
Ordenar
Al hacer clic en el encabezado de una columna se ordena por esa columna; al volver a hacer clic se invierte la dirección. Una flecha (▲ / ▼) marca la columna activa. La ordenación distingue el tipo:
Números
Numérico — 2 antes de 10.
Fechas
Cronológico.
Todo lo demás
Alfabético, sin distinción entre mayúsculas y minúsculas.
Las celdas vacías se ordenan primero.
Paginación
Las tablas se paginan de 50 filas, con un paginador debajo de la tabla. El filtro y la ordenación se aplican siempre a toda la tabla, no solo a la página que se muestra actualmente.
Objetos y listas anidados
Una celda que contiene un objeto o matriz anidado no se aplana en texto ilegible:
La celda muestra un caret (
▸). Al hacer clic se expande ese objeto o matriz en línea debajo de la fila.El encabezado de la columna lleva una flecha de expansión. Al hacer clic se expande toda la columna en su propia tabla: el valor anidado de cada fila padre se desglosa en filas, y una columna de referencia enlaza de vuelta con el número de fila padre. La nueva tabla se agrega al final de la página y a la barra lateral, y se puede filtrar, ordenar y exportar como cualquier otra.
Exportar
Cada tabla tiene su propio Exportar a Excel (.xlsx) y Exportar a CSV botones. Las exportaciones respetan el filtro activo — solo se escriben las filas coincidentes — y usan el título de la tabla como nombre de archivo. Exportar a Excel también usa el título como nombre de la hoja y falla para títulos de más de 31 caracteres; véase Nombrar una tabla.
La exportación desde el portal cubre el caso ad hoc. Para los archivos de informe que se supone que un runbook debe entregar por sí mismo — como adjunto de correo o como enlace de descarga — créelos en el runbook en su lugar, con Export-RjRbXlsx y los ayudantes de entrega.
Pestaña Consola
Cuando un trabajo emitió tablas, la Consola pestaña muestra una vista comprimida de forma predeterminada. Las tablas se dibujan al estilo de PowerShell pero truncadas, de modo que las líneas de estado sigan siendo legibles y un runbook que emitió cientos de objetos no inunde la página. En lugar de cada tabla, la consola muestra un cuadro de resumen:
Las tablas emitidas en sucesión directa comparten un solo cuadro:
→ "Datos de salida" tab es un enlace y cambia a la tabla correspondiente.
Dos botones controlan la vista:
Mostrar salida completa — cambia al texto completo, sin truncar.
Mostrar tablas comprimidas — volver.
Copiar al portapapeles siempre copia la salida sin procesar completa, independientemente de la vista que se muestre.
Emitir Datos de salida desde un runbook
La pestaña se construye a partir de los objetos que emite un runbook. Por tanto, las tablas limpias requieren que el runbook escriba objetos en lugar de preformatearlos como texto.
Emita objetos, no texto formateado
Nunca canalice la salida a través de
Format-TableoFormat-List. Esos cmdlets emiten registros del motor de formato, no datos. El portal los detecta y los oculta, y muestra una sugerencia de que la salida estaba mal formateada. Lo mismo se aplica allí donde PowerShell da formato automáticamente a un resultado porque se escribió en el host en lugar de en el flujo de salida.
Format-* cmdlets solo controlan la presentación. Lo para lo que se usaban tiene un equivalente en datos que Datos de salida puede representar — seleccionar columnas en particular es lo que Select-Object hace:
$devices | Format-Table Name, Id
$devices | Select-Object Name, Id
$devices | Format-Table -AutoSize
Write-Output $devices
$devices | Format-List
Write-Output $devices
Select-Object Name, Id produce la misma selección de columnas que Format-Table Name, Id habría mostrado — pero emite objetos, por lo que las columnas llegan a la pestaña Datos de salida en lugar de descartarse como registros de formato:
Las propiedades seleccionadas son exactamente las columnas de la tabla resultante: Nombre, Id, OperatingSystem y LastSeen, una fila por dispositivo.
Cómo los objetos se convierten en tablas
Un objeto
Una fila — sus propiedades se convierten en las columnas.
Objetos consecutivos con las mismas propiedades
Una tabla.
Un objeto con un conjunto diferente de propiedades
Empieza una nueva tabla.
Un único valor simple (cadena, número)
Una línea de texto en la consola, no una tabla.
Una línea que comienza con ## seguida de un espacio
Un encabezado en la vista de consola.
Un objeto o matriz anidado
JSON en la celda, expandible en la cuadrícula — véase Objetos y listas anidados.
Nombrar una tabla
De forma predeterminada, las tablas se etiquetan Tabla 1, Tabla 2 y así sucesivamente. Para dar a una tabla un nombre significativo, el runbook emite un objeto marcador justo antes de los datos. El marcador es un objeto de una sola propiedad cuya única propiedad es RjTableTitle:
La tabla siguiente se titula entonces Dispositivos no conformes — en el encabezado, en la barra lateral y en el nombre del archivo exportado.
El propio marcador se consume. No aparece ni como fila ni como línea de consola.
El nombre de la propiedad es no distingue mayúsculas y minúsculas —
RjTableTitle,rjtabletitley cualquier otra combinación de mayúsculas y minúsculas funciona.Una en blanco se ignora, por lo que un marcador vacío no puede borrar un nombre existente.
El nombre se aplica a la siguiente tabla emitida, incluso cuando hay líneas de estado entre medias.
Repetir el patrón nombra varias tablas en una sola ejecución:
Comportamiento y limitaciones
Trabajos archivados
Datos de salida está disponible solo para ejecuciones en vivo. Un trabajo archivado muestra "No se pueden recuperar datos estructurados de una ejecución archivada." — esos resultados deben leerse desde la pestaña Consola. Consulte Registros de runbook para ver la diferencia entre los registros de trabajos recientes y archivados.
Runbooks sin salida estructurada
"No hay datos de salida estructurados de este runbook." significa que no se emitió nada con forma de tabla. Si el mensaje va acompañado de un icono de información, el runbook envió registros de formato de PowerShell en lugar de datos — véase Emita objetos, no texto formateado.
Valores únicos
Un runbook que emite un único valor simple — una cadena de estado, un recuento — conserva ese valor como una línea de texto en la pestaña Consola. Solo los objetos se convierten en tablas, por lo que los mensajes de progreso y estado no se transforman cada uno en una tabla de una sola fila.
Véase también
Detalles del trabajo del runbook — la página del trabajo que aloja las pestañas Consola y Datos de salida.
Export-RjRbXlsx — escriba los mismos objetos en un libro de Excel con estilo para entregarlo fuera del portal.
Send-RjRbReportEmail — entregue por correo electrónico los resultados del informe a los administradores.
Interactuar con los runbooks — lea la salida del trabajo de forma programática a través de la API de RealmJoin.
Última actualización
¿Te fue útil?