Powershell: Ninja-Property-Docs-Clear-Single

Argomento

Questo articolo spiega come utilizzare Ninja-Property-Docs-Clear-Singleper cancellare il valore di un campo personalizzato specificato in un singolo documento.

Se si utilizza il modulo NinjaOne PowerShell 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-Docs-Clear-Single cancella il valore di un campo personalizzato specificato in un singolo documento. È possibile specificare il nome del campo utilizzando il parametro -AttributeName e il documento utilizzando il parametro -TemplateName. 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. Il dispositivo che esegue questo cmdlet deve essere assegnato come delegato alla documentazione per il documento contenente il campo personalizzato da azzerare.

Sintassi

Ninja-Property-Docs-Clear-Single [[-TemplateName] <Object>] [[- AttributeName] <Object> [<CommonParameters>]

Esempi

Esempio 1: cancellazione di un campo personalizzato in un singolo documento

PS C: Ninja-Property-Docs-Clear-Single -TemplateName "My Example Document" -AttributeName "exampleAttribute"

Il campo personalizzato specificato nel documento verrà azzerato dopo la successiva sincronizzazione riuscita con la piattaforma NinjaOne, che in genere avviene nel giro di pochi minuti.

Parametri

-AttributeName

Specificare il nome del campo personalizzato che si desidera azzerare nel documento.

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

-TemplateName

Specificare il nome del modello di documento contenente il 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. I parametri -AttributeName e -TemplateName accettano valori di tipo stringa che rappresentano, rispettivamente, il nome del campo personalizzato da cancellare e il nome del modello di documento.

Uscite

Nessuno

Il dispositivo che esegue questo cmdlet deve essere assegnato come delegato alla documentazione per il documento
contenente il campo personalizzato da cancellare.
Per cancellare qualsiasi valore di un campo personalizzato sono necessari i permessi di scrittura per l'automazione. Per informazioni sui permessi relativi ai campi personalizzati, consultare NinjaOne Custom Fields: Getting Started.
Il valore del campo personalizzato verrà azzerato dopo la successiva sincronizzazione riuscita con la piattaforma NinjaOne
, che in genere avviene entro pochi minuti.

Risorse aggiuntive

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