Powershell: Set-NinjaUser

Argomento

Questo articolo spiega come utilizzare Set-NinjaUser per assegnare un utente specificato a un dispositivo.

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 Set-NinjaUser assegna un utente specificato a un dispositivo. L’utente è identificato dal proprio indirizzo e-mail e può essere un utente finale, un tecnico o un contatto. Se un account o un contatto è limitato a un’organizzazione, NinjaOne abbinerà solo i dispositivi che appartengono alla stessa organizzazione dell’utente. I tecnici devono disporre dell’autorizzazione per accedere al dispositivo.

Questo cmdlet deve essere eseguito all’interno di uno script di automazione Ninja per modificare l’utente assegnato.
Le modifiche all’utente assegnato verranno visualizzate nell’interfaccia web di NinjaOne al termine di una sincronizzazione riuscita, che di solito avviene entro pochi minuti.

Sintassi

Set-NinjaUser [-EmailAddress] <String> [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]

Esempi

Esempio 1: Assegnazione di un utente - Script di automazione

PS C:> Set-NinjaUser -EmailAddress "[email protected]"
Richiesta inviata con successo all'agente. Consultare il feed delle attività del dispositivo per confermare che
l'utente sia stato assegnato.

L’utente con l’indirizzo e-mail "[email protected]" è stato assegnato al dispositivo specificato.

Esempio 2: Assegnazione di un utente - Terminale attivo

PS C:> Set-NinjaUser -EmailAddress "[email protected]"
Set-NinjaUser : L'accesso per impostare l'utente è possibile solo da uno script di automazione
Alla riga: 1 carattere: 1
+ Set-NinjaUser -EmailAddress "[email protected]"
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ CategoryInfo : FromStdErr: (:) [Write-Error],
WriteErrorException
+ FullyQualifiedErrorId :
Microsoft.PowerShell.Commands.WriteErrorException,Set-NinjaUser

È possibile assegnare un utente solo da uno script di automazione, pertanto viene restituito un messaggio di errore quando si tenta di eseguire il cmdlet in una sessione terminale attiva.

Parametri

-Confirm

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

-EmailAddress

Specifica l'indirizzo e-mail dell'utente da assegnare al dispositivo. L'utente deve già esistere in NinjaOne come utente finale, tecnico o contatto.

Tipo: Stringa
Set di parametri: (Tutti)
Alias:
Obbligatorio: True
Posizione: 0
Valore predefinito: Nessuno
Accetta input dalla pipeline: True (ByValue)
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: Nominale
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: Nominale
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.String

Questo cmdlet accetta una stringa che rappresenta l'indirizzo e-mail dell'utente da assegnare al dispositivo.

Uscite

Nessuno

L'utente deve già essere presente in NinjaOne come utente finale, tecnico o contatto.
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: