Control v Start a control session with the computer | Apple 3

CAppleScript Remote Desktop Suite

C

Appendix

This appendix shows the contents of Remote Desktop’s AppleScript Dictionary.

This appendix is not a substitute for the AppleScript Dictionary view in Script Editor. It is included as a quick reference so that AppleScript commands might be found by a search of PDF contents. The Dictionary itself has the most recent information about scriptable objects and events in Remote Desktop, and better usability.

Classes and Commands for the Remote Desktop Application.

add v: Add a computer to a task.

add computer: The computer.

to computer list: The computer list (or task) to add the computer to.

control v: Start a control session with the computer.

control computer: The computer to control.

execute v: Executes a task.

execute task: The task to execute.

[on computer list]: The computer list (or computer) on which to run the task.

observe v: Start an observation session.

observe item: The computer, list, or computer list to observe.

release v: Release computers from a control or observation session.

release item: The computer, list, or computer list to release.

remove v: Remove a computer from a task.

remove computer: The computer to remove.

from computer list: The computer list (or task) to remove the computer from.

stop v: Stops an executing share screen task.

stop task: The task to stop.

174

Image 174

Apple 3 manual Control v Start a control session with the computer, Execute v Executes a task

Contents

Administrator’s Guide Apple Computer, Inc Apple Computer, Inc. All rights reserved Contents Apple Remote Desktop Administrator Access Administrator ComputerUnderstanding and Controlling Access Privileges Using Local Accounts Remote Desktop Authentication and Data Transport Encryption Setting Up the Network and Maintaining SecuritySetting Up the Network Switching Between Control and Observe Modes Keeping Track of Task Progress and History Administering Client ComputersUsing the Task Feedback Display Enabling a Task Notification Script Appendix a 161 Icon and Port Reference Client Status Icons Appendix D Appendix BAppendix C Index What Is Apple Remote Desktop? About This Book Using This Guide Remote Desktop HelpNotation Conventions Where to Find More Information About Apple Remote Desktop Terminal Command Conventions Preface About This Book Using Apple Remote Desktop Administering Computers Using Apple Remote Desktop Distributing Installer Packages Deploying Software Using Network Install Images Using NetBoot Images Distributing Preference Files Using Unix Shell ScriptsVerifying Installations Distributing Drag-and-Drop Applications Taking Inventory ARD SQL Spotlight File Search Administration Settings ReportFile Search Report Software Version Report Application Usage Report Network Test ReportGenerating Your Own Reports Managing Power State Housekeeping Supporting Users Chatting with the User Providing Help Desk SupportRequesting Help Screen Monitoring Screen Sharing Using ReportsScreen Controlling Deploying New Software or Files Monitoring Student Computers Using Text MessagesInteracting with Students Sharing Screens Finding More Information To learn more about See information for Starting on Getting to Know Remote Desktop Remote Desktop Human Interface Guide Remote Desktop Main Window Getting to Know Remote Desktop Getting to Know Remote Desktop Task Dialogs ABG Control and Observe Window C D E F G HI Multiple-Client Observe Window HA B CI Report Window DEF Changing Report Layout To change what information is displayed To customize the application toolbar Configuring Remote DesktopCustomizing the Remote Desktop Toolbar To open the Preferences window Interface Tips and Shortcuts Computers can be selected from any window Drag and drop works on configuration dialogs Making lists from reports or other listsSaved Tasks and Task Templates save you time Administrator and client computers NetBoot and Network Install optionalSystem Requirements for Apple Remote Desktop Installing the Remote Desktop Administrator Software Network Requirements Upgrading the Remote Desktop Administrator Software Method #1-Remote Upgrade Installation Upgrading the Client Software Method #2-Manual Installation Upgrading Apple Remote Desktop Clients Using SSHTo manually upgrade the client software Creating a Custom Client Installer To upgrade existing client software using SSHTo create the client installer Installing Apple Remote Desktop Considerations for Managed Clients Uninstalling the Administrator SoftwareTo remove the administrator software Removing or Disabling Apple Remote Desktop To disable the client software on a client computer Disabling the Client Software Uninstalling the Client Software from Client Computers To uninstall client software Computer Lists Finding Clients by Searching the Local Network Finding Clients by Searching a Network RangeTo search for clients on the local network Finding Clients by Network Address To search a range of network addressesTo search for a specific address To import a list of computers from a file Finding Clients by File ImportMaking a New Scanner To make a custom search list Making and Managing Lists About Apple Remote Desktop Computer Lists Creating a Smart Computer List Creating an Apple Remote Desktop Computer ListDeleting Apple Remote Desktop Lists To create an Apple Remote Desktop computer list To edit a smart computer list Editing a Smart Computer ListTo create a smart computer list To create an list of computer lists Importing and Exporting Computer Lists To transfer the computer lists To transfer the computer lists To transfer the computer lists Access Privileges Apple Remote Desktop Administrator Access Select To allow administrators to To set administrator privileges on a computer Creating Administrator Access Groups To create an administrator access groupMethod #1 Understanding and Controlling Access Privileges Understanding and Controlling Access Privileges To enable Apple Remote Desktop authorization by group Apple Remote Desktop Guest AccessEnabling Directory Services Group Authorization Method #2 Apple Remote Desktop Nonadministrator Access To allow guest accessLimiting Features in the Administrator Application Virtual Network Computing Access To enable User Mode Command-Line SSH Access Managing Client Administration Settings and PrivilegesTo allow VNC access To get an administration settings report Getting an Administration Settings ReportChanging Client Administrator Privileges To change administrator privileges on each computer Understanding and Controlling Access Privileges Setting Up the Network Maintaining Security Setting Up the Network Setting Up the Network and Maintaining Security Getting the Best Performance Maintaining Security Administrator Application Security Password Access SecurityUser Privileges and Permissions Security Remote Desktop Authentication and Data Transport Encryption Physical Access SecurityEncrypting Observe and Control Network Data To enable Observe and Control transport encryption To set a default encryption preference for file copies Interacting with Users Controlling Controlling Apple Remote Desktop Clients Control Window Options To control an Apple Remote Desktop client To switch between complete control and shared mouse modes Switching Between Control and Observe ModesTo switch between control and observe modes Sharing Control with a User Hiding a User’s Screen While Controlling To switch between standard control and curtain modesTo switch between full screen and in-a-window modes Capturing the Control Window to a File Controlling VNC Servers To share clipboard content with the clientSharing Clipboards for Copy and Paste To control a VNC client computer Setting up a Non-Mac OS X VNC Server Basic steps areApple Remote Desktop Control and the PC’s Ctrl-Alt-Del To set a custom port on an existing computer list member To set a custom VNC port when adding a computer by addressVNC Control Options To designate a display to control To configure a client to accept VNC connections Observing Dealing With Many Client Screens Getting More Information on Observed Clients Changing Observe Settings While Observing To change your observe settings To change your observe window titles Changing Screen Titles While ObservingViewing a User’s Account Picture While Observing To view a user’s account picture Icon Indicates To show system status in the observe window Shortcuts in the Multiple Screen Observe WindowObserving a Single Computer To observe a single computer Observing a Computer in Dashboard To observe using DashboardObserving Multiple Computers To observe multiple computers Interactive Chat Sending MessagesSending One-Way Messages To send a one-way text message Sharing a Screen with Client Computers Sharing ScreensViewing Attention Requests To view attention requests To request administrator attention Interacting with Your Apple Remote Desktop AdministratorRequesting Administrator Attention Monitoring a Screen Sharing Tasks To change your login icon Canceling an Attention RequestTo cancel an attention request Changing Your Observed Client Icon Administering Client Computers Keeping Track of Task Progress and History To enable a task notification script Enabling a Task Notification Script Using the Task Feedback Display Getting Active Task StatusStopping a Currently Running Task To stop a currently running task Getting Completed Task HistorySaving a Task for Later Use To get status on a completed task Creating and Using Task Templates To create a task templateTo apply a task template Editing a Saved Task Installing Software Using Apple Remote DesktopInstalling by Package and Metapackage To edit a saved task To copy and install software using a .pkg file Installing Software on Offline Computers To install software on offline clients To install software by copying Installing by Using the Copy Items CommandUsing Installers from Other Companies To install software with third-party installers To upgrade software on client computers Upgrading Software Copying Files Copy Options Post-Copy Action Copying from Administrator to ClientsMore Options When the Item Already Exists To copy items to clients Copying from the Finder to a Client Copying Using Drag and DropTo copy items from a client to the administrator’s computer To copy items from the Finder to a client To restore files using the Copy Items command Restoring Items from a Master Copy Creating Reports Collecting Report Data Using a Task Server for Report Data Collection To set up a Task Server, you need to Report Database Recommendations and Bandwidth Usage Auditing Client Usage Information System Report SizeGenerating a User History Report To generate a User History report Generating an Application Usage ReportTo generate an Application Usage report Using Spotlight to Find Items To search for software items using SpotlightFinding Files, Folders, and Applications Generating a File Search Report To search for software items To generate a Software Version report Comparing SoftwareGenerating a Software Version Report Generating a Software Difference Report Auditing Hardware To generate a Software Difference reportTo get a basic System Overview report Getting Storage Information Getting Serial NumbersTo generate a serial number report To generate a Storage report Getting FireWire Device Information To generate a FireWire Devices reportGetting USB Device Information To generate a USB Devices report Getting Network Interface InformationTo generate a Network Interfaces report Getting Memory Information To generate a Memory reportGetting PCI Card Information To generate a Network Test report Testing Network ResponsivenessTo generate a PCI Cards report Evaluating the Network Test Report Exporting Report Information To export a report Using Report Windows to Work with Computers Maintaining Systems Deleting ItemsTo delete an item from a client To empty the Trash Setting the Startup DiskEmptying the Trash To set the startup disk Renaming Computers Synchronizing Computer TimeTo rename a computer Setting Computer Audio Volume To set a computer’s audio volumeTo synchronize client computer clocks To repair a computer’s file permissions Repairing File PermissionsAdding Items to the Dock To add an application or other item to the Dock Changing Energy Saver Preferences To change the Energy Saver preferences Changing Sharing Preferences for Remote Login Setting Printer PreferencesTo change the Remote Login sharing preference To set up printer preferences using Copy Items To set up printer preferences using Send Unix Command Managing Computers Opening Files and Folders Opening Applications To open an itemTo open an application To quit an open application Quitting Applications Without Logging Out the UserPutting a Computer to Sleep To put a computer to sleep Waking Up a Computer Locking a Computer ScreenTo wake a computer To lock a computer screen Displaying a Custom Picture on a Locked ScreenUnlocking a Computer Screen To create a custom locked screen picture Disabling a Computer Screen Logging In a User at the Login WindowTo disable a computer screen while you work To log in a user To log out a user Logging Out the Current UserRestarting a Computer To restart a computer Shutting Down a Computer To shut down a computer Unix Shell Commands Send Unix Command Templates Template sub-menu Template name To execute a single Unix command Executing a Single Unix CommandExecuting Scripts Using Send Unix Command Executing Shell Scripts with Remote Desktop Executing AppleScripts with Remote Desktop To execute an AppleScript using the Send Unix CommandTo copy and execute a script To send and execute an AppleScript Built-in Command-Line Tools Using networksetup Few of the capabilities of networksetup are listed below Using systemsetup Few of the capabilities of systemsetup are listed below 150 Using kickstart Shut down the Apple Remote Desktop Agent process Setting the Client’s Data Reporting Policy Automating Functions Creating a Template Data Reporting Policy To set a client’s data reporting policy To set the default data reporting policy template To set the Task Server location Setting Scheduled TasksScheduled Tasks To schedule a task To edit a task schedule Using AppleScript with Remote DesktopEditing Scheduled Tasks Deleting Scheduled Tasks Computer list n inh. item a list which holds computers Using the Remote Desktop AppleScript DictionaryRemote Desktop’s AppleScript Basics Add v Add a computer to a task To access the full AppleScript dictionary for Remote Desktop Sample AppleScript Using Automator with Remote Desktop 160 Apple Remote Desktop Status Icons Appendix List Menu Icons Task Status Icons System Status Icons Basic System Status Icons Detailed TCP and UDP Port Reference Port Protocol Function Report Field Definitions Reference B System Overview Report 166 167 Storage Report HFS, HFS+, UFS Memory Report FireWire Devices ReportUSB Devices Report PCI Cards Report Network Interfaces Report 171 Administration Settings Report Network Test Report Application Usage Report User History Report Observe v Start an observation session Control v Start a control session with the computerExecute v Executes a task Remove v Remove a computer from a task Elements Computer n inh. item a physical computer Contained by application Message Unicode text Message to display on the screens Restart task n inh. task item Restart the target computers Shutdown task n inh. task item Shutdown the target computers Wake up task n inh. task item Wake up the target computers Sample list of main database schema Sample list of system information table Sample list of property names Sample list of table from one computer Index 183 184