Powershell: Ninja-Property-Set-Piped

Argomento

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

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-Set-Piped imposta il valore di un campo personalizzato specificato del dispositivo utilizzando la pipeline di PowerShell. È possibile specificare il nome del campo personalizzato utilizzando il parametro -Name. Il valore può essere fornito tramite la pipeline o utilizzando il parametro -Value. Il cmdlet aggiorna il valore del campo personalizzato specificato per il dispositivo con il valore fornito.

Solo i campi con autorizzazioni di scrittura automatizzate possono essere aggiornati utilizzando questo cmdlet. Il campo personalizzato specificato viene aggiornato dopo la successiva sincronizzazione riuscita con la piattaforma NinjaOne, che in genere avviene entro pochi minuti.

Sintassi

Ninja-Property-Set-Piped [[-Name] <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[String]
for($i = 0; $i -lt 199999; $i++){
$DesiredValue.Add("$($alphabet[(Get-Random -Maximum
$alphabet.Length)])")
}
$CustomFieldValue = "$($DesiredValue -join '')"
PS C:> Ninja-Property-Set-Piped -Name "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.

Esempio 2: Supporto della pipeline

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

Parametri

-Name

Specificare il nome del 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 da pipeline: Falso
Accetta caratteri jolly: Falso

-Valore

Specificare il valore da impostare per il campo personalizzato specificato.

Tipo: Oggetto
Set di parametri: (Tutti)
Alias:
Obbligatorio: Falso
Posizione: 1
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 per il parametro -Value, che rappresenta il valore da impostare per il campo personalizzato specificato. Il parametro -Name accetta un valore di tipo stringa che rappresenta il nome del campo personalizzato per il quale si desidera impostare un valore, ma non accetta input dalla pipeline.

Uscite

Nessuno

Solo i campi con autorizzazioni di scrittura automatizzata consentono di recuperare le relative opzioni tramite questo cmdlet. Per informazioni sulle autorizzazioni relative ai campi personalizzati, consultare NinjaOne Custom Fields: Getting Started.
Il campo personalizzato specificato viene aggiornato 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: