Powershell: Opciones-NinjaTag

Tema

En este artículo se explica cómo utilizar Options-NinjaTag para obtener una lista de todas las etiquetas del sistema posibles para un dispositivo.

Entorno

• NinjaOne
• Microsoft PowerShell

Descripción

El cmdlet Options-NinjaTag recupera una lista de todas las etiquetas del sistema que se pueden asignar a un dispositivo
. Este cmdlet debe ejecutarse dentro de un script de automatización de Ninja para acceder a la información de las etiquetas.

Sintaxis

Options-NinjaTag [<CommonParameters>]

Ejemplos

Ejemplo 1: Recuperación desde un script de automatización

PS C:> Options-NinjaTag
IIS
Stuff
Servidor de fax
Deduplicación de datos
Servidor de archivos
ADDS
DNS
Elegible para ESU
Replicación DFS

En la salida se enumeran todas las etiquetas del sistema posibles para un dispositivo. Las etiquetas reales asignadas al dispositivo se pueden recuperar mediante el cmdlet Get-NinjaTag.

Ejemplo 2: Recuperación desde un terminal activo

PS C:> Options-NinjaTag
Options-NinjaTag : Solo se puede acceder a las etiquetas desde un script de automatización
En la línea: 1, carácter: 1
+ Options-NinjaTag
+ ~~~~~~~~~~~~~~~~
+ CategoryInfo : FromStdErr: (:) [Write-Error],
WriteErrorException
+ FullyQualifiedErrorId :
Microsoft.PowerShell.Commands.WriteErrorException,Options-NinjaTag

Las etiquetas solo se pueden recuperar desde un script de automatización, por lo que se devuelve un mensaje de error al intentar ejecutar el cmdlet en una sesión de terminal activa.

Parámetros

Título

texto

Título

texto

Parámetros comunes

Este cmdlet admite los siguientes parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction y WarningVariable. Para obtener más información sobre los parámetros comunes, consulta el documento de Microsoft about_CommonParameters ( enlace externo).

Entradas

Ninguna

Salidas

System.String[]

Al ejecutarse, este cmdlet devuelve una matriz de cadenas que representan todas las etiquetas del sistema posibles que se pueden asignar a un dispositivo.

Recursos adicionales

Para obtener más información sobre la gestión de activos y la creación de scripts personalizados, consulta los siguientes recursos:

• NinjaOne: Índice de comandos y artículos de PowerShell 
• Introducción a las etiquetas de dispositivos de NinjaOne
• Uso de la API y la CLI con las etiquetas de dispositivos de NinjaOne
• Interfaz de línea de comandos (CLI) 
• Asignación de dispositivos como delegados de documentación
• Lectura o escritura en la documentación: automatización, CLI y API
• Interfaz de línea de comandos (CLI): campos y funcionalidades compatibles
• Campos personalizados de NinjaOne: primeros pasos