Powershell: Remove-NinjaTag

Argomento

Questo articolo spiega come utilizzare Remove-NinjaTag per rimuovere un tag di sistema specificato da un dispositivo.

Se si utilizza il modulo PowerShell di NinjaOne al di fuori di uno script di automazione, potrebbe essere necessario modificare la politica di esecuzione di PowerShell. Per ulteriori informazioni sulle politiche di esecuzione, consultare la documentazione di Microsoft: Informazioni sulle politiche di esecuzione ( link esterno).

Ambiente

NinjaOne
Microsoft PowerShell

Descrizione

Il cmdlet Remove-NinjaTag rimuove uno o più tag di sistema specificati dal dispositivo corrente. I tag di sistema sono tag predefiniti nella piattaforma NinjaOne che possono essere utilizzati per classificare e gestire i dispositivi. Il cmdlet rimuove i tag specificati dal dispositivo corrente senza influire su altri tag assegnati.

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

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

Esempi

Esempio 1: Rimozione da uno script di automazione

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

Il tag di sistema specificato "IIS" viene rimosso dal dispositivo.

Esempio 2: Rimozione da un terminale attivo

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

I tag possono essere rimossi 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

Il nome dei tag di sistema da rimuovere dal dispositivo. Questo parametro accetta un array di stringhe, consentendo di specificare più tag da rimuovere in un unico comando.

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: Nominale
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[]

Un array di stringhe che rappresenta i nomi dei tag di sistema da rimuovere dal dispositivo. Questo input può essere fornito tramite la pipeline o come parametro.

Uscite

Nessuno

Questo cmdlet deve essere eseguito all'interno di uno script di automazione Ninja per modificare i tag di un dispositivo
.
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.

Risorse aggiuntive

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