Set-AssignedAccess (Industry 8.1)

7/8/2014

Review the syntax, parameters, and examples for the Set-AssignedAccess Windows PowerShell cmdlet for Windows Embedded 8.1 Industry (Industry 8.1).

Configures a user to only launch one application.

Syntax

Set-AssignedAccess -AppUserModelId <string> -UserName <string> [<CommonParameters>]
Set-AssignedAccess -AppName <string> -UserName <string> [<CommonParameters>]
Set-AssignedAccess -AppUserModelId <string> -UserSID <string> [<CommonParameters>]
Set-AssignedAccess -AppName <string> -UserSID <string> [<CommonParameters>]

Parameters

• -AppName <string>
  Specifies the name of the installed Windows Store app to use for assigned access. Wildcard characters are accepted.

  You can use AppName for any app that is returned by Get-AppxPackage. Get-AppxPackage does not return the browser. To use the browser for assigned access, use the AppUserModelId parameter instead of AppName.

  Required?	true
  Accept Wildcard Characters?	true

• -AppUserModelId <string>
  Specifies the Application User Model ID (AppUserModelID) for the installed Windows Store app to use for assigned access.

  Required?	true
  Accept Wildcard Characters?	false

• -UserName <string>
  Specifies the local user account name to use for assigned access. This cannot be a domain account or an administrator account.

  Required?	true
  Accept Wildcard Characters?	false

• -UserSID <string>
  Specifies the security identifier (SID) for the account to use for assigned access. This account cannot be a domain account or an administrator account.

  Required?	true
  Accept Wildcard Characters?	false

• <CommonParameters>
  This command supports the following common parameters that are implemented by Windows PowerShell: Verbose, Debug, ErrorAction, ErrorVariable, OutBuffer, OutVariable, WarningAction, and WarningVariable. For more information, see about_CommonParameters on MSDN.

Description

The Set-AssignedAccess cmdlet configures assigned access so that a specific user can use only one app. The user cannot exit the app, sign out, or access system settings. If a user is signed in or the PC has a PS/2 keyboard, you must restart the computer to apply the changes. To sign out of assigned access, quickly press the left Windows logo key five times.

Remarks

To get a list of all the applications installed for a user account, use the Get-AppxPackage cmdlet as follows: (Get-AppxPackage -User username ). For more information, type "Get-Help Set-AssignedAccess -detailed". For technical information, type "Get-Help Set-AssignedAccess -full".

Examples

• EXAMPLE 1

  Set-AssignedAccess -UserSID S-1-5-21-523423449-2432423479-234123443-1004 -AppName CustomApp
  

  -----------

  Description

  -----------

  This example shows how to configure assigned access by using the user SID and the app name.

• EXAMPLE 2

  Set-AssignedAccess -UserName UserName -AppUserModelId microsoft.windowsphotos_8wekyb3d8bbwe!app
  

  -----------

  Description

  -----------

  This example shows how to configure assigned access by using the user name and AppUserModelID.

• EXAMPLE 3

  Set-assignedaccess –username UserName -AppUserModelId ‘DefaultBrowser_NOPUBLISHERID!Microsoft.InternetExplorer.Default’
  

  -----------

  Description

  -----------

  This example shows how to configure assigned access for the browser.

See Also

Concepts

Assigned access Windows PowerShell reference