Powershell: Set-NinjaUser

Argomento

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

Se si utilizza il modulo NinjaOne PowerShell 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 solitamente avviene nel giro di pochi minuti.

Sintassi

Imposta-NinjaUser [-EmailAddress] <STRING> [-Force] [-WhatIf] [-Conferma] [<COMMONPARAMETERS>]

Esempi

Esempio 1: Assegnazione di un utente - Script di automazione

PS C:> Set-NinjaUser -EmailAddress "[email protected]"
Richiesta inviata con successo all'agente. Controllare 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

-Conferma

Richiede una conferma prima di eseguire il cmdlet.

Tipo: SwitchParameter
Set di parametri: (Tutti)
Alias: cf
Obbligatorio: False
Posizione: Nominale
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 proseguire l'elaborazione.

Tipo: SwitchParameter
Set di parametri: (Tutti)
Alias:
Obbligatorio: False
Posizione: Nominata
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 altre informazioni sui parametri comuni, consultare il documento Microsoft about_CommonParameters ( link esterno).

Input

Sistema.String

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

Uscite

Nessuno

L'utente deve già esistere in NinjaOne come utente finale, tecnico o contatto.
NinjaOne visualizzerà il nuovo dispositivo non gestito una volta completata la sincronizzazione, che solitamente avviene nel giro di pochi minuti.

Risorse aggiuntive

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