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 Automatisierungsskripts 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“ ordnet 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, ordnet NinjaOne dem Benutzer nur Geräte zu, die derselben Organisation angehören wie der Benutzer. Techniker müssen über die Berechtigung zum Zugriff auf das Gerät verfügen.

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

Syntax

Set-NinjaUser [-EmailAddress] <String> [-Force] [-WhatIf] [-Confirm] [<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 Zugriff zum Festlegen 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

Ein Benutzer kann nur über ein Automatisierungsskript zugewiesen werden. Daher wird eine Fehlermeldung zurückgegeben, wenn versucht wird, das Cmdlet in einer aktiven Terminalsitzung auszuführen.

Parameter

-Confirm

Fordert Sie vor der Ausführung des Cmdlets zur Bestätigung auf.

Typ: SwitchParameter
Parametersätze: (Alle)
Aliase: cf
Erforderlich: False
Position: Benannt
Standardwert: Keine
Pipeline-Eingabe zulassen: False
Platzhalterzeichen zulassen: 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: Keine
Pipeline-Eingabe zulassen: True (ByValue)
Platzhalterzeichen zulassen: False

-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: False
Position: Benannt
Standardwert: Keine
Pipeline-Eingabe akzeptieren: False
Platzhalterzeichen akzeptieren: False

-WhatIf

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

Typ: SwitchParameter
Parametersätze: (Alle)
Aliase: wi
Erforderlich: False
Position: Benannt
Standardwert: Keine
Pipeline-Eingabe zulassen: False
Platzhalterzeichen zulassen: False

Allgemeine 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

Keine

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

Weitere Ressourcen

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