Apple 3 specs

178

naming uniquely (boolean): Should each machine be forced to have a numerically unique name

target name (Unicode text): The new name for the computer.

restart task n [inh. task > item]: Restart the target computers.

ELEMENTS

contained by application.

PROPERTIES

user can save changes or cancel (boolean): Is the user allowed to save changes or cancel the restart

send message task n [inh. task > item]: Send a text message to the target computers.

ELEMENTS

contained by application.

PROPERTIES

message (Unicode text): Message to display on the screen(s).

send unix command task n [inh. task > item]: Send a UNIX command or script to the target computers.

ELEMENTS

contained by application.

PROPERTIES

script (Unicode text): The command string to be executed.

showing output (boolean): Should the complete output of command be displayed in a window

user (Unicode text): The user to execute the command as.

set local startup disk task n [inh. task > item]: Set the startup volume on the target computers.

ELEMENTS

contained by application.

PROPERTIES

boot volume (Unicode text): Specific volume of drive to boot (optional).

restarting (boolean): Should the machine be restarted after setting the startup volume

set network startup disk task n [inh. task > item]: Set the startup volume on the target computers.

ELEMENTS

contained by application.

PROPERTIES

from server (Unicode text): Internet address of the server to boot from.

mount volume (Unicode text): Volume name on server to mount.

restarting (boolean): Should the machine be restarted after setting the startup volume

Appendix C AppleScript Remote Desktop Suite

Image 178

Apple 3 manual Restart task n inh. task item Restart the target computers

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 Remote Desktop Help Using This GuideNotation 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 Network Test Report Application Usage 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 Making lists from reports or other lists Drag and drop works on configuration dialogsSaved Tasks and Task Templates save you time NetBoot and Network Install optional Administrator and client computersSystem 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 Upgrading Apple Remote Desktop Clients Using SSH Method #2-Manual InstallationTo manually upgrade the client software To upgrade existing client software using SSH Creating a Custom Client InstallerTo 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 a Network Range Finding Clients by Searching the Local NetworkTo search for clients on the local network To search a range of network addresses Finding Clients by Network AddressTo 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 To create an administrator access group Creating Administrator Access GroupsMethod #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 To allow guest access Apple Remote Desktop Nonadministrator AccessLimiting Features in the Administrator Application Virtual Network Computing Access To enable User Mode Managing Client Administration Settings and Privileges Command-Line SSH AccessTo 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 Password Access Security Administrator Application SecurityUser Privileges and Permissions Security Physical Access Security Remote Desktop Authentication and Data Transport EncryptionEncrypting 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 Basic steps are Setting up a Non-Mac OS X VNC ServerApple 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 Getting Active Task Status Using the Task Feedback DisplayStopping 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 To create a task template Creating and Using Task TemplatesTo 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 System Report Size Auditing Client Usage InformationGenerating a User History Report Generating an Application Usage Report To generate a User History reportTo generate an Application Usage report To search for software items using Spotlight Using Spotlight to Find ItemsFinding 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 To generate a Software Difference report Auditing HardwareTo get a basic System Overview report Getting Storage Information Getting Serial NumbersTo generate a serial number report To generate a Storage report To generate a FireWire Devices report Getting FireWire Device InformationGetting USB Device Information Getting Network Interface Information To generate a USB Devices reportTo generate a Network Interfaces report To generate a Memory report Getting Memory InformationGetting 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 Deleting Items Maintaining SystemsTo delete an item from a client To empty the Trash Setting the Startup DiskEmptying the Trash To set the startup disk Synchronizing Computer Time Renaming ComputersTo rename a computer To set a computer’s audio volume Setting Computer 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 Setting Printer Preferences Changing Sharing Preferences for Remote LoginTo 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 To open an item Opening ApplicationsTo 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 Locking a Computer Screen Waking Up a ComputerTo 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