PowerShell : Set-NinjaUser

Rubrique

Cet article explique comment utiliser Set-NinjaUser pour attribuer un utilisateur spécifique à un appareil.

Si vous utilisez le module PowerShell NinjaOne en dehors d’un script d’automatisation, vous devrez peut-être ajuster la politique d’exécution de PowerShell. Pour plus d’informations sur les politiques d’exécution, consultez la documentation de Microsoft : À propos des politiques d’exécution ( Lien externe).

Environnement

NinjaOne
Microsoft PowerShell

Description

La cmdlet Set-NinjaUser attribue un utilisateur spécifié à un appareil. L'utilisateur est identifié par son adresse e-mail et peut être un utilisateur final, un technicien ou un contact. Si un compte ou un contact est limité à une organisation, NinjaOne ne fera correspondre que les appareils appartenant à la même organisation que l'utilisateur. Les techniciens doivent disposer d'une autorisation d'accès à l'appareil.

Cette cmdlet doit être exécutée dans un script d'automatisation Ninja pour modifier l'Utilisateur assigné.
Les mises à jour concernant l'Utilisateur assigné s'afficheront dans l'interface utilisateur web de NinjaOne une fois la synchronisation réussie, ce qui prend généralement quelques minutes.

Syntaxe

Définir-NinjaUser [-EmailAddress] <CHAÎNE> [-Force] [-WhatIf] [-Confirmation] [<COMMONPARAMETERS>]

Exemples

Exemple 1 : Attribuer un utilisateur – Script d’automatisation

PS C:> Set-NinjaUser -EmailAddress "[email protected]"
Requête envoyée avec succès à l’agent. Consultez le flux d’activité de l’appareil pour confirmer que
l’utilisateur a bien été attribué.

L'utilisateur dont l'adresse e-mail est « [email protected] » est assigné à l'appareil spécifié.

Exemple 2 : Attribuer un utilisateur – Terminal actif

PS C:> Set-NinjaUser -EmailAddress "[email protected]"
Set-NinjaUser : l'accès pour définir un utilisateur n'est possible qu'à partir d'un script d'automatisation
À la ligne : 1, caractère : 1
+ Set-NinjaUser -EmailAddress "[email protected]"
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ CategoryInfo : FromStdErr: (:) [Write-Error],
WriteErrorException
+ FullyQualifiedErrorId :
Microsoft.PowerShell.Commandes.WriteErrorException,Set-NinjaUser

Vous ne pouvez attribuer un utilisateur qu’à partir d’un script d’automatisation ; par conséquent, un message d’erreur s’affiche lorsque vous tentez d’exécuter la cmdlet dans une session de terminal active.

Paramètres

-Confirmer

Vous invite à confirmer avant d’exécuter la cmdlet.

Type : SwitchParameter
Ensembles de paramètres : (Tous)
Alias : cf
Obligatoire : Faux
Position : Nommé
Valeur par défaut : Aucune
Accepte les entrées de pipeline : Faux
Accepte les caractères génériques : Faux

-EmailAddress

Spécifie l'adresse e-mail de l'utilisateur à assigner à l'appareil. L'utilisateur doit déjà exister dans NinjaOne en tant qu'utilisateur final, technicien ou contact.

Type : Chaîne de caractères
Ensembles de paramètres : (Tous)
Alias :
Obligatoire : Vrai
Position : 0
Valeur par défaut : Aucune
Accepte les entrées de pipeline : Vrai (ByValue)
Accepte les caractères génériques : Faux

-Force

Si le paramètre Confirm n'est pas spécifié, le paramètre Force remplace ShouldProcess et permet à la cmdlet de poursuivre le traitement.

Type : SwitchParameter
Ensembles de paramètres : (Tous)
Alias :
Obligatoire : Faux
Position : Nommée
Valeur par défaut : Aucune
Accepte les entrées de pipeline : Faux
Accepte les caractères génériques : Faux

-WhatIf

Affiche ce qui se passerait si la cmdlet était exécutée. La cmdlet n’est pas exécutée.

Type : SwitchParameter
Ensembles de paramètres : (Tous)
Alias : wi
Obligatoire : False
Position : Nommé
Valeur par défaut : Aucune
Accepte les entrées de pipeline : False
Accepte les caractères génériques : False

Paramètres communs

Cette cmdlet prend en charge les paramètres communs suivants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations sur les paramètres communs, consultez le document Microsoft about_CommonParameters ( lien externe).

Entrées

Le Système.String

Cette cmdlet accepte une chaîne de caractères représentant l'adresse e-mail de l'utilisateur à assigner à l'appareil.

Sorties

Aucun

L'utilisateur doit déjà exister dans NinjaOne en tant qu'Utilisateur final, Technicien ou Contact.
NinjaOne affichera le nouveau dispositif non géré une fois la synchronisation réussie, ce qui prend généralement quelques minutes.

Ressources complémentaires

Pour plus d’informations sur la gestion des actifs et les scripts personnalisés, consultez les ressources suivantes :