Powershell: Ninja-Property-Docs-Set-Piped

Argomento

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

Ambiente

• NinjaOne
• Microsoft PowerShell

Descrizione

Questo cmdlet imposta il valore di un campo personalizzato specificato in un documento utilizzando la pipeline di PowerShell. È possibile specificare il nome del campo tramite il parametro -AttributeName, il documento tramite il parametro -DocumentName e il modello del documento tramite il parametro -TemplateId. Il valore può essere fornito tramite la pipeline o utilizzando il parametro -Value. Il cmdlet aggiorna il valore del campo personalizzato specificato nel documento indicato 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-Piped [[-TemplateId] <Object>] [[-DocumentName] <Object>] [[-AttributeName] <Object>] [[-Value] <Object>] [<CommonParameters>]

Esempi

Esempio 1: 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:> Ninja-Property-Docs-Set-Piped -TemplateId "5" -DocumentName "My
Example Document" -AttributeName "exampleWYSIWYG" -Value $CustomFieldValue

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".

Esempio 2: Supporto della pipeline

$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-Piped -TemplateId "5" -
DocumentName "My Example Document" -AttributeName "exampleWYSIWYG"

È possibile utilizzare la pipeline di PowerShell per impostare il valore di un campo personalizzato convogliando il valore desiderato di `
` nel cmdlet `Ninja-Property-Docs-Set-Piped`.

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: 2
Valore predefinito: Nessuno
Accetta input dalla pipeline: Falso
Accetta caratteri jolly: Falso

-DocumentName

Specificare il nome del documento contenente il 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

-TemplateId

Specificare l’ID del modello di documento contenente il campo personalizzato per il quale si desidera impostare un valore
.

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

-Value

Specificare il valore da impostare per il campo personalizzato specificato.

Tipo: Oggetto
Set di parametri: (Tutti)
Alias:
Obbligatorio: False
Posizione: 3
Valore predefinito: Nessuno
Accetta input dalla pipeline: True (ByValue)
Accetta caratteri jolly: False

Input

System.String

Il cmdlet accetta un input di tipo stringa dalla pipeline per il parametro -Value, che rappresenta il valore da impostare per il campo personalizzato specificato. I parametri -TemplateId, -DocumentName e -AttributeName accettano valori di tipo stringa che rappresentano, rispettivamente, l'ID del modello di documento, il nome del documento e il nome del campo personalizzato per cui 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: 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: Guida introduttiva