Product Documentation

Scopes

Jun 17, 2013

When you create a Site, the only available scope is the 'All' scope, which cannot be deleted.

You can create scopes using the procedure in this topic. You can also create scopes when you create an administrator; each administrator must be associated with at least one role and scope pair. When you are creating or editing desktops, machine catalogs, applications, or hosts, you can add them to an existing scope; if you do not add them to a scope, they remain part of the 'All' scope.

Site creation cannot be scoped, nor can Delegated Administration objects (scopes and roles). However, objects you cannot scope are included in the 'All' scope. (Full Administrators always have the All scope.) Machines, power actions, desktops, and sessions are not directly scoped; administrators can be allocated permissions over these objects through the associated machine catalogs or Delivery Groups.

Scope names can contain up to 64 Unicode characters; they cannot include the following characters: \ (backslash), / (forward slash), ; (semicolon), : (colon), # (pound sign) , (comma), * (asterisk), ? (question mark), = (equal sign), < (left arrow), > (right arrow), | (pipe), [ ] (left or right bracket), ( ) (left or right parenthesis), " (quotation marks), and ' (apostrophe). Descriptions can contain up to 256 Unicode characters.

To create a scope

  1. In Studio, click Configuration > Administrators in the left pane, then click the Scopes tab in the middle pane. A list of existing scopes appears.
  2. In the Actions pane, click Create new Scope.
  3. Type a name (for example, 'Sales') and a description (for example, 'Delivery Groups used by Sales') for the scope.
  4. Select object types or specific objects:
    1. To select all objects of a particular type (for example, Delivery Groups), select the object type.
    2. To select specific objects, expand the type, then select the individual objects (for example, individual Delivery Groups used by the Sales team).
  5. Click Save.

To copy a scope

You can create a scope by copying an existing scope.

  1. In Studio, click Configuration > Administrators in the left pane, then click the Scopes tab in the middle pane. A list of existing scopes appears.
  2. In the middle pane, select the scope you want to copy, then click Copy Scope in the Actions pane.
  3. Type a name and a description for the new scope.
  4. Edit the copied scope's object types and objects, as necessary.
  5. Click Save.

To edit a scope

  1. In Studio, click Configuration > Administrators in the left pane. then click the Scopes tab in the middle pane. A list of existing scopes appears.
  2. In the middle pane, select the scope you want to edit, then click Edit Scope in the Actions pane.
  3. Update the name, description, object types, and objects, as necessary.
    Important: Removing objects from a scope can make those objects inaccessible to the administrator who removed them. If the edited scope is paired with one or more roles, ensure that the updates you make to the scope do not make any role/scope pair unusable.
  4. Click Save.

To delete a scope

You cannot delete a scope if any administrator is using it.

  1. In Studio, select Configuration > Administrators in the left pane, then click the Scopes tab in the middle pane. A list of existing scopes appears.
  2. In the middle pane, select the scope you want to delete, then click Delete Scope in the Actions pane.
  3. When prompted, confirm the deletion.