Powershell: Entfernen von NinjaTag

Thema

In diesem Artikel wird erläutert, wie Sie mit „Remove-NinjaTag“ ein bestimmtes System-Tag von einem Gerät entfernen 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 „Remove-NinjaTag“ entfernt ein oder mehrere angegebene System-Tags vom aktuellen Gerät. System-Tags sind vordefinierte Tags in der NinjaOne-Plattform, die zur Kategorisierung und Verwaltung von Geräten verwendet werden können. Das Cmdlet entfernt die angegebenen Tags vom aktuellen Gerät, ohne andere zugewiesene Tags zu beeinflussen.

Dieses Cmdlet muss innerhalb eines Ninja-Automatisierungsskripts ausgeführt werden, um die zugewiesenen System-Tags zu ändern. Änderungen an der Tag-Zuweisung werden nach der nächsten erfolgreichen Synchronisierung mit der NinjaOne-Plattform übernommen, was in der Regel innerhalb weniger Minuten geschieht.

Syntax

Remove-NinjaTag [-Name] <String[]> [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]

Beispiele

Beispiel 1: Entfernen aus einem Automatisierungsskript

PS C:> Remove-NinjaTag -Name „IIS“

Das angegebene System-Tag „IIS“ wird vom Gerät entfernt.

Beispiel 2: Aus dem aktiven Terminal entfernen

PS C:> Remove-NinjaTag -Name "IIS"
Remove-NinjaTag : Der Zugriff auf Tags ist nur über ein Automatisierungsskript möglich
In Zeile: 1, Zeichen: 1
+ Remove-NinjaTag -Name "IIS"
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ CategoryInfo : FromStdErr: (:) [Write-Error],
WriteErrorException
+ FullyQualifiedErrorId :
Microsoft.PowerShell.Commands.WriteErrorException,Remove-NinjaTag

Tags können nur über ein Automatisierungsskript entfernt 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: Keiner
Pipeline-Eingabe zulassen: False
Platzhalterzeichen zulassen: False

-Force

Wenn „confirm“ nicht angegeben ist und das Cmdlet normalerweise eine Bestätigung anfordern würde, erzwingt dieser Parameter die Ausführung des Cmdlets ohne Bestätigungsabfrage.

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

-Name

Der Name des/der System-Tags, die vom Gerät entfernt werden sollen. Dieser Parameter akzeptiert ein Array von Zeichenfolgen, sodass Sie mehrere zu entfernende Tags in einem einzigen Befehl angeben können.

Typ: String[]
Parametersätze: (Alle)
Aliase:
Erforderlich: True
Position: 0
Standardwert: Keine
Pipeline-Eingabe zulassen: True (ByValue)
Platzhalterzeichen zulassen: 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[]

Ein Array von Zeichenfolgen, die die Namen der System-Tags darstellen, die vom Gerät entfernt werden sollen. Diese Eingabe kann über die Pipeline oder als Parameter bereitgestellt werden.

Ausgaben

Keine

Dieses Cmdlet muss innerhalb eines Ninja-Automatisierungsskripts ausgeführt werden, um die Tags eines
-Geräts zu ändern.
Änderungen an der Tag-Zuweisung werden nach der nächsten erfolgreichen Synchronisierung mit der NinjaOne-
-Plattform übernommen, was in der Regel innerhalb weniger Minuten geschieht.

Weitere Ressourcen

Weitere Informationen zum Asset-Management und zur Erstellung benutzerdefinierter Skripte finden Sie in den folgenden Ressourcen: