Werbung

Herkunft

Microsoft.ActiveDirectory.Management.dll

Kurzinformation

Ändert eine Active Directory-Gruppe.

Syntax

Set-ADGroup [-Identity] [-Add ] [-Remove ] [-Replace ] [-Clear ] [-Partition ] [-PassThru] [-Server ] [-Credential ] [-AuthType ] [-Verbose] [-Debug] [-ErrorAction ] [-WarningAction ] [-ErrorVariable ] [-WarningVariable ] [-OutVariable ] [-OutBuffer ] [-WhatIf] [-Confirm] [-Description ] [-DisplayName ] [-GroupScope ] [-GroupCategory ] [-HomePage ] [-ManagedBy ] [-SamAccountName ] Set-ADGroup -Instance [-PassThru] [-Server ] [-Credential ] [-AuthType ] [-Verbose] [-Debug] [-ErrorAction ] [-WarningAction ] [-ErrorVariable ] [-WarningVariable ] [-OutVariable ] [-OutBuffer ] [-WhatIf] [-Confirm]

Beschreibung

Mit dem Cmdlet "Set-ADGroup" werden die Eigenschaften einer Active Directory-Gruppe geändert. Sie können häufig verwendete Eigenschaftenwerte mit den Cmdlet-Parametern ändern. Eigenschaftenwerte, die keinen Cmdlet-Parametern zugeordnet sind, können mit den Parametern "Add", "Replace", "Clear" und "Remove" geändert werden.

Der Identity-Parameter gibt die zu ändernde Active Directory-Gruppe an. Sie können eine Gruppe durch den definierten Namen (DN), GUID, die Sicherheits-ID (SID) oder den Kontonamen des Sicherheitskonto-Managers (Security Accounts Manager, SAM) identifizieren. Sie können den Identity-Parameter auch auf eine Objektvariable wie $ festlegen, oder Sie können ein Gruppenobjekt über die Pipeline an den Identity-Parameter übergeben. Sie können beispielsweise mit dem Cmdlet "Get-ADGroup" ein Gruppenobjekt abrufen und dieses anschließend über die Pipeline an das Cmdlet "Set-ADGroup" übergeben.

Der Instance-Parameter bietet die Möglichkeit, ein Gruppenobjekt zu aktualisieren, indem die Änderungen übernommen werden, die an einer Kopie des Objekts vorgenommen wurden. Wenn Sie den Instance-Parameter auf eine Kopie eines Active Directory-Gruppenobjekts festgelegt haben, die geändert wurde, werden durch das Cmdlet "Set-ADGroup" am ursprünglichen Gruppenobjekt dieselben Änderungen vorgenommen. Rufen Sie mit dem Get-ADGroup-Objekt eine Kopie des zu ändernden Objekts ab. Der Identity-Parameter ist nicht zulässig, wenn Sie den Instance-Parameter verwenden. Weitere Informationen über den Instance-Parameter finden Sie in der Beschreibung des Instance-Parameters. Weitere Informationen über das Instance-Konzept in Active Directory-Cmdlets finden Sie unter "about_ActiveDirectory_Instance".

In den folgenden Beispielen wird gezeigt, wie die Description-Eigenschaft eines Gruppenobjekts mit drei Methoden geändert wird: – Durch Angabe des Identity-Parameters und des Description-Parameters – Durch Übergabe eines Gruppenobjekts über die Pipeline und Angabe des Description-Parameters – Durch Angabe des Instance-Parameters

Methode 1: Ändern Sie die Description-Eigenschaft für die Gruppe "SecurityLevel2Access" mit dem Identity-Parameter und dem Description-Parameter.

Set-ADGroup -Identity SecurityLevel2Access -Description "Wird für die Autorisierung des Zugriffs auf Sicherheitsebene 2 verwendet."

Methode 2: Ändern Sie die Description-Eigenschaft für die Gruppe "SecurityLevel2Access", indem Sie die Gruppe "SecurityLevel2Access" über die Pipeline übergeben und den Description-Parameter angeben.

Get-ADGroup -Identity "SecurityLevel2Access" | Set-ADGroup -Description "Wird für die Autorisierung des Zugriffs auf Sicherheitsebene 2 verwendet."

Methode 3: Ändern Sie die -Eigenschaft für die Gruppe "SecurityLevel2Access", indem Sie mit der Windows PowerShell-Befehlszeile eine lokale Instanz der Gruppe "SecurityLevel2Access" ändern. Legen Sie dann den Instance-Parameter auf die lokale Instanz fest.

$group = Get-ADGroup -Identity "SecurityLevel2Access" $group.Description = "Wird für die Autorisierung des Zugriffs auf Sicherheitsebene 2 verwendet." Set-ADGroup -Instance $group.

Links

Liste aller Commandlets Mehr über die Windows PowerShell

Bücher zur PowerShell

Buchcover Windows PowerShell 5.0 - Das Praxishandbuch (1. Auflage 2016/5. Auflage Gesamtreihe) Windows PowerShell 5.0 - Das Praxishandbuch (1. Auflage 2016/5. Auflage Gesamtreihe)
Autoren: Dr. Holger Schwichtenberg
erschienen 2016, 996 Seiten, 49,99 €
ISBN: 3446446435
Bestellung: Amazon.de oder im Buchhandel über ISBN 3446446435

Schulungen/Seminare

Offene Seminare zur PowerShell
In-House-Seminare zur PowerShell