Powershell: Set-NinjaUnmanagedDevice

Argomento

Questo articolo spiega come utilizzare Set-NinjaUnmanagedDevice per aggiornare gli attributi di un dispositivo non gestito specificato.

Ambiente

• NinjaOne
• Microsoft PowerShell

Descrizione

Il cmdlet Set-NinjaUnmanagedDevice aggiorna gli attributi di un dispositivo non gestito specificato. È possibile aggiornare attributi quali le informazioni sull’asset, i dettagli di acquisto, le date di garanzia e i campi personalizzati. Le modifiche ai dispositivi non gestiti vengono applicate dopo la successiva sincronizzazione riuscita con la piattaforma NinjaOne, che in genere avviene entro pochi minuti.

Sintassi

Set-NinjaUnmanagedDevice [-AssetID <Stringa>] [-AssetSerialNumber <Stringa>][-AssetStatus <Stringa>][-EndOfLifeDate <Data e ora>] [-ExpectedLifetime <Stringa>] [[-ID] <Int32>] [-Name <String>][-PurchaseAmount <Decimal>] [-PurchaseDate <DateTime>] [-WarrantyStartDate<DateTime>][-WarrantyEndDate <DateTime>] [-CustomFieldHashtable <Hashtable>] [-Force][-WhatIf] [-Confirm][<CommonParameters>]

Esempi

Esempio 1: Modifica tramite singole proprietà

PS C:> Set-NinjaUnmanagedDevice -Id 1314 -PurchaseAmount 100.00

L'importo di acquisto del dispositivo non gestito con ID 1314 viene aggiornato a 100,00 $.

Esempio 2: Modifica tramite oggetto di input

$LukesMonitor = @{
id = 1314
assetId = "8675309"
assetSerialNumber = "9565035"
assetStatus = "In uso"
endOfLifeDate = "2027-02-21"
expectedLifetime = "1 anno"
name = "AEG-12345 sul desktop di Lukes"
purchaseAmount = 100,00
purchaseDate = "2026-02-21"
warrantyEndDate = "2027-02-21"
warrantyStartDate = "2026-02-21"
customFieldValues = @{
exampleTextField = "Il valore del mio campo di testo"
}
}
PS C:> $LukesMonitor | Set-NinjaUnmanagedDevice

Gli attributi del dispositivo non gestito con ID 1314 vengono aggiornati in base ai valori forniti nell’oggetto di input.

Parametri

-AssetID

Specifica un numero di identificazione da associare al dispositivo. Non corrisponde all’ID del dispositivo in NinjaOne, ma può essere utilizzato per tracciare le informazioni sulle risorse.

Tipo: Stringa
Set di parametri: IndividualProperties
Alias:
Obbligatorio: False
Posizione: Denominato
Valore predefinito: Nessuno
Accetta input dalla pipeline: False
Accetta caratteri jolly: False

-AssetSerialNumber

Specificare il numero di serie del dispositivo da associare al dispositivo.

Tipo: Stringa
Set di parametri: IndividualProperties
Alias:
Obbligatorio: False
Posizione: Denominato
Valore predefinito: Nessuno
Accetta input dalla pipeline: False
Accetta caratteri jolly: False

-AssetStatus

Specifica lo stato corrente della risorsa. I valori validi includono "Approvvigionamento", "Provisioning", "Inventario", "In uso", "Manutenzione", "Ritirato" e "Archiviato".

Tipo: Stringa
Set di parametri: IndividualProperties
Alias:
Obbligatorio: False
Posizione: Nominale
Valore predefinito: Nessuno
Accetta input dalla pipeline: False
Accetta caratteri jolly: False

-Confirm

Richiede una conferma prima di eseguire il cmdlet.

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

-CustomFieldHashtable

Imposta i campi personalizzati del dispositivo utilizzando una tabella hash. Utilizza il nome del campo personalizzato come chiave e il valore corrispondente come valore.

Tipo: Tabella hash
Set di parametri: IndividualProperties
Alias:
Obbligatorio: False
Posizione: Nominale
Valore predefinito: Nessuno
Accetta input dalla pipeline: False
Accetta caratteri jolly: False

-EndOfLifeDate

Specifica la data in cui l’asset deve essere considerato “fuori servizio” utilizzando un oggetto datetime.

Tipo: DateTime
Set di parametri: IndividualProperties
Alias:
Obbligatorio: False
Posizione: Denominata
Valore predefinito: Nessuno
Accetta input dalla pipeline: False
Accetta caratteri jolly: False

-ExpectedLifetime

Inserire la durata prevista del dispositivo. Si noti che i soli valori validi sono "1 anno", "2 anni", "3 anni", "4 anni" e "5 anni".

Tipo: Stringa
Set di parametri: IndividualProperties
Alias:
Valori accettati: 1 anno, 2 anni, 3 anni, 4 anni, 5 anni
Obbligatorio: False
Posizione: Denominata
Valore predefinito: Nessuno
Accetta input dalla pipeline: False
Accetta caratteri jolly: False

