Powershell: Ninja-Property-Clear

Argomento

Questo articolo spiega come utilizzare Ninja-Property-Clear per cancellare il valore di un campo personalizzato specificato.

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 Ninja-Property-Clear cancella il valore di un campo personalizzato specificato. È possibile specificare il nome del campo utilizzando il parametro -Name. Il cmdlet rimuoverà qualsiasi valore esistente dal campo personalizzato, riportandolo di fatto allo stato vuoto.

Solo i campi con autorizzazioni di scrittura per l’automazione possono essere reimpostati utilizzando questo cmdlet. Il valore del campo personalizzato verrà azzerato dopo la successiva sincronizzazione riuscita con la piattaforma NinjaOne, che in genere avviene nel giro di pochi minuti.

Sintassi

Ninja-Property-Clear [[-Name] <Object>] [<CommonParameters>]

Esempi

Esempio 1: Cancellazione di un campo personalizzato di tipo testo

PS C:> Ninja-Property-Clear -Name "exampleTextField"

Il campo di testo verrà svuotato dopo la successiva sincronizzazione riuscita con la piattaforma NinjaOne, che
avviene in genere nel giro di pochi minuti.

Parametri

-Name

Specificare il nome del campo personalizzato che si desidera cancellare.

Tipo: Oggetto
Set di parametri: (Tutti)
Alias:
Obbligatorio: Falso
Posizione: 0
Valore predefinito: Nessuno
Accetta input dalla pipeline: Falso
Accetta caratteri jolly: Falso

Input

System.String

Questo cmdlet non accetta input dalla pipeline. Il parametro -Name accetta un valore di tipo string
e che rappresenta il nome del campo personalizzato da azzerare.

Uscite

Nessuno

Per azzerare qualsiasi valore di un campo personalizzato sono necessari i permessi di lettura per l'automazione. Per informazioni sui permessi relativi ai campi personalizzati, consultare la guida introduttiva "Campi personalizzati di NinjaOne: Guida introduttiva".
Il valore del campo personalizzato verrà azzerato dopo la successiva sincronizzazione riuscita con la piattaforma
di NinjaOne, che in genere avviene nel giro di pochi minuti.

Risorse aggiuntive

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