{"id":5031,"date":"2012-09-03T00:01:00","date_gmt":"2012-09-03T00:01:00","guid":{"rendered":"https:\/\/blogs.technet.microsoft.com\/heyscriptingguy\/2012\/09\/03\/use-powershell-to-create-a-user-in-active-directory\/"},"modified":"2012-09-03T00:01:00","modified_gmt":"2012-09-03T00:01:00","slug":"use-powershell-to-create-a-user-in-active-directory","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/scripting\/use-powershell-to-create-a-user-in-active-directory\/","title":{"rendered":"Use PowerShell to Create a User in Active Directory"},"content":{"rendered":"

Summary<\/b>: Use the Active Directory cmdlet New-ADUser<\/b> to create a new user via Windows PowerShell.\nMicrosoft Scripting Guy, Ed Wilson, is here. The Scripting Wife has the Window PowerShell Saturday site<\/a> bookmarked on her Windows 7 smart phone, and she keeps hitting refresh on the little Internet Explorer window to watch the available tickets for the Charlotte PowerShell Saturday event march down to zero. I will admit, the tickets are going rapidly. This is a great chance to learn Windows PowerShell, meet new friends, and have a lot of fun—all for the nominal cost of lunch.<\/p>\n

Use splatting to simplify user creation<\/h2>\n

The New-ADUser<\/b> Windows PowerShell cmdlet (from the ActiveDirectory module) has a ton of parameters. Filling these out makes for cumbersome code, and does little to encourage readability. In fact, I hate having to read the command syntax (via Get-Help<\/b> or Get-Command<\/b>) because it seems to go on and on and on! I figure that most (if not all) of the attributes that are available to supply for a user in Active Directory can be supplied directly via a cmdlet parameter. (To be honest, I have never had the patience to compare the user schema with the cmdlet parameters to see if something is missing. By the way, anything that is missing can be filled in via the Set-ADUser<\/b> cmdlet.\nOne way to make things a bit easier to read (and to open up interesting automation possibilities) is to use the technique of splatting. I have posted a number of Hey, Scripting Guy! Blogs<\/a> that explain splatting or make use of the technique<\/p>\n

Splatting uses a hash table<\/h2>\n

To use splatting, I create a hash table that has keys that are exactly the same as the names of the parameters of the cmdlet, and I store the hash table in a variable. I then assign values to the keys. These values are passed to the cmdlet when I pass the variable to the cmdlet that contains the hash table. The following command creates a hash table that contains a number of keys that are the same as the parameter names that are used by the Get-ADUser<\/b> cmdlet.<\/p>\n

$users = @{<\/p>\n

\n

 “name” = “fred”<\/p>\n

\n

 “givenName” = “manfred”<\/p>\n

\n

 “l” = “lexington”<\/p>\n

\n

}\nWhen I run this bit of code, I see the hash table.\n<\/p>\n

PS C:> $users = @{<\/p>\n

\n

>>  “name” = “fred”<\/p>\n

\n

>>  “givenName” = “manfred”<\/p>\n

\n

>>  “l” = “lexington”<\/p>\n

\n

>> }<\/p>\n

\n

>> <\/p>\n

\n

PS C:> $users<\/p>\n

\n

 <\/p>\n

\n

Name                           Value<\/p>\n

\n

—-                           —–<\/p>\n

\n

l                              lexington<\/p>\n

\n

givenName                      manfred<\/p>\n

\n

name                           fred\nTo use this, all I do is import the ActiveDirectory module, create the hash table, and then pass the hash table to the Get-ADUser<\/b> cmdlet. This code is shown here.\n<\/p>\n

Import-Module activedirectory<\/p>\n

\n

$users = @{<\/p>\n

\n

 “name” = “fred”<\/p>\n

\n

 “givenName” = “manfred”<\/p>\n

\n

 “l” = “lexington”<\/p>\n

\n

}<\/p>\n

\n

New-ADUser @users\nThat is it. Now, all I need to do is to figure out a way to read a file of some sort, and automatically create the hash tables. Hmmmm…shouldn’t be too difficult, should it? After all, it is Windows PowerShell.  \nJoin me tomorrow for more cool Windows PowerShell stuff.\nI invite you to follow me on Twitter<\/a> and Facebook<\/a>. If you have any questions, send email to me at scripter@microsoft.com<\/a>, or post your questions on the Official Scripting Guys Forum<\/a>. See you tomorrow. Until then, peace.\nEd Wilson, Microsoft Scripting Guy<\/b> <\/p>\n","protected":false},"excerpt":{"rendered":"

Summary: Use the Active Directory cmdlet New-ADUser to create a new user via Windows PowerShell. Microsoft Scripting Guy, Ed Wilson, is here. The Scripting Wife has the Window PowerShell Saturday site bookmarked on her Windows 7 smart phone, and she keeps hitting refresh on the little Internet Explorer window to watch the available tickets for the […]<\/p>\n","protected":false},"author":596,"featured_media":87096,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[7,3,170,198,45],"class_list":["post-5031","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-scripting","tag-active-directory","tag-scripting-guy","tag-splatting","tag-users","tag-windows-powershell"],"acf":[],"blog_post_summary":"

Summary: Use the Active Directory cmdlet New-ADUser to create a new user via Windows PowerShell. Microsoft Scripting Guy, Ed Wilson, is here. The Scripting Wife has the Window PowerShell Saturday site bookmarked on her Windows 7 smart phone, and she keeps hitting refresh on the little Internet Explorer window to watch the available tickets for the […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/5031","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/users\/596"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/comments?post=5031"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/5031\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/media\/87096"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/media?parent=5031"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/categories?post=5031"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/tags?post=5031"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}