Powershell: Set-NinjaUser

Thema

In diesem Artikel wird erläutert, wie Sie mit „Set-NinjaUser“ einem Gerät einen bestimmten Benutzer zuweisen können.

Wenn Sie das NinjaOne-PowerShell-Modul außerhalb eines Skripts für Automatisierungen verwenden, müssen Sie möglicherweise die Ausführungsrichtlinie von PowerShell anpassen. Weitere Informationen zu Ausführungsrichtlinien finden Sie in der Dokumentation von Microsoft: Über Ausführungsrichtlinien ( Externer Link).

Umgebung

NinjaOne
Microsoft Powershell

Beschreibung

Das Cmdlet „Set-NinjaUser“ weiset einem Gerät einen bestimmten Benutzer zu. Der Benutzer wird anhand seiner E-Mail-Adresse identifiziert und kann ein Endbenutzer, ein Techniker oder ein Ansprechpartner sein. Wenn ein Konto oder ein Ansprechpartner auf eine Organisation beschränkt ist, weiset NinjaOne dem Benutzer nur Geräte zu, die derselben Organisation angehören wie der Benutzer. Techniker müssen über den Zugang zum Gerät verfügen.

Dieses Cmdlet muss innerhalb eines Ninja-Automatisierungsskripts ausgeführt werden, um den zugewiesenen Benutzer zu verändern.
Aktualisierungen des zugewiesenen Benutzers werden nach einer erfolgreichen Synchronisierung, die in der Regel innerhalb weniger Minuten erfolgt, in der NinjaOne-Weboberfläche angezeigt.

Syntax

Einstellen von NinjaUser [-EmailAddress] <STRING> [-Force] [-WhatIf] [-Bestätigen] [<COMMONPARAMETERS>]

Beispiele

Beispiel 1: Benutzer zuweisen – Automatisierungsskript

PS C:> Set-NinjaUser -EmailAddress "[email protected]"
Anfrage erfolgreich an den Agenten gesendet. Überprüfen Sie den Aktivitäts-Feed des Geräts, um sicherzustellen, dass der
Benutzer zugewiesen wurde.

Der Benutzer mit der E-Mail-Adresse „[email protected]“ ist dem angegebenen Gerät zugewiesen.

Beispiel 2: Benutzer zuweisen – Aktives Terminal

PS C:> Set-NinjaUser -EmailAddress "[email protected]"
Set-NinjaUser : Der Zugang zum Einstellen eines Benutzers ist nur über ein Automatisierungsskript möglich
In Zeile: 1, Zeichen: 1
+ Set-NinjaUser -EmailAddress "[email protected]"
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ CategoryInfo : FromStdErr: (:) [Write-Error],
WriteErrorException
+ FullyQualifiedErrorId :
Microsoft.Powershell.Commands.WriteErrorException,Set-NinjaUser

Sie können einen Benutzer nur über ein Automatisierungsskript zuweisen; daher wird eine Fehlermeldung zurückgegeben, wenn versucht wird, das Cmdlet in einer aktiven Terminalsitzung auszuführen.

Parameter

-Bestätigen

Fordert Sie vorher zur Bestätigung an, bevor das Cmdlet ausgeführt wird.

Typ: SwitchParameter
Parameter-Sätze: (Alle)
Aliase: cf
Erforderlich: False
Position: Benannt
Standardwert: Kein(e)
Pipeline-Eingabe akzeptieren: False
Platzhalterzeichen akzeptieren: False

-EmailAddress

Geben Sie die E-Mail-Adresse des Benutzers an, der dem Gerät zugewiesen werden soll. Der Benutzer muss bereits in NinjaOne als Endbenutzer, Techniker oder Kontakt vorhanden sein.

Typ: Zeichenfolge
Parametersätze: (Alle)
Aliase:
Erforderlich: True
Position: 0
Standardwert: Kein(e)
Pipeline-Eingabe akzeptieren: True (ByValue)
Platzhalterzeichen akzeptieren: Falsch

-Force

Wenn der Parameter „Confirm“ nicht angegeben ist, überschreibt der Parameter „Force“ den Parameter „ShouldProcess“ und ermöglicht es dem Cmdlet, die Verarbeitung fortzusetzen.

Typ: SwitchParameter
Parametersätze: (Alle)
Aliase:
Erforderlich: Falsch
Position: Benannt
Standardwert: Kein(e)
Pipeline-Eingabe akzeptieren: Falsch
Platzhalterzeichen akzeptieren: Falsch

-WhatIf

Einblendet, was passieren würde, wenn das Cmdlet ausgeführt würde. Das Cmdlet wird nicht ausgeführt.

Typ: SwitchParameter
Parameter-Sätze: (Alle)
Aliase: wi
Erforderlich: False
Position: Benannt
Standardwert: Kein(e)
Pipeline-Eingabe akzeptieren: False
Platzhalterzeichen akzeptieren: False

Gewöhnliche Parameter

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen zu allgemeinen Parametern finden Sie im Microsoft-Dokument „about_CommonParameters“ ( Externer Link).

Eingaben

System.String

Dieses Cmdlet akzeptiert eine Zeichenfolge, die die E-Mail-Adresse des Benutzers angibt, der dem Gerät zugewiesen werden soll.

Ausgaben

Kein(e)

Der Benutzer muss bereits in NinjaOne als Endnutzer, Techniker oder Kontakt existieren.
NinjaOne zeigt das neue nicht verwaltete Gerät nach einer erfolgreichen Synchronisierung an, die in der Regel innerhalb weniger Minuten erfolgt.

Zusätzliche Ressourcen

Weitere Informationen zur Bestandsverwaltung und zu benutzerdefinierten Skripten finden Sie in den folgenden Ressourcen: