Werbung

Herkunft

Microsoft.ActiveDirectory.Management.dll

Kurzinformation

Ändert eine Active Directory-Organisationseinheit.

Syntax

Set-ADOrganizationalUnit [-Identity] [-Add ] [-Remove ] [-Replace ] [-Clear ] [-Partition ] [-PassThru] [-Server ] [-Credential ] [-AuthType ] [-Verbose] [-Debug] [-ErrorAction ] [-WarningAction ] [-ErrorVariable ] [-WarningVariable ] [-OutVariable ] [-OutBuffer ] [-WhatIf] [-Confirm] [-City ] [-Country ] [-Description ] [-DisplayName ] [-PostalCode ] [-ProtectedFromAccidentalDeletion ] [-State ] [-StreetAddress ] [-ManagedBy ] Set-ADOrganizationalUnit -Instance [-PassThru] [-Server ] [-Credential ] [-AuthType ] [-Verbose] [-Debug] [-ErrorAction ] [-WarningAction ] [-ErrorVariable ] [-WarningVariable ] [-OutVariable ] [-OutBuffer ] [-WhatIf] [-Confirm]

Beschreibung

Das Cmdlet "Set-ADOrganizationalUnit" ändert die Eigenschaften einer Active Directory-Organisationseinheit. 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-Organisationseinheit an. Sie können eine Organisationseinheit durch den definierten Namen (DN) oder GUID identifizieren. Sie können auch den Identity-Parameter auf eine Objektvariable wie $ADOrganizationalUnitObject> festlegen oder ein Objekt über die Pipeline an den Identity-Parameter übergeben. Sie können z. B. mit dem Cmdlet "Get-ADOrganizationalUnit" ein Organisationseinheitsobjekt abrufen und dieses anschließend über die Pipeline an das Cmdlet "Set-ADOrganizationalUnit" übergeben.

Der Instance-Parameter bietet die Möglichkeit, ein Organisationseinheitsobjekt zu aktualisieren, indem die an einer Kopie des Objekts vorgenommenen Änderungen übernommen werden. Wenn Sie den Instance-Parameter auf eine Kopie eines Active Directory-Organisationseinheitsobjekts festgelegt haben, die geändert wurde, werden vom Cmdlet "Set-ADOrganizationalUnit" dieselben Änderungen am ursprünglichen Organisationseinheitsobjekt vorgenommen. Rufen Sie mit dem Get-ADOrganizationalUnit-Objekt eine Kopie des zu ändernden Objekts ab. Wenn Sie den Instance-Parameter angeben, sollten Sie den Identity-Parameter nicht übergeben. 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 ManagedBy-Eigenschaft eines Organisationseinheitsobjekts mit drei Methoden geändert wird: – Durch Angabe des Identity-Parameters und des ManagedBy-Parameters – Durch Übergabe eines Organisationseinheitsobjekts über die Pipeline und Angabe des ManagedBy-Parameters – Durch Angabe des Instance-Parameters

Methode 1: Ändern Sie die ManagedBy-Eigenschaft für die Organisationseinheit "AccountingDepartment" mit dem Identity-Parameter und dem ManagedBy-Parameter.

Set-ADOrganizationalUnit -Identity "AccountingDepartment" -ManagedBy "SaraDavisGroup"

Methode 2: Ändern Sie die ManagedBy-Eigenschaft für die Organisationseinheit "AccountingDepartment", indem Sie die Organisationseinheit "AccountingDepartment" über die Pipeline übergeben und den ManagedBy-Parameter angeben.

Get-ADOrganizationalUnit -Identity ""AccountingDepartment"" | Set-ADOrganizationalUnit -ManagedBy "SaraHettichGruppe"

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

$organizational unit = Get-ADOrganizationalUnit -Identity "AccountingDepartment" $organizational unit.ManagedBy = "SaraHettichGruppe" Set-ADOrganizationalUnit -Instance $organizational unit.

Für AD LDS-Umgebungen muss der Partition-Parameter angegeben werden, es sei denn, eine der folgenden beiden Bedingungen trifft zu: – Das Cmdlet wird über ein Active Directory-Anbieterlaufwerk ausgeführt. – Es wird ein Standardnamenskontext oder eine Standardpartition für die AD LDS-Umgebung definiert. Um einen Standardnamenskontext für eine AD LDS-Umgebung anzugeben, legen Sie die msDS-defaultNamingContext-Eigenschaft des Active Directory-DSA (Directory Service Agent)-Objekts (nTDSDSA) für die AD LDS-Instanz fest.

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