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 altre 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 automatizzate possono essere reimpostati utilizzando questo cmdlet. Il valore del campo personalizzato verrà cancellato dopo la successiva sincronizzazione riuscita con la piattaforma NinjaOne, che in genere avviene entro pochi minuti. Il dispositivo che esegue questo cmdlet deve essere assegnato come delegato alla documentazione per il documento contenente il campo personalizzato da cancellare.

Sintassi

Ninja-Property-Docs-Clear-Single [[-TemplateName] <OBJECT>] [[- AttributeName] <OBJECT> [<COMMONPARAMETERS>]

Esempi

Esempio 1: azzeramento 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à cancellato 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 cancellare 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

-NomeModello

Specificare il nome del modello di documento che contiene 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

Il sistema.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 del campo personalizzato sono necessari i permessi di scrittura delle automazioni. Per informazioni sui permessi relativi ai campi personalizzati, consultare NinjaOne Custom Fields: Getting Started.
Il valore del campo personalizzato verrà cancellato dopo la successiva sincronizzazione riuscita con la piattaforma NinjaOne
, che in genere avviene nel giro di pochi minuti.

Risorse aggiuntive

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