Windows PowerShell : the definitive guide

A guide to using Windows PowerShell to script Windows administrative tasks and control Windows from the command line. Windows PowerShell Cookbook......Page 0 Table of Contents......Page 3 Glue, Enablers, and a WSH......Page 15 That Lee Guy......Page 17 Preface......Page 19 Part 1: Tour......Page 20 Part 5: References......Page 21 Conventions Used in This Book......Page 22 Comments and Questions......Page 23 Acknowledgments......Page 24 Part I......Page 27 Introduction......Page 29 An Interactive Shell......Page 30 Structured Commands (Cmdlets)......Page 32 Deep Integration of Objects......Page 33 Administrators As First-Class Users......Page 34 Techniques to Protect You from Yourself......Page 35 Common Discovery Commands......Page 36 Ubiquitous Scripting......Page 37 Bridging Technologies......Page 38 Namespace Navigation Through Providers......Page 40 Much, Much More......Page 42 Part II......Page 43 Solution......Page 45 Discussion......Page 46 Problem......Page 47 Problem......Page 48 Solution......Page 49 Discussion......Page 50 Solution......Page 51 Solution......Page 52 Discussion......Page 53 1.6 Program: Search Help for Text......Page 54 Discussion......Page 55 1.8 Program: Retain Changes to Environment Variables Set by a Batch File......Page 56 Discussion......Page 58 Discussion......Page 59 Discussion......Page 60 Solution......Page 61 1.13 Program: Learn Aliases for Common Commands......Page 62 Solution......Page 64 Problem......Page 65 See Also......Page 66 Solution......Page 67 Problem......Page 68 Discussion......Page 69 Solution......Page 70 Solution......Page 71 See Also......Page 72 See Also......Page 73 See Also......Page 74 2.0 Introduction......Page 75 Discussion......Page 76 2.2 Program: Simplify Most Where-Object Filters......Page 77 2.3 Program: Interactively Filter Lists of Objects......Page 78 Problem......Page 80 Discussion......Page 81 Solution......Page 82 Discussion......Page 84 See Also......Page 86 3.0 Introduction......Page 87 Discussion......Page 88 Discussion......Page 89 Solution......Page 91 Discussion......Page 92 Solution......Page 93 Static methods......Page 94 Instance methods......Page 95 Instance properties......Page 96 Discussion......Page 97 Load types from another assembly......Page 98 3.6 Program: Create Instances of Generic Objects......Page 99 Problem......Page 100 Discussion......Page 101 See Also......Page 102 Discussion......Page 103 Solution......Page 104 Public fields/public properties......Page 105 Discussion......Page 106 Calculated properties......Page 107 Discussion......Page 108 Add a ScriptProperty......Page 109 Add a ScriptMethod......Page 111 Add other extension points......Page 112 Solution......Page 113 Discussion......Page 114 Solution......Page 115 Solution......Page 116 Solution......Page 117 Discussion......Page 118 Solution......Page 119 See Also......Page 120 Solution......Page 121 See Also......Page 122 Discussion......Page 123 Discussion......Page 124 Discussion......Page 125 Solution......Page 126 Solution......Page 127 Problem......Page 128 Discussion......Page 129 See Also......Page 130 See Also......Page 131 Discussion......Page 132 Discussion......Page 133 Solution......Page 134 See Also......Page 135 5.12 Program: Convert Text Streams to Objects......Page 136 Solution......Page 140 Creating large text reports......Page 141 Solution......Page 143 Discussion......Page 144 Solution......Page 145 Working with any root......Page 146 Solution......Page 147 Discussion......Page 148 Solution......Page 149 Discussion......Page 150 See Also......Page 152 Discussion......Page 153 Solution......Page 154 See Also......Page 155 Part III......Page 157 Discussion......Page 159 Discussion......Page 161 Solution......Page 162 Discussion......Page 164 Solution......Page 165 Solution......Page 167 Discussion......Page 168 Discussion......Page 169 Replace text that spans multiple lines......Page 170 Replace text in large files......Page 171 See Also......Page 172 Solution......Page 173 Discussion......Page 175 Solution......Page 176 Solution......Page 177 Discussion......Page 178 Solution......Page 179 Discussion......Page 180 See Also......Page 181 Discussion......Page 182 Solution......Page 183 See Also......Page 185 Discussion......Page 186 Solution......Page 187 Discussion......Page 188 9.3 Program: Get-PageUrls......Page 189 9.4 Program: Connect-WebService......Page 192 9.6 Program: Send an Email......Page 196 See Also......Page 197 9.7 Program: Interact with Internet Protocols......Page 198 See Also......Page 201 Discussion......Page 202 Solution......Page 205 Problem......Page 206 Discussion......Page 207 Solution......Page 208 Discussion......Page 209 Solution......Page 210 Solution......Page 211 See Also......Page 213 Discussion......Page 214 Solution......Page 215 Discussion......Page 216 Solution......Page 219 See Also......Page 220 Solution......Page 221 Discussion......Page 222 Discussion......Page 223 See Also......Page 224 See Also......Page 225 Solution......Page 226 Discussion......Page 227 Solution......Page 228 Solution......Page 229 Discussion......Page 230 Discussion......Page 231 Solution......Page 232 Discussion......Page 233 See Also......Page 234 Solution......Page 235 Solution......Page 236 12.3 Program: Display a Menu to the User......Page 237 Solution......Page 239 Discussion......Page 240 See Also......Page 241 Discussion......Page 242 Discussion......Page 243 Complexity of user input and file content......Page 244 Capitalization rules......Page 245 12.7 Program: Invoke a Script Block with Alternate Culture Settings......Page 246 Solution......Page 247 Discussion......Page 248 12.9 Program: Add a Graphical User Interface to Your Script......Page 249 See Also......Page 251 Solution......Page 252 Discussion......Page 253 Discussion......Page 254 Discussion......Page 256 Discussion......Page 257 See Also......Page 259 13.6 Program: Analyze a Script’s Performance Profile......Page 260 See Also......Page 265 Solution......Page 266 Discussion......Page 267 Discussion......Page 268 Script blocks......Page 269 14.3 Program: Investigate the InvocationInfo Variable......Page 270 Discussion......Page 272 See Also......Page 273 Discussion......Page 274 14.7 Program: Search the Windows Start Menu......Page 276 See Also......Page 277 Discussion......Page 278 Discussion......Page 279 See Also......Page 280 Problem......Page 281 Discussion......Page 282 15.2 Program: Determine Properties Available to WMI Filters......Page 283 15.3 Program: Search for WMI Classes......Page 284 Solution......Page 287 See Also......Page 288 Discussion......Page 289 Retrieving data......Page 290 Calling methods on an instance......Page 291 Solution......Page 292 15.7 Program: Query a SQL Data Source......Page 293 See Also......Page 295 Discussion......Page 296 15.9 Program: Invoke Native Windows API Calls......Page 297 15.10 Program: Add Inline C# to Your PowerShell Script......Page 299 Problem......Page 302 Discussion......Page 303 Step 1: Download the Windows SDK......Page 305 Step 2: Create a file to hold the cmdlet and snapin source code......Page 306 Step 6: Use the snapin......Page 308 Step 1: Download the Windows SDK......Page 309 Step 2: Create a file to hold the hosting source code......Page 310 See Also......Page 311 16.0 Introduction......Page 312 Solution......Page 313 Discussion......Page 314 Solution......Page 315 See Also......Page 316 Discussion......Page 317 Apply PowerShell’s Group Policy templates......Page 318 Deploy Microsoft Certificate services......Page 319 Apply software restriction policies......Page 320 Discussion......Page 321 Solution......Page 322 Discussion......Page 323 Discussion......Page 324 See Also......Page 325 Discussion......Page 326 Save the credential’s password to disk......Page 327 Discussion......Page 328 Discussion......Page 329 Discussion......Page 330 See Also......Page 331 Part IV......Page 333 17.0 Introduction......Page 335 Discussion......Page 336 Discussion......Page 337 Discussion......Page 338 Solution......Page 339 Solution......Page 340 Discussion......Page 341 Solution......Page 343 Discussion......Page 344 Discussion......Page 346 Discussion......Page 347 Solution......Page 350 Discussion......Page 351 Problem......Page 352 Solution......Page 353 Discussion......Page 354 Discussion......Page 355 Discussion......Page 356 Discussion......Page 358 Discussion......Page 360 See Also......Page 361 Solution......Page 362 Solution......Page 363 Discussion......Page 364 Solution......Page 365 Discussion......Page 366 Discussion......Page 367 Discussion......Page 369 Discussion......Page 370 Discussion......Page 372 Discussion......Page 373 Solution......Page 374 Discussion......Page 375 Discussion......Page 377 Discussion......Page 379 Discussion......Page 380 Prepare to manually set the configuration option......Page 381 Automate these registry writes......Page 382 See Also......Page 383 Solution......Page 384 Discussion......Page 385 Discussion......Page 386 See Also......Page 387 Solution......Page 388 Solution......Page 389 Discussion......Page 390 Solution......Page 391 See Also......Page 392 Discussion......Page 393 See Also......Page 394 Solution......Page 395 Solution......Page 396 Discussion......Page 397 See Also......Page 398 Problem......Page 399 Discussion......Page 400 Solution......Page 401 Solution......Page 402 21.4 Program: Invoke a PowerShell Expression on a Remote Machine......Page 403 See Also......Page 405 Solution......Page 406 Discussion......Page 407 Discussion......Page 408 Solution......Page 409 See Also......Page 410 Discussion......Page 411 Create a test instance......Page 412 See Also......Page 413 Problem......Page 414 Discussion......Page 415 Solution......Page 416 23.7 Program: Import Users in Bulk to Active Directory......Page 417 Discussion......Page 419 Discussion......Page 420 Discussion......Page 421 Problem......Page 422 Solution......Page 423 Discussion......Page 424 Discussion......Page 425 Solution......Page 426 Problem......Page 427 Solution......Page 428 Discussion......Page 429 24.1 Program: List Logon or Logoff Scripts for a User......Page 431 24.2 Program: List Startup or Shutdown Scripts for a Machine......Page 433 Discussion......Page 434 Discussion......Page 435 24.5 Program: List All Installed Software......Page 436 Solution......Page 437 Solution......Page 438 Solution......Page 439 Solution......Page 440 Discussion......Page 441 Discussion......Page 442 Solution......Page 443 See Also......Page 444 24.12 Program: Summarize System Information......Page 445 Discussion......Page 446 Problem......Page 447 See Also......Page 448 Run ipconfig on the remote computer......Page 449 Discussion......Page 450 See Also......Page 451 25.0 Introduction......Page 452 Discussion......Page 453 Solution......Page 454 Discussion......Page 455 Discussion......Page 456 Problem......Page 457 Solution......Page 458 Discussion......Page 459 Discussion......Page 460 Solution......Page 461 Solution......Page 462 Solution......Page 463 Discussion......Page 464 Solution......Page 465 Discussion......Page 466 Part V......Page 467 Commands and Expressions......Page 469 Variables......Page 470 Literal and Expanding Strings......Page 472 Escape Sequences......Page 473 Hexadecimal and Other Number Bases......Page 474 Array Definitions......Page 475 Array Access......Page 476 Hashtable Definitions......Page 477 XML......Page 478 Arithmetic Operators......Page 479 Logical Operators......Page 481 Binary Operators......Page 482 Other Operators......Page 483 Comparison Operators......Page 484 if, elseif, and else Statements......Page 486 switch Statements......Page 487 foreach Statement......Page 490 do ... while Statement/do ... until Statement......Page 491 continue......Page 492 Working with the .NET Framework......Page 493 Instance Properties......Page 494 .NET framework documentation......Page 495 Creating Instances of Types......Page 496 The Add-Member cmdlet......Page 497 Custom type extension files......Page 498 Dot-sourcing......Page 499 Formal parameters......Page 500 Cmdlet keywords in scripts......Page 501 Exit statement......Page 502 Functions......Page 503 Managing Errors......Page 504 Terminating Errors......Page 505 Formatting Output......Page 506 Custom formatting files......Page 507 The Set-PsDebug Cmdlet......Page 508 Verbose Cmdlet Output......Page 509 Use hotkeys to operate the shell more efficiently......Page 510 Prompts......Page 512 Tab Completion......Page 513 Regular Expression Reference......Page 514 PowerShell Automatic Variables......Page 522 Standard PowerShell Verbs......Page 525 Selected .NET Classes and Their Uses......Page 528 WMI Reference......Page 535 Selected COM Objects and Their Uses......Page 542 Standard Numeric Format Strings......Page 545 Custom Numeric Format Strings......Page 546 .NET DateTime Formatting......Page 548 Custom DateTime Format Strings......Page 549 Index......Page 555 This Cookbook by Windows PowerShell team developer Lee Holmes provides hundreds of tested scripts that you can use right away to get Microsoft's new tool working for you. More than 150 recipes, combined with a concise task-based introduction to the Windows PowerShell scripting language and environment, make it the perfect look-up guide when you encounter a thorny problem, or need a quick solution. The ideal companion to any tutorial or reference, this book meets the needs of system administrators at any level.Microsoft has revolutionized the world of system management and command-line shells with its release of Windows PowerShell, and Lee Holmes gives you practical tools and inside advice that will make you a more productive user and administrator. You will be able to solve everything from automating routine tasks, working with files, event logs and other forms of structured data, to managing the users and resources of complex Windows networks. Each recipe includes a focused piece of code plus discussion of how and why it works, so that you can apply the solution to similar tasks.You get an array of recipes covering PowerShell fundamentals, common tasks, and administrator tasks, including:Pipelines, variables, objects, looping and flow control, strings and unstructured text, calculations and mathSimple files; structured files; Internet-enabled scripts; code reuse; lists, arrays and hashtables; user feedback; error management; environmental awareness; script signing; and moreFiles and directories, registry manipulation, comparing data, event logs, process cmdlets, service cmdlets, Active Directory, enterprise computer management, and moreThose who administer Microsoft's Exchange 2007 and System Center Operations Manager (formerly MOM) will also benefit from this book, with separate chapters devoted to these servers. All Windows administrators will appreciate the appendices that include a PowerShell language quick reference, and a reference to the .NET, WMI and COM objects that PowerShell scripters will use often.With working scripts, tutorials, and references all in one volume, Windows PowerShell Cookbook will turbocharge the productivity of any Windows administrator.