Powershell: New-NinjaUnmanagedDevice

Argomento

Questo articolo spiega come utilizzare New-NinjaUnmanagedDevice per creare un nuovo dispositivo non gestito con i dettagli specificati dall'utente.

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 New-NinjaUnmanagedDevice crea un dispositivo non gestito e lo associa a una relazione di asset specificata con il dispositivo corrente. Il nuovo dispositivo non gestito viene automaticamente assegnato alla stessa organizzazione e alla stessa posizione del dispositivo gestito correlato.

Inoltre, è possibile specificare vari campi opzionali per personalizzare il dispositivo durante la sua creazione, come le date di inizio e fine della garanzia o altri dettagli rilevanti. NinjaOne visualizzerà il nuovo dispositivo non gestito al termine di una sincronizzazione riuscita, che di solito avviene nel giro di pochi minuti.

Sintassi

Proprietà individuali (impostazioni predefinite)

NinjaUnmanagedDevice [[-Name] <String>] [-Role <String>] [-Relation<String>] [-AssetID <String>][-AssetSerialNumber <String>] [-AssetStatus <String>] [-EndOfLifeDate<DateTime>] [-ExpectedLifetime <Stringa>][-PurchaseAmount <Decimale>] [-PurchaseDate <Data e ora>] [-WarrantyStartDate<Data e ora>][-WarrantyEndDate <Data e ora>] [-CustomFieldHashtable <Tabella hash>] [-Force][-WhatIf] [-Confirm][<Parametri comuni>]

Pipeline

New-NinjaUnmanagedDevice [[-InputObject] <Object>] [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]

Esempi

Esempio 1: Creazione da singole proprietà

PS C:> New-NinjaUnmanagedDevice -Name "AEG-12345 sul desktop di Luke" -Role
"Monitor" -Relation "Collegato a"

Le informazioni minime richieste per creare un dispositivo non gestito sono il nome, il ruolo di dispositivo non gestit
e e la relazione tra entità.

Esempio 2: Creazione da oggetto di input

$LukesMonitor = @{
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"
relation = "Collegato a"
ruolo = "Monitor"
dataFineGaranzia = "2027-02-21"
dataInizioGaranzia = "2026-02-21"
valoriCampiPersonalizzati = @{
campoTestoEsempio = "Il valore del mio campo di testo"
}
}
PS C:> New-NinjaUnmanagedDevice -InputObject $LukesMonitor

Per specificare ulteriori informazioni utilizzando il formato dell’oggetto di input, imposta il formato dell’oggetto come mostrato nell’esempio sopra riportato
.

Esempio 3: Utilizzo della tabella hash dei campi personalizzati

$MyCustomFieldValues = @{
exampleTextField = "Il mio valore del campo personalizzato di testo"
}
PS C:> New-NinjaUnmanagedDevice -Name "AEG-12345 sul desktop di Luke" -Role
"Monitor" -Relation "Collegato a" -CustomFieldHashtable
$MyCustomFieldValues

Se si desidera utilizzare singole proprietà e specificare determinati valori dei campi personalizzati, è possibile utilizzare l'
e del parametro CustomFieldHashtable.

Parametri

-AssetID

Specificare un numero di identificazione da associare alla nuova risorsa.

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

-AssetSerialNumber

Memorizza i numeri di serie dei dispositivi non gestiti.

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

-AssetStatus

Specifica lo stato corrente dell’asset. I valori validi includono “Procurement”, “Provisioning”, “
”, “Inventory”, “In use”, “Maintenance”, “Retired” e “Archived”.

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

-Conferma

Richiede una conferma prima di eseguire il cmdlet.

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

-ConfirmFieldHashtable

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

-EndOfLifeDate

Specificare 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: Nominale
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à l’impostazione di
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

-InputObject

Specificare un oggetto da elaborare invece di utilizzare singoli parametri.

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

-Name

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

Tipo: Stringa
Set di parametri: IndividualProperties
Alias:
Obbligatorio: False
Posizione: 0
Valore predefinito: Nessuno
Accetta input da 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: Nominata
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

-Relation

Specifica la relazione tra il dispositivo non gestito e il dispositivo corrente.

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

-Ruolo

Specifica il ruolo del dispositivo non gestito.

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

-WarrantyEndDate

Specifica la data di scadenza 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

-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: Per ulteriori informazioni sui parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Fare riferimento al documento Microsoft about_CommonParameters ( link esterno).

Input

System.Object

Questo cmdlet può accettare un oggetto come input tramite la pipeline o specificando il parametro InputObject.

System.String

La maggior parte dei parametri di questo cmdlet accetta stringhe come input quando non si utilizza il parametro InputObject, 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

Nessuna

NinjaOne visualizzerà il nuovo dispositivo non gestito al termine di una sincronizzazione riuscita, che di solito avviene nel giro di pochi minuti.

Risorse aggiuntive

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