Powershell: Ninja-Property-Docs-Set-Single-Piped

Argomento

Questo articolo spiega come utilizzare Ninja-Property-Docs-Set-Single-Piped per impostare il valore di un campo personalizzato specificato in un singolo documento utilizzando la pipeline di PowerShell.

Ambiente

• NinjaOne
• Microsoft PowerShell

Descrizione

Questo cmdlet imposta il valore di un campo personalizzato specificato in un singolo documento utilizzando la pipeline di PowerShell. È possibile specificare il nome del campo tramite il parametro -AttributeName e il modello di documento tramite il parametro TemplateName. Il valore può essere fornito tramite la pipeline o utilizzando il parametro -Value. Il cmdlet aggiorna il valore del campo personalizzato specificato nel singolo documento associato al modello specificato con il valore fornito.

Solo i campi con autorizzazioni di scrittura automatizzata possono essere aggiornati utilizzando questo cmdlet. Il dispositivo che esegue questo cmdlet deve essere assegnato come delegato alla documentazione per il documento contenente il campo personalizzato da aggiornare. Il campo personalizzato specificato nel documento viene aggiornato dopo la successiva sincronizzazione riuscita con la piattaforma NinjaOne, che in genere avviene entro pochi minuti.

Sintassi

Ninja-Property-Docs-Set-Single-Piped [[-TemplateName] <Object>] [[- AttributeName] <Object>] [[-Value] <Object>] [<CommonParameters>]

Esempio

Impostazione di un campo personalizzato con 199.999 caratteri

$alphabet = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMOPQRSTUVWXYZ1234567890"
$DesiredValue = New-Object System.Collections.Generic.List
for($i = 0; $i -lt 199999; $i++){
$DesiredValue.Add("$($alphabet[(Get-Random -Maximum
$alphabet.Length)])")
}
$CustomFieldValue = "$($DesiredValue -join '')"
PS C:> $CustomFieldValue | Ninja-Property-Docs-Set-Single-Piped -
TemplateName "My Example Document" -AttributeName "exampleWYSIWYG"

I comandi in pipeline possono essere utilizzati per impostare il valore di un campo personalizzato su una stringa lunga, ad esempio di 199.999 caratteri, che rappresenta la lunghezza massima consentita per un campo personalizzato WYSIWYG. In questo esempio, viene generata una stringa casuale di 199.999 caratteri e impostata come valore del campo personalizzato exampleWYSIWYG nel documento "My Example Document".

Parametri

-AttributeName

Specificare il nome del campo personalizzato per il quale si desidera impostare un valore.

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

-TemplateName

Fornire il nome del modello del documento in cui si desidera impostare il valore di
nel campo personalizzato specificato.

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

-Value

Definire il valore da impostare per il campo personalizzato specificato.

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

Input

System.String

Il cmdlet accetta un input di tipo stringa dalla pipeline, che viene utilizzato come valore da impostare per il campo personalizzato specificato. I parametri -TemplateName e -AttributeName accettano valori di tipo stringa che rappresentano, rispettivamente, il nome del modello di documento e il nome del campo personalizzato per i quali si desidera impostare un valore.

Uscite

Nessuno

Risorse aggiuntive

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

• NinjaOne Endpoint Management: Indice dei comandi e degli articoli di PowerShell
• Interfaccia della riga di comando (CLI)
• Assegnazione dei dispositivi come delegati alla documentazione
• Lettura o scrittura nella documentazione: automazione, CLI e API
• Interfaccia della riga di comando (CLI): campi e funzionalità supportati
• Campi personalizzati di NinjaOne: Introduzione