Powershell: Set-NinjaTag

Argomento

Questo articolo spiega come utilizzare Set-NinjaTag per assegnare un tag di sistema specificato al dispositivo corrente.

Ambiente

• NinjaOne
• Microsoft PowerShell

Descrizione

Il cmdlet Set-NinjaTag assegna uno o più tag di sistema specificati al dispositivo corrente. I tag di sistema sono tag predefiniti nella piattaforma NinjaOne che possono essere utilizzati per classificare e gestire i dispositivi. Il cmdlet aggiunge i tag specificati al dispositivo corrente senza influire sui tag esistenti. 

Questo cmdlet deve essere eseguito all’interno di uno script di automazione Ninja per modificare i tag di sistema assegnati. Le modifiche all’assegnazione dei tag vengono applicate dopo la successiva sincronizzazione riuscita con la piattaforma NinjaOne, che in genere avviene nel giro di pochi minuti.

Sintassi

Set-NinjaTag [-Name] <String[]> [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]

Esempi

Esempio 1: Assegnazione da uno script di automazione

PS C:> Set-NinjaTag -Name "IIS"

Assegna il tag di sistema "IIS" al dispositivo corrente.

Esempio 2: Assegnazione da terminale attivo

PS C:> Set-NinjaTag -Name "IIS"
Set-NinjaTag : L'accesso ai tag è possibile solo da uno script di automazione
Alla riga: 1 carattere: 1
+ Set-NinjaTag -Name "IIS"
+ ~~~~~~~~~~~~~~~~~~~~~~~~
+ CategoryInfo : FromStdErr: (:) [Write-Error],
WriteErrorException
+ FullyQualifiedErrorId :
Microsoft.PowerShell.Commands.WriteErrorException,Set-NinjaTag

I tag sono impostabili solo da uno script di automazione, pertanto viene restituito un messaggio di errore quando si tenta di eseguire il cmdlet in una sessione terminale attiva.

Parametri

-Confirm

Richiede una conferma prima di eseguire il cmdlet.

Tipo: SwitchParameter
Set di parametri: (Tutti)
Alias: cf
Obbligatorio: False
Posizione: Denominato
Valore predefinito: Nessuno
Accetta input dalla pipeline: False
Accetta caratteri jolly: False

-Force

Se non viene specificato il parametro confirm e il cmdlet richiederebbe una conferma, questo parametro forza l'esecuzione del cmdlet senza richiedere conferma.

Tipo: SwitchParameter
Set di parametri: (Tutti)
Alias:
Obbligatorio: False
Posizione: Nominale
Valore predefinito: Nessuno
Accetta input dalla pipeline: False
Accetta caratteri jolly: False

-Name

Specifica il nome dei tag di sistema da assegnare al dispositivo corrente.

Tipo: String[]
Set di parametri: (Tutti)
Alias:
Obbligatorio: True
Posizione: 0
Valore predefinito: Nessuno
Accetta input dalla pipeline: True (ByValue)
Accetta caratteri jolly: False

-WhatIf

Mostra cosa accadrebbe se il cmdlet venisse eseguito. Il cmdlet non viene eseguito.

Tipo: SwitchParameter
Set di parametri: (Tutti)
Alias: wi
Obbligatorio: False
Posizione: Nominata
Valore predefinito: Nessuno
Accetta input dalla pipeline: False
Accetta caratteri jolly: False

Parametri comuni

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Per ulteriori informazioni sui parametri comuni, consultare il documento Microsoft about_CommonParameters ( link esterno).

Input

System.String[]

Il cmdlet accetta un array di stringhe che rappresentano i nomi dei tag di sistema da assegnare al dispositivo corrente.

Uscite

Nessuno

Risorse aggiuntive

Per ulteriori informazioni sulla gestione delle risorse e sulla creazione di script personalizzati, consultare le seguenti risorse:

• NinjaOne Endpoint Management: Indice dei comandi e degli articoli di PowerShell 
• Guida introduttiva ai tag dei dispositivi NinjaOne 
• Utilizzo dell’API e della CLI con i tag dei dispositivi NinjaOne
• Interfaccia della riga di comando (CLI) 
• Assegnazione dei dispositivi come delegati di documentazione
• Lettura o scrittura nella documentazione: automazione, CLI e API
• Interfaccia della riga di comando (CLI): campi e funzionalità supportati
• Campi personalizzati di NinjaOne: Guida introduttiva