Cmdlets

Choose a cmdlet from the list on the left or search for a specific cmdlet. Choose a cmdlet from the list or search for a specific cmdlet.
About Help  Providers
 

Set-AssignedAccess

Set-AssignedAccess

assignedaccess

Synopsis

Configures a user to launch only one app.

Syntax

Set-AssignedAccess [-AppName] [-UserName] [-Confirm] [-WhatIf] [<CommonParameters>]

Set-AssignedAccess [-AppName] [-UserSID] [-Confirm] [-WhatIf] [<CommonParameters>]

Set-AssignedAccess [-AppUserModelId] [-UserName] [-Confirm] [-WhatIf] [<CommonParameters>]

Set-AssignedAccess [-AppUserModelId] [-UserSID] [-Confirm] [-WhatIf] [<CommonParameters>]

Detailed Description

The Set-AssignedAccess cmdlet configures the specified user account so that it can use only one Windows Store app. The user cannot exit the app, sign out, or access any 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.

Parameters

-AppName <String>

Specifies the name of the installed Windows Store app to use for assigned access. Wildcard characters are accepted.

Aliases

None

Required?

true

Position

named

Default value

Accept pipeline input?

false

Accept wildcard characters?

true

-AppUserModelId <String>

Specifies the Application User Model ID (AppUserModelID) for the installed Windows Store app to use for assigned access. The AppUserModelID is found in the app's AUMIDs.txt file.

Aliases

AUMID

Required?

true

Position

named

Default value

Accept pipeline input?

false

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.

Aliases

None

Required?

true

Position

named

Default value

Accept pipeline input?

false

Accept wildcard characters?

false

-UserSID <String>

Specifies the security identifier (SID) for the local user account to use for assigned access. This account cannot be a domain account or an administrator account.

Aliases

None

Required?

true

Position

named

Default value

Accept pipeline input?

false

Accept wildcard characters?

false

-Confirm <SwitchParameter>

Prompts you for confirmation before running the cmdlet.

Aliases

None

Required?

false

Position

named

Default value

false

Accept pipeline input?

false

Accept wildcard characters?

false

-WhatIf <SwitchParameter>

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Aliases

None

Required?

false

Position

named

Default value

false

Accept pipeline input?

false

Accept wildcard characters?

false

Input Type

None.

Return Type

System.Object

Notes

To get a list of all the Windows Store apps installed for a user account, use the Get-AppxPackage cmdlet as follows: Get-AppxPackage -User username

Examples

EXAMPLE 1

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

PS C:\> Set-AssignedAccess -UserSID S-1-5-21-523423449-2432423479-234123443-1004 -AppName CustomApp

EXAMPLE 2

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

PS C:\> Set-AssignedAccess -UserName UserName -AUMID microsoft.windowsphotos_8wekyb3d8bbwe!app

Online Version
Get-AssignedAccess
Clear-AssignedAccess