-Force

Se il parametro Confirm non è specificato, il parametro Force sovrascriverà ShouldProcess e consentirà al cmdlet di continuare l’elaborazione.

Tipo: SwitchParameter
Set di parametri: (Tutti)
Alias:
Obbligatorio: False
Posizione: Denominato
Valore predefinito: Nessuno
Accetta input dalla pipeline: False
Accetta caratteri jolly: False

-ID

Specificare l’ID dispositivo NinjaOne del dispositivo non gestito da aggiornare. È possibile recuperare l’ID dispositivo utilizzando il cmdlet Get-NinjaUnmanagedDevice.

Tipo: Int32
Set di parametri: IndividualProperties
Alias:
Obbligatorio: False
Posizione: 0
Valore predefinito: Nessuno
Accetta input dalla pipeline: False
Accetta caratteri jolly: False

-InputObject

Specificare un oggetto da elaborare invece di utilizzare singoli parametri. L’oggetto deve contenere una proprietà per l’ID del dispositivo e può includere facoltativamente proprietà per qualsiasi altro attributo aggiornabile.

Tipo: PSObject
Set di parametri: Pipeline
Alias:
Obbligatorio: False
Posizione: 0
Valore predefinito: Nessuno
Accetta input dalla pipeline: True (ByValue)
Accetta caratteri jolly: False

-Name

Immettere il nome del dispositivo non gestito che si desidera creare.

Tipo: String
Set di parametri: IndividualProperties
Alias:
Obbligatorio: False
Posizione: Denominato
Valore predefinito: Nessuno
Accetta input dalla pipeline: False
Accetta caratteri jolly: False

-ImportoAcquisto

Salva l’importo speso per l’acquisto del dispositivo.

Tipo: Decimale
Set di parametri: IndividualProperties
Alias:
Obbligatorio: Falso
Posizione: Denominato
Valore predefinito: Nessuno
Accetta input dalla pipeline: Falso
Accetta caratteri jolly: Falso

-PurchaseDate

Specifica la data di acquisto del dispositivo utilizzando un oggetto datetime.

Tipo: DateTime
Set di parametri: IndividualProperties
Alias:
Obbligatorio: False
Posizione: Denominato
Valore predefinito: Nessuno
Accetta input dalla pipeline: False
Accetta caratteri jolly: False

-WarrantyEndDate

Specificare la data di scadenza della garanzia del dispositivo utilizzando un oggetto datetime.

Tipo: DateTime
Set di parametri: IndividualProperties
Alias:
Obbligatorio: False
Posizione: Denominata
Valore predefinito: Nessuno
Accetta input dalla pipeline: False
Accetta caratteri jolly: False

-WarrantyStartDate

Specifica la data di inizio della garanzia del dispositivo utilizzando un oggetto datetime.

Tipo: DateTime
Set di parametri: IndividualProperties
Alias:
Obbligatorio: False
Posizione: Denominato
Valore predefinito: Nessuno
Accetta input dalla pipeline: False
Accetta caratteri jolly: False

-WhatIf

Mostra cosa accadrebbe se il cmdlet venisse eseguito. Il cmdlet non viene eseguito.

Tipo: SwitchParameter
Set di parametri: (Tutti)
Alias: wi
Obbligatorio: False
Posizione: Denominato
Valore predefinito: Nessuno
Accetta input dalla pipeline: False
Accetta caratteri jolly: False

Parametri comuni

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Per ulteriori informazioni sui parametri comuni, consultare il documento Microsoft about_CommonParameters ( link esterno).

Input

System.Object

Il parametro InputObject accetta un oggetto PSObject contenente le proprietà del dispositivo non gestito da aggiornare. L'oggetto deve includere una proprietà per l'ID del dispositivo e può includere facoltativamente proprietà per qualsiasi altro attributo aggiornabile.

System.String

La maggior parte dei parametri di questo cmdlet accetta input di tipo stringa quando non si utilizza il parametro InputObject, come ad esempio Name, Role e Relation.

System.DateTime

Parametri quali PurchaseDate, WarrantyStartDate e WarrantyEndDate accettano valori di tipo DateTime quando non si utilizza il parametro InputObject.

System.Decimal

Il parametro PurchaseAmount accetta valori decimali quando non si utilizza il parametro InputObject.

System.Hashtable

Il parametro CustomFieldHashtable accetta un valore di tipo hashtable quando non si utilizza il parametro InputObject.

Uscite

System.Object

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 relativi a PowerShell 
• Gestione delle risorse informatiche (ITAM)
• NinjaOne ITAM: Guida introduttiva
• NinjaOne ITAM: Utilizzo dei dispositivi non gestiti in NinjaOne
• NinjaOne ITAM: Creazione di un dispositivo non gestito tramite l'interfaccia della riga di comando (CLI)