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.