Set-ADGroup: modificar los atributos del grupo de Active Directory en PowerShell
En esta publicación, le mostraré cómo usar Set-ADGroup para modificar los atributos del grupo de Active Directory usando el script de PowerShell.
Para utilizar el cmdlet Set-ADGroup es necesario instalar el módulo complementario ActiveDirectory .
El cmdlet Set-ADGroup en PowerShell modifica los atributos del grupo del directorio activo. Puede modificar los valores de propiedad utilizados habitualmente mediante los parámetros del cmdlet. Los valores de propiedad que no están asociados con los parámetros del cmdlet se pueden modificar mediante los parámetros Agregar, Quitar, Borrar y Reemplazar.
Cmdlet Set-ADGroup
La sintaxis del cmdlet Set-ADGroup se proporciona a continuación
Set-ADGroup
[-WhatIf]
[-Confirm]
[-Add <Hashtable>]
[-AuthType <ADAuthType>]
[-Clear <String[]>]
[-Credential <PSCredential>]
[-Description <String>]
[-DisplayName <String>]
[-GroupCategory <ADGroupCategory>]
[-GroupScope <ADGroupScope>]
[-HomePage <String>]
[-Identity] <ADGroup>
[-ManagedBy <ADPrincipal>]
[-Partition <String>]
[-PassThru]
[-Remove <Hashtable>]
[-Replace <Hashtable>]
[-SamAccountName <String>]
[-Server <String>]
[<CommonParameters>]Los parámetros Identidad especifican el grupo de Active Directory que se va a modificar. Puede identificar un grupo por su nombre distintivo, identificador de seguridad y GUID.
PowerShell Set-ADGroup funciona mejor si se combina con Get-ADGroup. Puede leer la información del grupo que necesita modificar usando Get-ADGroup y usar la barra vertical ( ||) para Set-ADGroup para modificar los atributos de grupos de Active Directory.
Establecer una propiedad para grupos usando identidad
Consideremos un escenario en el que desea actualizar la descripción del grupo a un grupo identificado mediante el parámetro Identidad en el directorio activo. Utilice el siguiente PowerShell Set-AdGroup para actualizar la descripción del grupo mediante la propiedad de descripción.
Set-ADGroup -Server localhost:60000 -Identity "CN=ShellAccessControl,DC=ShellNC" -Description "My Access Group" -Passthru
En el comando PowerShell Set-AdGroup anterior, identifique un grupo por su nombre distintivo de grupo y use la propiedad Descripción para establecer la descripción del grupo.
Uso de set adgroup para modificar la descripción de grupos filtrados
Consideremos un escenario en el que desea actualizar la descripción del grupo para grupos que tienen un nombre que comienza con Access, use el siguiente script de PowerShell. para actualizar la descripción del grupo usando Set-ADGroup
Get-ADGroup -Filter 'name -like "Access*"' | Set-ADGroup -Description "Access Group"Arriba, el grupo de filtros de comando PowerShell Set-AdGroup tiene un nombre que comienza con Access usando Get-ADGroup y usa el operador de canalización (||) para modificar la descripción de todos los grupos usando Set-ADGroup.
Consejo interesante: ¿Conoce el equivalente del comando cat en Windows?
Modificar la propiedad de un grupo usando Set-AdGroup
Set-ADGroup -Server localhost:60000 -Identity "CN=AccessControl,DC=AppNC" -Description "Access Group" -PassthruPor encima del ejemplo de PowerShell Set-AdGroup, modifica la Descripción del grupo denominado AccessControl a Grupo de acceso utilizando el parámetro de identidad SetAdGroup
Establece una propiedad especificando una instancia
$Group = Get-ADGroup -Server localhost:60000 -Identity N=AccessControl,DC=AppNC"
$Group.Description = "Access Group"
Set-ADGroup -Instance $Group -PassthruArriba del script de PowerShell, establece la propiedad Descripción en el grupo AccessControl mediante el parámetro de instancia Set-AdGroup. El parámetro Set-AdGroup -Instance solo puede actualizar el objeto de grupo que ha sido recuperado por el cmdlet Get-AdGroup.
Consejo interesante: Obtenga una lista del grupo de anuncios de usuarios en PowerShell.
Cambiar el nombre del grupo de Active Directory usando Set-AdGroup
Es muy fácil cambiar el nombre de los grupos del directorio activo utilizando los cmdlets get-adgroup y set-adgroup. rename-adobject y set-adgroup dos comandos necesarios para cambiar el nombre.
get-adgroup -identity “GroupName” | %{set-adgroup -samaccountname “ShortName”; $_ | rename-adobject -newname “ShortName”}En el ejemplo anterior de PowerShell set adgroup, get-adgroup identifica el grupo y, utilizando el cmdlet set-adgroup, cambia el nombre del grupo de Active Directory.
Consejo interesante: ¡Aprenda cómo obtener un usuario usando el nombre principal de usuario!
Agregue una dirección de correo electrónico al grupo de seguridad de AD usando Set-AdGroup -Replace
Supongamos que el archivo CSV tiene dos columnas, la primera columna es el nombre del grupo y la segunda columna es el nombre de una dirección de correo electrónico.
Para configurar una dirección de correo electrónico para el grupo de seguridad de anuncios, puede utilizar la propiedad de correo como se indica en el siguiente código
Import-CSV -path 'C:\PowerShell\AD-GroupScript\AddEmailToGroups.csv' |
ForEach-Object {Set-ADGroup -Identity $_.group -Replace @{mail = "$($_.mail)"}}
En el ejemplo anterior de Set-ADGroup, primero importamos un archivo CSV que tiene el nombre del grupo y la dirección de correo electrónico.
Posteriormente usamos el bucle Foreach para iterar sobre cada grupo y usamos el parámetro Set-ADGroup -Replace para acceder a la propiedad de correo y asignarla al grupo respectivo.
Consejo interesante: ¡Obtenga atributos de usuario publicitario desde CSV en PowerShell!
Conclusión
Espero que hayas disfrutado del artículo anterior para modificar la propiedad del grupo de Active Directory usando Set-ADGroup cmdlet en PowerShell. Set-ADGroup funciona mejor con Get-ADGroup en combinación para leer información del grupo y usar el operador de barra vertical (||) para modificar el valor de la propiedad.
Puede encontrar más temas sobre los comandos de PowerShell Active Directory y los conceptos básicos de PowerShell en la página de inicio de ShellGeek.
¿Sabe cómo encontrar todas las cuentas de usuarios que se han deshabilitado en una unidad organizativa específica usando PowerShell Search-AdAccount? ¡Lea aquí!