book

Microsoft® PowerShell, VBScript and JScript® Bible

Name: Microsoft® PowerShell, VBScript and JScript® Bible
ISBN: 9780470386804

by William R. Stanek, James O'Neill, Jeffrey Rosen

February 2009

Intermediate to advanced

911 pages

17h 5m

English

Wiley

Read now

Unlock full access

Copyright
About the Authors
About the Technical Editor
Credits
Acknowledgments
Introduction
William R. StanekWho Should Read This BookHow This Book Is OrganizedConventions and FeaturesSource-Code FormattingWhat's on the Companion Web siteWhat You'll Learn from This Book
I. Getting Started with Windows Scripting
1. Introducing Windows Scripting
1.1. Introducing Windows Scripting1.1.1. Taking a look at Windows Scripting1.2. Windows Script Host Architecture1.2.1. Getting Started with Windows Script Host1.2.2. Using and running scripts1.2.3. Core object model1.2.4. More on scripting hosts1.2.5. More on scripting engines1.3. Windows PowerShell Architecture1.4. Summary
2. VBScript Essentials
2.1. Working with Variables2.1.1. Variable naming2.1.2. Declaring variables2.1.3. Variable types2.1.4. Converting variable types2.2. Working with Constants2.2.1. Using built-in constants2.2.2. Declaring constants2.3. Working with Arrays2.3.1. Initializing arrays2.3.2. Using arrays with multiple dimensions2.3.3. Sizing arrays2.4. VBScript Operators2.4.1. Arithmetic operators2.4.2. Comparison operators2.4.3. Performing operations on strings2.5. Conditional Statements2.5.1. Using If...Then2.5.2. Using Else and ElseIf2.5.3. Select Case2.5.4. Conditional controls and strings2.6. Control Loops2.6.1. For Next looping2.6.2. For Each looping2.6.3. Using Exit For2.6.4. Using Do While loops2.6.5. Using Do Until loops2.6.6. Using Exit Do2.6.7. While...WEnd loops2.7. Using Procedures2.7.1. Working with functions2.7.2. Working with subroutines2.8. Summary
3. JScript Essentials
3.1. Variables and Data Types3.1.1. Variables and naming conventions3.1.2. Working with data types3.2. Using Strings3.2.1. Concatenating strings3.2.2. Converting to and from strings3.3. Using Comments3.4. Using Arrays3.5. JScript Operators3.5.1. Arithmetic operators3.5.2. Comparison operators3.5.3. Assignment operators3.5.4. Logical operators3.5.5. Bitwise operators3.6. Conditional Statements3.6.1. Using if3.6.2. Using if...else3.7. Control Flow with Looping3.7.1. Using for loops3.7.2. Using for in loops3.7.3. Using while and do while loops3.7.4. Using continue and break statements3.7.5. Using switch case3.8. Using Functions3.8.1. Function structure3.8.2. Calling functions3.9. Summary

4. PowerShell Fundamentals
4.1. Shell Fundamentals4.2. PowerShell Aliases4.3. Cmdlets, Snap-ins, and Providers4.4. Functions and Filters4.5. Objects and Types and the PowerShell Pipe4.6. Exploring PowerShell Variables4.7. Richer Types and .NET Objects4.8. Arrays4.9. The PowerShell Pipe4.10. Looping in PowerShell4.11. Conditions4.12. Scripts, Script Blocks, and Functions4.13. Scripts and Security4.14. Summary
II. Windows VBScript and JScript
5. Creating Scripts and Scripting Files
5.1. Running Scripts5.1.1. Starting a Script5.1.2. Setting script properties5.1.3. Command-line options for scripts5.1.4. Using drag and drop with scripts5.2. Creating Batch Scripts5.2.1. Identifying the job name5.2.2. Adding scripts and setting the scripting language5.2.3. Setting the script source5.2.4. Referencing external objects and type libraries5.2.5. Setting job properties5.2.6. Setting parsing instructions5.2.7. Documentation and Usage5.3. Summary
6. VBScript and JScript Scripting Basics
6.1. Key WSH Objects6.2. Displaying Text Strings6.2.1. Using Echo6.2.2. Running the Echo script6.3. Examining Script Information6.3.1. Getting script host information6.3.2. Getting scripting information6.3.3. Getting script arguments6.4. Working with Environment Variables6.4.1. Understanding environment variables6.4.2. Accessing environment variables6.4.3. Working with environment variables: An alternative6.5. Running Programs from Within Scripts6.5.1. Starting an application6.5.2. Passing arguments to an application6.5.3. Additional features for Run6.6. Running Scripts Remotely6.7. Combining JScript and VBScript6.8. Summary
7. Input, Output, and Error Handling with VBScript and JScript
7.1. Input and Output Essentials7.2. Using Input Boxes7.2.1. Input box basics7.2.2. Setting default values for input boxes7.2.3. Positioning input boxes7.2.4. Converting input values7.3. Using Message Boxes7.3.1. Message box basics7.3.2. Adding buttons7.3.3. Adding icons7.3.4. Evaluating button clicks7.3.5. Help files for message boxes7.3.6. Using pop-up dialog boxes7.4. Error Detection and Handling7.4.1. Handling runtime errors in VBScript7.4.1.1. Preventing runtime errors from halting script execution7.4.1.2. Checking for and catching errors in VBScript7.4.1.3. Manually generating runtime errors7.4.2. Handling runtime errors in JScript7.4.2.1. Checking for and catching errors in JScript7.4.2.2. Throwing errors7.4.2.3. Other error-handling techniques7.5. Summary
8. Working with Files and Folders in VBScript and JScript
8.1. Understanding the FileSystemObject8.1.1. FSO objects and collections8.1.2. FSO methods and properties8.1.3. Using the FileSystemObject8.2. Working with Folders8.2.1. Checking folder contents8.2.2. Examining folder properties8.2.3. Creating folders8.2.4. Copying, moving, and deleting folders8.2.5. Issues for multiple folders8.2.5.1. Using DeleteFolder8.2.5.2. Using CopyFolder8.2.5.3. Using MoveFolder8.2.6. Issues for individual folders8.2.6.1. Using Delete8.2.6.2. Using Copy8.2.6.3. Using Move8.3. Using Special Folders8.4. Working with Files8.4.1. Examining file properties8.4.2. Creating files8.4.3. Copying, moving, and deleting files8.4.4. Issues for multiple files8.4.4.1. Using DeleteFile8.4.4.2. Using CopyFile8.4.4.3. Using MoveFile8.4.5. Issues for individual files8.4.5.1. Using Delete8.4.5.2. Using Copy8.4.5.3. Using Move8.5. Summary
9. Reading and Writing Files
9.1. Opening Files9.1.1. Using OpenTextFile9.1.2. Using OpenAsTextStream9.2. Reading Text Files9.2.1. Preparing to read9.2.2. Reading characters9.2.3. Reading lines9.2.4. Reading an entire file9.3. Skipping Lines in a File9.3.1. Skipping characters9.3.2. Skipping lines9.4. Writing to a File9.4.1. Preparing to write9.4.2. Writing characters9.4.3. Writing lines9.4.4. Writing blank lines9.5. Summary
10. Managing Drives and Printers with VBScript and JScript
10.1. Managing Drives10.2. Obtaining Drive Information10.2.1. Checking for a drive10.2.2. Using the Drive object10.2.3. Examining all drives on a system10.3. Mapping Network Drives10.3.1. Connecting to a network share10.3.2. Disconnecting from a network share10.4. Managing Network Printers10.4.1. Setting a default printer10.4.2. Adding printer connections10.4.3. Removing printer connections10.5. Summary
11. Configuring Menus, Shortcuts, and Startup Applications
11.1. Working with Menus, Desktops, and Startup Applications11.2. Creating Shortcuts and Menu Options11.2.1. Obtaining a target folder for the shortcut11.2.2. Obtaining a shortcut object11.2.3. Setting properties for link shortcuts11.2.3.1. Setting shortcut arguments11.2.3.2. Setting shortcut hotkeys11.2.3.3. Setting icon locations11.2.3.4. Setting working directories11.2.4. Setting properties for URL shortcuts11.3. Managing Shortcuts and Menus11.3.1. Creating menus11.3.2. Accessing and listing menu options11.3.3. Updating current shortcuts and menu options11.3.4. Deleting shortcuts and menu options11.3.5. Deleting menus11.4. Adding and Removing Startup Applications11.4.1. Adding startup options11.4.2. Removing startup options11.4.3. Moving startup options11.5. Summary
12. Working with the Windows Registry and Event Logs
12.1. Working with the Windows Registry12.1.1. Understanding the registry structure12.1.2. Reading registry keys and values12.1.3. Writing registry keys and values12.1.4. Creating new keys12.1.5. Deleting registry keys and values12.1.6. Reconfiguring network services through the registry12.1.6.1. Managing WINS through Windows scripts12.1.6.2. Managing DHCP through Windows scripts12.2. Using Event Logs12.2.1. Viewing event logs12.2.2. Understanding event entries12.2.3. Archiving event logs12.3. Writing to Event Logs12.3.1. Event logging basics12.3.2. Working with the LogEvent method12.4. Reading Event Logs12.4.1. Introducing Dumpel12.4.2. Using Dumpel12.4.3. Working with Dumpel in scripts12.5. Generating Event Log Reports12.5.1. Step 1: Creating the logs12.5.2. Step 2: Formatting the logs for viewing12.6. Summary
III. Network and Dictionary Service Scripting
13. Scheduling One-time and Recurring Tasks
13.1. Scheduling Local and Remote Jobs13.1.1. Scheduling basics13.1.2. Synchronizing the system time13.1.3. Scheduling utilities13.2. Using the Graphical Task Scheduler13.2.1. Running the wizard13.2.2. Viewing wizard tasks13.2.3. Changing task properties13.3. Scheduling Jobs with AT13.3.1. Using the AT Scheduler13.3.2. Viewing scheduled AT jobs13.3.3. Deleting scheduled AT jobs13.4. Scheduling with Scripts13.4.1. Using AT in a script13.4.2. Automated job creation13.4.3. Deleting jobs using scripts13.4.4. Creating a scheduling manager script13.5. Summary
14. Managing Computer and User Scripts
14.1. Why Use Computer and User Scripts?14.2. Introducing Group Policies14.2.1. How are policies used?14.2.2. When are policies applied?14.2.3. How are local group policies managed?14.2.4. How are global group policies managed?14.2.5. Using the policy consoles14.3. Working with Computer and User Scripts14.3.1. Managing startup and shutdown scripts14.3.2. Managing logon and logoff scripts14.3.3. Alternatives to group policy14.4. Summary
15. Introducing Active Directory Services Interfaces
15.1. ADSI Essentials15.1.1. Understanding ADSI providers15.1.2. Understanding the ADSI architecture15.1.3. Binding ADSI objects15.2. Taking Advantage of ADSI15.2.1. Working with the ADSI LDAP provider15.2.2. Working with the ADSI WinNT provider15.2.3. Working with the ADSI NDS provider15.2.4. Working with the ADSI NWCOMPAT provider15.3. ADSI Provider Basics15.3.1. Generic object binding15.3.2. Handling authentication and security15.3.3. Accessing properties and updating objects15.3.3.1. Working with IADs Properties15.3.4. Working with IADs methods15.4. Summary
16. Using Schema to Master ADSI
16.1. Exploring ADSI Schema16.1.1. The core WinNT object model16.1.2. The core LDAP object model16.2. Working with Schema Class Objects16.2.1. Accessing an object's schema class16.2.2. Checking to see if an object is a container16.2.3. Examining mandatory and optional properties16.3. Viewing Property Syntax, Ranges, and Values16.3.1. Accessing the IADsProperty interface16.3.2. Examining object properties16.4. Summary
17. Managing Local and Domain Resources with ADSI
17.1. Managing Domain Account Policies17.1.1. Working with domain objects17.1.2. Preparing to view and set account policies17.1.3. Viewing and setting account policies17.1.3.1. Using MinPasswordLength17.1.3.2. Using MinPasswordAge and MaxPasswordAge17.1.3.3. Using PasswordHistoryLength17.1.3.4. Using MaxBadPasswordsAllowed, AutoUnlockInterval, and LockoutObservationInterval17.2. Working with Local Computer Properties17.3. Creating and Modifying User Accounts17.3.1. User properties for WinNT17.3.2. Working with user account properties17.3.3. Managing user accounts with WinNT17.3.4. Creating user accounts with WinNT17.3.5. Deleting user accounts with WinNT17.3.6. Setting and changing passwords17.3.7. Checking group membership17.4. Creating and Modifying Group Accounts17.4.1. Understanding Windows group types17.4.2. Creating groups with WinNT17.4.3. Checking group membership17.4.4. Adding and removing group members17.5. Summary
18. Service and Resource Administration with ADSI
18.1. Managing Windows Services18.1.1. Using and understanding Windows services18.1.2. Working with service objects18.1.3. Using service object properties18.2. Checking Service Status and Dependencies18.3. Viewing and Setting Service Information18.4. Starting, Stopping, and Pausing Services18.5. Managing Open Resources and User Sessions18.5.1. Viewing open files and user sessions18.5.2. Viewing resources and sessions in scripts18.5.3. Working with Resource and Session objects18.6. Summary
19. Maintaining Shared Directories, Printer Queues, and Print Jobs
19.1. Working with Shared Folders19.1.1. Folder sharing essentials19.1.2. Examining shared folders and their properties19.1.3. Creating and deleting shared folders19.2. Managing Print Queues19.2.1. Examining print queues19.2.2. Using the PrintQueue object19.2.2.1. Using a banner page19.2.2.2. Working with general printer information19.2.2.3. Prioritizing print queues and print jobs19.2.2.4. Scheduling print queue availability19.2.2.5. Checking print queue status19.2.3. Managing print queues19.3. Controlling Print Jobs19.3.1. Examining print job properties19.3.2. Monitoring print job status19.3.3. Pausing and resuming print jobs19.4. Summary
20. Managing Active Directory Domain Extensions
20.1. Working with Naming Contexts and the RootDSE Object20.1.1. Binding to a naming context20.1.2. Using RootDSE properties20.2. Accessing Active Directory Schema20.2.1. Installing and starting ADSI Edit20.2.2. Examining the domain-naming context20.2.3. Common Active Directory objects20.3. Managing Computer Objects with LDAP20.3.1. Active Directory computer object properties20.3.2. Creating and deleting computer accounts with LDAP20.3.3. Moving and renaming computer accounts with LDAP20.3.4. Enabling and disabling computer accounts with LDAP20.4. Managing Contacts with LDAP20.5. Managing Groups with LDAP20.5.1. Active Directory group object properties20.5.2. Creating groups with LDAP20.5.3. Deleting, moving, and renaming groups with LDAP20.5.4. Checking group membership with LDAP20.5.5. Adding and removing group members with LDAP20.6. Working with Organizational Units20.6.1. Examining organizational unit properties20.6.2. Creating organizational units20.6.3. Modifying organizational units20.6.4. Moving, renaming, and deleting organizational units20.7. Managing User Accounts with LDAP20.7.1. Examining user object properties with LDAP20.7.2. Creating user accounts with LDAP20.7.3. Setting user account flags20.7.4. Viewing group membership20.7.5. Moving, renaming, and deleting user accounts with LDAP20.8. Summary
IV. Windows PowerShell
21. Input, Output, and Error Handling in PowerShell
21.1. Output to the Console21.2. A Little Diversion into Strings21.3. Implicit and Explicit Output21.4. Verbose and Debug Output21.5. Managing Different Outputs from Cmdlets21.6. More on Error Output21.7. Session Transcripts21.8. Tracking Progress21.9. Taking More Control of Formatting21.10. Sorting and Selecting Fields21.11. Changing How PowerShell Formats Objects21.12. Creating Custom Objects on Demand21.13. Techniques for Switching in Output21.14. Additional Output Cmdlets21.15. Outputting in Specific File Formats21.16. Every Export Has a Corresponding Import21.17. More on Selecting Text21.18. User Input21.19. Summary
22. Working with Files and the Registry in PowerShell
22.1. Using PSDrives, Accessing the File System, Mapping Drives22.1.1. Changing (setting) locations22.1.2. Getting child items (a.k.a. getting a directory) and testing paths22.1.3. Copying, deleting and renaming files22.1.4. Creating and deleting directories22.1.5. File properties and attributes22.1.6. Viewing and setting ACL permissions22.1.7. Working with file items: reading their content, creating and adding to them22.1.8. Selecting strings and working with text data22.1.9. Parsing text22.1.10. Working with the Registry22.2. Summary
23. Event Logging, Services, and Process Monitoring with PowerShell
23.1. Working with Services23.2. Starting, Stopping, Suspending, Resuming, and Restarting Services23.2.1. Stopping a service23.2.2. Starting a service23.2.3. Restarting a service23.2.4. Suspending and resuming services23.2.5. Configuring services23.3. Working with Processes23.3.1. Starting, finding, and stopping processes23.4. Working with Event Logs23.4.1. Clearing an event log23.4.2. Exporting event logs23.4.3. Finding entries in the event log23.5. Summary
24. Working with Active Directory Using ADSI and PowerShell
24.1. A Quick Introduction to Active Directory24.1.1. Directory activities24.1.2. Caution24.1.3. PowerShell and ADSI24.2. Getting Entries from AD with [ADSI]24.3. Creating Objects24.4. Getting Directory Entries with the Searcher24.4.1. It's a date Jim, but not as we know it24.4.2. LDAP filters24.4.3. Building a library of AD functions24.4.4. Finding related entries in AD24.5. Operations on Directory Entries24.5.1. Creating objects24.5.2. Setting single-valued properties24.5.2.1. User Account Control flags24.5.2.2. Setting passwords24.5.2.3. Setting group types24.5.3. Adding to (and deleting from) multivalued properties24.5.4. Moving and deleting objects24.5.5. Testing for the presence of an entry24.6. Summary
25. Working with WMI in PowerShell
25.1. Displaying WMI Information25.2. Querying WMI25.2.1. Choosing to how to write the query25.2.2. Finding WMI objects by association25.2.3. The WMI Type Accelerators25.3. Querying Across Computers25.3.1. Logging on to the remote computer25.4. Discovering WMI Objects25.5. WMI Object Properties25.6. Updating WMI Objects25.7. WMI Object Methods25.8. A Case Study for WMI: Server 2008 Hyper-V25.9. Summary
V. Windows Scripting Libraries
26. Library: File-System Utilities
26.1. Examining the File-System Utility Library26.2. Using the File-System Utility Library26.2.1. Using GetSubFolders, GetFiles, and GetFolderContents26.2.2. Using CheckExists26.2.3. Using GetInfo, GetSize, and GetType26.2.4. Setting and clearing file attributes26.2.5. Working with special folders, shortcuts, and menus26.2.6. Managing menu options26.2.7. Adding to the desktop and Start menu26.2.8. Using NewFolder and NewFile26.2.9. Using DeleteFile, DeleteFolder, and DeleteShortcut26.3. Summary
27. Library: I/O Utilities
27.1. Examining the I/O Utility Library27.2. Using the I/O Utility Library27.2.1. Handling file I/O with the utility library27.2.2. Handling other I/O tasks with the utility library27.3. Summary
28. Library: Network Resource Utilities
28.1. Examining the Network Resource Utility Library28.2. Using the Network Resource Utility Library28.2.1. Using GetDriveInfo28.2.2. Using CheckFreeSpace28.2.3. Using MapDrive28.2.4. Working with printers28.2.5. Viewing, checking, and managing services28.2.6. Using checkRS and viewDetailedRS28.2.7. Using viewShareInfo, createShare, and deleteShare28.3. Summary
29. Library: Account Management Utilities
29.1. Building the Account Management Library29.2. Using the Account Management Utilities29.2.1. Configuring domain account policies with the library utilities29.2.2. Managing groups with the library utilities29.2.3. Managing users with the library utilities29.2.4. Managing computers with the library utilities29.2.5. Functions for renaming and moving accounts29.3. Summary
30. Library: Building a PowerShell Library
30.1. Customizing Your PowerShell Environment30.1.1. Exploring the PowerShell host30.1.2. The PowerShell prompt30.1.3. Adding more to the environment30.2. A Generic "choose" Function30.3. Network Utilities30.3.1. Finding network adapters30.3.2. Get-Ipconfig30.3.3. Ping30.4. Clever Uses for Hash Tables30.5. COM Objects: A Firewall Tool30.6. Using .NET Objects to Access Mail and Web Services30.6.1. Sending mail30.6.2. Using the Web client object and XML30.7. Regular Expressions30.8. More Advanced Text Processing—Discovering Script Dependencies30.9. Scripts or Fuctions: Checking How a Script Was Invoked30.10. Summary
VI. Appendixes
A. Windows Scripting API
A.1. XML ElementsA.1.1. <?XML ?>A.1.2. <runtime>A.1.2.1. <description>A.1.2.2. <example>A.1.2.3. <usage>A.1.2.4. <named>A.1.2.5. <unnamed>A.1.3. <package>A.1.4. <job>A.1.4.1. <?job ?>A.1.4.2. <object>A.1.4.3. <reference>A.1.4.4. <resource>A.1.4.5. <script>A.2. getResource Static MethodA.2.1. Usage: VBScriptA.2.2. Usage: JScriptA.3. Drives CollectionA.3.1. Creating: VBScriptA.3.2. Creating: JScriptA.3.3. PropertiesA.4. Printers CollectionA.4.1. Creating: VBScriptA.4.2. Creating: JScriptA.4.3. PropertiesA.5. StdIn Stream*A.5.1. CreatingA.5.2. MethodsA.5.3. PropertiesA.6. StdErr Stream*A.6.1. CreatingA.6.2. MethodsA.7. StdOut Stream*A.7.1. CreatingA.7.2. MethodsA.8. WshArguments CollectionA.8.1. CreatingA.8.2. MethodsA.8.3. PropertiesA.9. WshNamed CollectionA.9.1. CreatingA.9.2. MethodA.9.3. PropertiesA.10. WshUnnamed CollectionA.10.1. CreatingA.10.2. MethodA.10.3. PropertiesA.11. Script.Signer ObjectA.11.1. CreatingA.11.2. MethodA.12. WScript ObjectA.12.1. CreatingA.12.2. MethodsA.12.3. PropertiesA.13. WshController ObjectA.13.1. CreatingA.13.2. MethodA.14. WshEnvironment ObjectA.14.1. Creating: VBScriptA.14.2. Creating: JScriptA.14.3. MethodsA.14.4. PropertiesA.15. WshNetwork ObjectA.15.1. CreatingA.15.2. MethodsA.15.3. PropertiesA.16. WshRemote ObjectA.16.1. Creating: VBScriptA.16.2. Creating: JScriptA.16.3. MethodsA.16.4. PropertiesA.16.5. EventsA.17. WshRemoteError ObjectA.17.1. PropertiesA.18. WshScriptExec ObjectA.18.1. Creating: VBScriptA.18.2. Creating: JScriptA.18.3. MethodsA.18.4. PropertiesA.19. WshShell ObjectA.19.1. CreatingA.19.2. MethodsA.19.3. PropertiesA.20. WshShortcut ObjectA.20.1. Creating: VBScriptA.20.2. Creating: JScriptA.20.3. MethodsA.20.4. PropertiesA.21. WshSpecialFolders ObjectA.21.1. Creating: VBScriptA.21.2. Creating: JScriptA.21.3. MethodA.21.4. PropertiesA.22. WshUrlShortcut ObjectA.22.1. Creating: VBScriptA.22.2. Creating: JScriptA.22.3. MethodsA.22.4. Properties
B. Core ADSI Reference
B.1. Using This ReferenceB.2. ADSI InterfacesB.2.1. IADsB.2.1.1. PropertiesB.2.1.1.1. AdsPathB.2.1.1.2. ClassB.2.1.1.3. GUIDB.2.1.1.4. NameB.2.1.1.5. ParentB.2.1.1.6. SchemaB.2.1.2. MethodsB.2.1.2.1. Get("propertyName")B.2.1.2.2. GetEx("propertyName")B.2.1.2.3. GetInfo()B.2.1.2.4. GetInfoEx("propertyName")B.2.1.2.5. Put("propertyName", valueString)B.2.1.2.6. PutEx(Flag, "propertyName", valueArray)B.2.1.2.7. SetInfo()B.2.2. IADsAclB.2.2.1. PropertiesB.2.2.1.1. PrivilegesB.2.2.1.2. ProtectedAttrNameB.2.2.1.3. SubjectNameB.2.2.2. MethodB.2.2.2.1. CopyAcl()B.2.3. IADsADSystemInfoB.2.3.1. PropertiesB.2.3.1.1. ComputerNameB.2.3.1.2. DomainDNSNameB.2.3.1.3. DomainShortNameB.2.3.1.4. ForestDNSNameB.2.3.1.5. IsNativeModeB.2.3.1.6. PDCRoleOwnerB.2.3.1.7. SchemaRoleOwnerB.2.3.1.8. SiteNameB.2.3.1.9. UserNameB.2.3.2. MethodB.2.3.2.1. GetAnyDCName()B.2.3.2.2. GetDCSiteName()B.2.3.2.3. RefreshSchemaCache()B.2.3.2.4. GetTrees()B.2.4. IADsBackLinkB.2.4.1. PropertiesB.2.4.1.1. ObjectNameB.2.4.1.2. RemoteIDB.2.5. IADsCaseIgnoreListB.2.5.1. PropertyB.2.5.1.1. CaseIgnoreListB.2.6. IADsClassB.2.6.1. PropertiesB.2.6.1.1. AbstractB.2.6.1.2. AuxDerivedFromB.2.6.1.3. AuxiliaryB.2.6.1.4. CLSIDB.2.6.1.5. ContainerB.2.6.1.6. ContainmentB.2.6.1.7. DerivedFromB.2.6.1.8. HelpFileContextB.2.6.1.9. HelpFileNameB.2.6.1.10. MandatoryPropertiesB.2.6.1.11. NamingPropertiesB.2.6.1.12. OIDB.2.6.1.13. OptionalPropertiesB.2.6.1.14. PossibleSuperiorsB.2.6.1.15. PrimaryInterfaceB.2.6.2. MethodB.2.6.2.1. Qualifiers()B.2.7. IADsCollectionB.2.7.1. MethodsB.2.7.1.1. Add(Object)B.2.7.1.2. Remove(Object)B.2.7.1.3. GetObject(Object)B.2.8. IADsComputerB.2.8.1. PropertiesB.2.8.1.1. ComputerIDB.2.8.1.2. DepartmentB.2.8.1.3. DescriptionB.2.8.1.4. DivisionB.2.8.1.5. LocationB.2.8.1.6. MemorySizeB.2.8.1.7. ModelB.2.8.1.8. NetAddressesB.2.8.1.9. OperatingSystemB.2.8.1.10. OperatingSystemVersionB.2.8.1.11. OwnerB.2.8.1.12. PrimaryUserB.2.8.1.13. ProcessorB.2.8.1.14. ProcessorCountB.2.8.1.15. RoleB.2.8.1.16. SiteB.2.8.1.17. StorageCapacityB.2.9. IADsComputerOperationsB.2.9.1. MethodsB.2.9.1.1. Shutdown("rebootFlag")B.2.9.1.2. Status()B.2.10. IADsContainerB.2.10.1. PropertiesB.2.10.1.1. CountB.2.10.1.2. FilterB.2.10.1.3. HintsB.2.10.2. MethodsB.2.10.2.1. CopyHere("AdsPath","newName")B.2.10.2.2. Create("objectClass","relativeName")B.2.10.2.3. Delete("objectClass","relativeName")B.2.10.2.4. GetObject("objectClass","relativeName")B.2.10.2.5. MoveHere("AdsPathToObject","relativeName")B.2.11. IADsDeleteOpsB.2.11.1. MethodB.2.11.1.1. DeleteObject(Flag)B.2.12. IADsDomainB.2.12.1. PropertiesB.2.12.1.1. AutoUnlockIntervalB.2.12.1.2. IsWorkgroupB.2.12.1.3. LockoutObservationIntervalB.2.12.1.4. MaxBadPasswordsAllowedB.2.12.1.5. MaxPasswordAgeB.2.12.1.6. MinPasswordAgeB.2.12.1.7. MinPasswordLengthB.2.12.1.8. PasswordAttributesB.2.12.1.9. PasswordHistoryLengthB.2.13. IADsEmailB.2.13.1. PropertiesB.2.13.1.1. AddressB.2.13.1.2. TypeB.2.14. IADsExtensionB.2.15. IADsFaxNumberB.2.15.1. PropertiesB.2.15.1.1. ParametersB.2.15.1.2. TelephoneNumberB.2.16. IADsFileServiceB.2.16.1. PropertiesB.2.16.1.1. DescriptionB.2.16.1.2. MaxUserCountB.2.17. IADsFileServiceOperationsB.2.17.1. MethodsB.2.17.1.1. Resources()B.2.17.1.2. Sessions()B.2.18. IADsFileShareB.2.18.1. PropertiesB.2.18.1.1. CurrentUserCountB.2.18.1.2. DescriptionB.2.18.1.3. HostComputerB.2.18.1.4. PathB.2.18.1.5. MaxUserCountB.2.19. IADsGroupB.2.19.1. PropertyB.2.19.1.1. DescriptionB.2.19.2. MethodsB.2.19.2.1. Add("AdsPathString")B.2.19.2.2. IsMember("AdsPathString")B.2.19.2.3. Members("AdsPathString")B.2.19.2.4. Remove("AdsPathString")B.2.20. IADsHoldB.2.20.1. PropertiesB.2.20.1.1. AmountB.2.20.1.2. ObjectNameB.2.21. IADsLargeIntegerB.2.21.1. PropertiesB.2.21.1.1. HighPartB.2.21.1.2. LowPartB.2.22. IADsLocalityB.2.22.1. PropertiesB.2.22.1.1. DescriptionB.2.22.1.2. LocalityNameB.2.22.1.3. PostalAddressB.2.22.1.4. SeeAlsoB.2.23. IADsMembersB.2.23.1. PropertiesB.2.23.1.1. CountB.2.23.1.2. FilterB.2.24. IADsNamespacesB.2.24.1. PropertyB.2.24.1.1. DefaultContainerB.2.25. IADsNetAddressB.2.25.1. PropertiesB.2.25.1.1. AddressB.2.25.1.2. AddressTypeB.2.26. IADsOB.2.26.1. PropertiesB.2.26.1.1. DescriptionB.2.26.1.2. FaxNumberB.2.26.1.3. LocalityNameB.2.26.1.4. PostalAddressB.2.26.1.5. SeeAlsoB.2.26.1.6. TelephoneNumberB.2.27. IADsObjectOptionsB.2.27.1. MethodsB.2.27.1.1. GetOption(optionConstantOrValue)B.2.27.1.2. SetOption(optionConstantOrValue, integerValue)B.2.28. IADsOctetListB.2.28.1. PropertyB.2.28.1.1. OctetListB.2.29. IADsOpenDSObjectB.2.29.1. MethodB.2.29.1.1. OpenDSObject(ADSPath, UserID, Password, Flags)B.2.30. IADsOUB.2.30.1. PropertiesB.2.30.1.1. BusinessCategoryB.2.30.1.2. DescriptionB.2.30.1.3. FaxNumberB.2.30.1.4. LocalityNameB.2.30.1.5. PostalAddressB.2.30.1.6. SeeAlsoB.2.30.1.7. TelephoneNumberB.2.31. IADsPathB.2.31.1. PropertiesB.2.31.1.1. PathB.2.31.1.2. TypeB.2.31.1.3. VolumeNameB.2.32. IADsPathnameB.2.32.1. PropertyB.2.32.1.1. EscapedModeB.2.32.2. MethodsB.2.32.2.1. AddLeafElement("leafElement")B.2.32.2.2. CopyPath()B.2.32.2.3. GetElement(index)B.2.32.2.4. GetEscapedElement(number,stringToEscape)B.2.32.2.5. GetNumElements()B.2.32.2.6. RemoveLeafElement()B.2.32.2.7. Retrieve(formatType)B.2.32.2.8. Set("AdsPath",optionType)B.2.32.2.9. SetDisplayType(displayType)B.2.33. IADsPostalAddressB.2.33.1. PropertiesB.2.33.1.1. PostalAddressB.2.34. IADsPrintJobB.2.34.1. PropertiesB.2.34.1.1. DescriptionB.2.34.1.2. HostPrintQueueB.2.34.1.3. NotifyB.2.34.1.4. NotifyPathB.2.34.1.5. PriorityB.2.34.1.6. SizeB.2.34.1.7. StartTimeB.2.34.1.8. TimeSubmittedB.2.34.1.9. TotalPagesB.2.34.1.10. UntilTimeB.2.34.1.11. UserB.2.34.1.12. UserPathB.2.35. IADsPrintJobOperationsB.2.35.1. PropertiesB.2.35.1.1. PagesPrintedB.2.35.1.2. PositionB.2.35.1.3. StatusB.2.35.1.4. TimeElapsedB.2.35.2. MethodsB.2.35.2.1. Pause()B.2.35.2.2. Resume()B.2.36. IADsPrintQueueB.2.36.1. PropertiesB.2.36.1.1. BannerPageB.2.36.1.2. DatatypeB.2.36.1.3. DefaultJobPriorityB.2.36.1.4. DescriptionB.2.36.1.5. LocationB.2.36.1.6. ModelB.2.36.1.7. NetAddressesB.2.36.1.8. PrintDevicesB.2.36.1.9. PrinterPathB.2.36.1.10. PrintProcessorB.2.36.1.11. PriorityB.2.36.1.12. StartTimeB.2.36.1.13. UntilTimeB.2.37. IADsPrintQueueOperationsB.2.37.1. PropertyB.2.37.1.1. StatusB.2.37.2. MethodsB.2.37.2.1. Pause()B.2.37.2.2. PrintJobs()B.2.37.2.3. Purge()B.2.37.2.4. Resume()B.2.38. IADsPropertyB.2.38.1. PropertiesB.2.38.1.1. MaxRangeB.2.38.1.2. MinRangeB.2.38.1.3. MultiValuedB.2.38.1.4. OIDB.2.38.1.5. SyntaxB.2.38.2. MethodB.2.38.2.1. Qualifiers()B.2.39. IADsPropertyEntryB.2.39.1. PropertiesB.2.39.1.1. ADS_TypeB.2.39.1.2. ControlCodeB.2.39.1.3. NameB.2.39.1.4. ValuesB.2.40. IADsPropertyListB.2.40.1. PropertyB.2.40.1.1. PropertyCountB.2.40.2. MethodsB.2.40.2.1. GetPropertyItem("propertyName",propertyTypeConstant)B.2.40.2.2. Item(propertyNameOrIndex)B.2.40.2.3. Next()B.2.40.2.4. PurgePropertyList()B.2.40.2.5. PutPropertyItem(propertyEntry)B.2.40.2.6. Reset()B.2.40.2.7. ResetPropertyItem(propertyNameOrIndex)B.2.40.2.8. Skip(numberToSkip)B.2.41. IADsPropertyValueB.2.41.1. PropertiesB.2.41.1.1. ADsTypeB.2.41.1.2. BooleanB.2.41.1.3. CaseExactStringB.2.41.1.4. CaseIgnoreStringB.2.41.1.5. DNStringB.2.41.1.6. IntegerB.2.41.1.7. LargeIntegerB.2.41.1.8. NumericStringB.2.41.1.9. OctetStringB.2.41.1.10. PrintableStringB.2.41.1.11. SecurityDescriptorB.2.41.1.12. UTCTimeB.2.41.2. MethodB.2.41.2.1. Clear()B.2.42. IADsPropertyValue2B.2.42.1. PropertiesB.2.42.1.1. GetObjectPropertyB.2.42.1.2. PutObjectPropertyB.2.43. IADsReplicaPointerB.2.43.1. PropertiesB.2.43.1.1. CountB.2.43.1.2. ReplicaAddressHintsB.2.43.1.3. ReplicaNumberB.2.43.1.4. ReplicaTypeB.2.43.1.5. ServerNameB.2.44. IADsResourceB.2.44.1. PropertiesB.2.44.1.1. LockCountB.2.44.1.2. PathB.2.44.1.3. UserB.2.44.1.4. UserPathB.2.45. IADsSessionB.2.45.1. PropertiesB.2.45.1.1. ComputerB.2.45.1.2. ComputerPathB.2.45.1.3. ConnectTimeB.2.45.1.4. IdleTimeB.2.45.1.5. UserB.2.45.1.6. UserPathB.2.46. IADsServiceB.2.46.1. PropertiesB.2.46.1.1. DependenciesB.2.46.1.2. DisplayNameB.2.46.1.3. ErrorControlB.2.46.1.4. HostComputerB.2.46.1.5. LoadOrderGroupB.2.46.1.6. PathB.2.46.1.7. ServiceAccountNameB.2.46.1.8. ServiceAccountPathB.2.46.1.9. ServiceTypeB.2.46.1.10. StartTypeB.2.46.1.11. StartupParametersB.2.46.1.12. VersionB.2.47. IADsServiceOperationsB.2.47.1. PropertyB.2.47.1.1. StatusB.2.47.2. MethodsB.2.47.2.1. Start()B.2.47.2.2. Stop()B.2.47.2.3. Pause()B.2.47.2.4. Continue()B.2.47.2.5. SetPassword("newPassword")B.2.48. IADsSyntaxB.2.48.1. PropertyB.2.48.1.1. OleAutoDataTypeB.2.49. IADsTimestampB.2.49.1.B.2.49.1.1. EventIDB.2.49.1.2. WholeSecondsB.2.50. IADsTypedNameB.2.50.1. PropertiesB.2.50.1.1. IntervalB.2.50.1.2. LevelB.2.50.1.3. ObjectNameB.2.51. IADsUserB.2.51.1. PropertiesB.2.51.1.1. AccountDisabledB.2.51.1.2. AccountExpirationDateB.2.51.1.3. BadLoginAddressB.2.51.1.4. BadLoginCountB.2.51.1.5. DepartmentB.2.51.1.6. DescriptionB.2.51.1.7. DivisionB.2.51.1.8. EmailAddressB.2.51.1.9. EmployeeIDB.2.51.1.10. FaxNumberB.2.51.1.11. FirstNameB.2.51.1.12. FullNameB.2.51.1.13. GraceLoginsAllowedB.2.51.1.14. GraceLoginsRemainingB.2.51.1.15. HomeDirectoryB.2.51.1.16. HomePageB.2.51.1.17. IsAccountLockedB.2.51.1.18. LanguagesB.2.51.1.19. LastFailedLoginB.2.51.1.20. LastLoginB.2.51.1.21. LastLogoffB.2.51.1.22. LastNameB.2.51.1.23. LoginHoursB.2.51.1.24. LoginScriptB.2.51.1.25. LoginWorkstationsB.2.51.1.26. ManagerB.2.51.1.27. MaxLoginsB.2.51.1.28. MaxStorageB.2.51.1.29. NamePrefixB.2.51.1.30. NameSuffixB.2.51.1.31. OfficeLocationsB.2.51.1.32. OtherNameB.2.51.1.33. PasswordExpirationDateB.2.51.1.34. PasswordLastChangedB.2.51.1.35. PasswordMinimumLengthB.2.51.1.36. PasswordRequiredB.2.51.1.37. PictureB.2.51.1.38. PostalAddressesB.2.51.1.39. PostalCodesB.2.51.1.40. ProfileB.2.51.1.41. RequireUniquePasswordB.2.51.1.42. SeeAlsoB.2.51.1.43. TelephoneHomeB.2.51.1.44. TelephoneMobileB.2.51.1.45. TelephoneNumberB.2.51.1.46. TelephonePagerB.2.51.1.47. TitleB.2.51.2. MethodsB.2.51.2.1. ChangePassword("oldPassword","newPassword")B.2.51.2.2. Groups()B.2.51.2.3. SetPassword("password")B.2.52. IDirectoryObjectB.2.53. IDirectorySearchB.3. ADSI Error Codes
C. Essential Command-Line Utilities for Use with WSH
C.1. ARPC.1.1. Details:C.2. ASSOCC.2.1. Details:C.3. ATC.3.1. Details:C.4. ATTRIBC.4.1. Details:C.5. CACLSC.5.1. Details:C.6. CHKDSKC.6.1. Details:C.7. COMPACTC.7.1. Details:C.8. CONVERTC.8.1. Details:C.9. DATEC.9.1. Details:C.10. DRIVERQUERYC.10.1. Details:C.11. EXPANDC.11.1. Details:C.12. FCC.12.1. Details:C.13. FORMATC.13.1. Details:C.14. FTPC.14.1. Details:C.15. FTYPEC.15.1. Details:C.16. IPCONFIGC.16.1. Details:C.17. NBTSTATC.17.1. Details:C.18. NET ACCOUNTSC.18.1. Details:C.19. NET COMPUTERC.19.1. Details:C.20. NET CONFIG SERVERC.20.1. Details:C.21. NET CONFIG WORKSTATIONC.21.1. Details:C.22. NET CONTINUEC.22.1. Details:C.23. NET FILEC.23.1. Details:C.24. NET GROUPC.24.1. Details:C.25. NET LOCALGROUPC.25.1. Details:C.26. NET PAUSEC.26.1. Details:C.27. NET PRINTC.27.1. Details:C.28. NET SESSIONC.28.1. Details:C.29. NET SHAREC.29.1. Details:C.30. NET STARTC.30.1. Details:C.31. NET STATISTICSC.31.1. Details:C.32. NET STOPC.32.1. Details:C.33. NET TIMEC.33.1. Details:C.34. NET USEC.34.1. Details:C.35. NET USERC.35.1. Options:C.35.2. Details:C.36. NET VIEWC.36.1. Details:C.37. NETSTATC.37.1. Details:C.38. NSLOOKUPC.38.1. Details:C.39. PATHC.39.1. Details:C.40. PINGC.40.1. Details:C.41. RECOVERC.41.1. Details:C.42. ROUTEC.42.1. Details:C.43. SCHTASKSC.43.1. Details:C.44. TIMEC.44.1. Details:C.45. TRACERTC.45.1. Details:

Content preview from Microsoft® PowerShell, VBScript and JScript® Bible

Appendix B. Core ADSI Reference

Active Directory Service Interfaces provide the core objects used to script directory services, computer resources, and networks. This appendix provides a quick reference for key interfaces, and their related properties and methods. The reference is not meant to be exhaustive; rather, the focus is on the most commonly used features in Windows scripts.

Using This Reference

ADSI providers implement the interfaces examined in this appendix. In Chapter 21, you learned about system providers, specifically WinNT, LDAP, NDS, and NWCOMPAT. These providers implement different subsets of these interfaces. Because each object implements multiple interfaces and there is almost always overlap between objects, it isn't practical to map out each object separately.

Instead, you'll use Table 21-2 through 21-5 in Chapter 21 and this appendix to map out the core features of an object. For example, if you wanted to determine the complete set of methods and properties that are available for the WinNT Computer object, you would look at Table 21-3 and see that the object implements IADs, IADsComputer, IADsComputerOperations, IADsContainer, and IADsPropertyList. You would then examine each of these interfaces in order to determine available properties and methods that may be available to the WinNT Computer object.

With the LDAP and NDS providers, keep in mind that GenObject provides basic services for most objects. For example, with the LDAP Group object, Table 21-2 shows that ...

Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
and much more.

Read now

Unlock full access

More than 5,000 organizations count on O’Reilly

O’Reilly covers everything we've got, with content to help us build a world-class technology community, upgrade the capabilities and competencies of our teams, and improve overall team performance as well as their engagement.

Julian F.

Head of Cybersecurity

I wanted to learn C and C++, but it didn't click for me until I picked up an O'Reilly book. When I went on the O’Reilly platform, I was astonished to find all the books there, plus live events and sandboxes so you could play around with the technology.

Addison B.

Field Engineer

I’ve been on the O’Reilly platform for more than eight years. I use a couple of learning platforms, but I'm on O'Reilly more than anybody else. When you're there, you start learning. I'm never disappointed.

Amir M.

Data Platform Tech Lead

I'm always learning. So when I got on to O'Reilly, I was like a kid in a candy store. There are playlists. There are answers. There's on-demand training. It's worth its weight in gold, in terms of what it allows me to do.

Mark W.

Embedded Software Engineer

Publisher Resources

ISBN: 9780470386804Purchase book

Cloud Computing

Data Engineering

Data Science

AI & ML

Programming Languages

Software Architecture

IT/Ops

Security

Design

Business

Soft Skills

Microsoft® PowerShell, VBScript and JScript® Bible

by William R. Stanek, James O'Neill, Jeffrey Rosen

Appendix B. Core ADSI Reference

Using This Reference

Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
and much more.