Powershell: Get-NinjaTag

Thema

In diesem Artikel wird erläutert, wie Sie mit „Get-NinjaTag“die derzeit einem Gerät zugewiesenen System-Tags abrufen 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 „Get-NinjaTag“ ruft die dem aktuellen Gerät zugewiesenen System-Tags ab.

Dieses Cmdlet muss innerhalb eines Ninja-Automatisierungsskripts ausgeführt werden, um auf die Tag-Informationen zugreifen zu können.

Syntax

Get-NinjaTag [CommonParameters]

Beispiele

Beispiel 1: Abruf von einem Automatisierungsskript

PS C:> Get-NinjaTag
Duplikatlöschung
Active Directory-Domänendienste
❤️

In der Ausgabe werden die derzeit dem Gerät zugewiesenen System-Tags aufgelistet. Die vollständige Liste der möglichen System-Tags kann mit dem Cmdlet „Options-NinjaTag“ abgerufen werden.

Beispiel 2: Abruf über die Active-Terminal-Schnittstelle

PS C:> Get-NinjaTag
Get-NinjaTag : Der Zugang zu Tags ist nur von einem Automatisierungsskript möglich
In Zeile: 1, Zeichen: 1
+ Get-NinjaTag
+ ~~~~~~~~~~~~
+ Kategorie: Fehler
+ Fehler: Write-Error, WriteErrorException
Get-NinjaTag
+ FullyQualifiedErrorId:
Microsoft.Powershell.Befehle.WriteErrorException,Get-NinjaTag

Tags können nur über ein Skript für Automatisierungen abgerufen werden, daher wird eine Fehlermeldung ausgegeben, wenn versucht wird, das Cmdlet in einer aktiven Terminalsitzung auszuführen.

Parameter

Allgemeine Parameter

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

EINGABEN

Kein(e)

AUSGABEN

System.String[]

Dieses Cmdlet gibt je nach Anzahl der zugewiesenen Tags einen String-Wert oder ein Array von Zeichenfolgen zurück.

Das Cmdlet muss innerhalb eines Ninja-Automatisierungsskripts ausgeführt werden, um auf die Tag-Informationen zugreifen zu können.

Zusätzliche Ressourcen

Weitere Informationen finden Sie in den folgenden Artikeln zu