{"id":89,"date":"2007-03-12T14:38:10","date_gmt":"2007-03-12T22:38:10","guid":{"rendered":"http:\/\/testblog.sapien.com\/index.php\/2007\/03\/12\/pscx-get-adobject\/"},"modified":"2007-03-12T14:38:10","modified_gmt":"2007-03-12T22:38:10","slug":"pscx-get-adobject","status":"publish","type":"post","link":"https:\/\/dev.sapien.com\/blog\/2007\/03\/12\/pscx-get-adobject\/","title":{"rendered":"PSCX – Get-ADObject"},"content":{"rendered":"

I’ve started looking at the latest version of the PowerShell Community Extensions<\/a>. One cmdlet that is sure to be popular is Get-ADobject.<\/p>\n

Get-ADObject [-Class] [-Credential] [-DistinguishedName] [-Domain] [-Filter] [-GlobalCatalog] [-Scope] [-Server] [-Value] [<CommonParameters>]<\/font><\/p>\n

I’ve just started exploring its capabilities. But it makes getting objects from Active Directory a snap. This command returns a variable, $users, that contains all user object is my test domain:<\/p>\n

get-adobject -distinguishedname “DC=jdhitsolutions,dc=local” -server jdhit-dc01 -class “User” -outvariable users<\/font> <\/p>\n

Now I can do what ever I want with this object.  Pipe it through Get-Member to peek at all the available properties: <\/p>\n

$users | get-member<\/font> <\/p>\n

For a quick and dirty look I can run an expression like this: <\/p>\n

$users | select name,description,title<\/font> <\/p>\n

I can even modify an existing user: <\/p>\n

$user=get-adobject -distinguishedname “CN=Bill Shakespeare,OU=Testing,DC=jdhitsolutions,Dc=local” -server jdhit-dc01<\/font> <\/p>\n

$user.description=”Staff Writer”
$user.SetInfo()<\/font> <\/p>\n

This will update the description of the specified user object. If I re-run the first two commands I’ll see the new description. <\/p>\n

Here are a few other quick things I think are slick.  I can get all objects that contain a certain value (there’s also a filter parameter which I’ll leave for you to play with): <\/p>\n

get-adobject -domain JDHITSOLUTIONS -value TUser* -class user -outvariable testusers<\/font> <\/p>\n

foreach ($user in $testusers) {
>> $user.description=”PowerShell Test User”
>> $user.SetInfo()<\/font> <\/p>\n

Here in a flash I’ve updated the description for all may user TUser accounts. <\/p>\n

So until PowerShell has improved Active Directory support this is probably one of the simplest and best alternatives. <\/p>\n

 <\/p>\n

Technorati tags: <\/span>PowerShell<\/span><\/a>, <\/span>PSCX<\/span><\/a>, <\/span>Get-ADObject<\/span><\/a>, <\/span>ActiveDirectory<\/span><\/a>, <\/span>Scripting<\/span><\/a><\/div>\n
del.icio.us tags: <\/span>PowerShell<\/span><\/a>, <\/span>PSCX<\/span><\/a>, <\/span>Get-ADObject<\/span><\/a>, <\/span>ActiveDirectory<\/span><\/a>, <\/span>Scripting<\/span><\/a><\/div>\n

 <\/p>\n","protected":false},"excerpt":{"rendered":"

I’ve started looking at the latest version of the PowerShell Community Extensions. One cmdlet that is sure to be popular is Get-ADobject. Get-ADObject [-Class] [-Credential] [-DistinguishedName] [-Domain] [-Filter] [-GlobalCatalog] [-Scope] [-Server] [-Value] [<CommonParameters>] I’ve just started exploring its capabilities. But it makes getting objects from Active Directory a snap. This command returns a variable, $users, […]<\/p>\n","protected":false},"author":3,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"footnotes":""},"categories":[25],"tags":[],"class_list":["post-89","post","type-post","status-publish","format-standard","hentry","category-windows-powershell"],"jetpack_featured_media_url":"","_links":{"self":[{"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/posts\/89","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/users\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/comments?post=89"}],"version-history":[{"count":0,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/posts\/89\/revisions"}],"wp:attachment":[{"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/media?parent=89"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/categories?post=89"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/tags?post=89"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}