WEDL_AssignedAccessWEDL_AssignedAccess

この Windows Management Instrumentation (WMI) プロバイダー クラスは、割り当てられたアクセスの設定を構成します。This Windows Management Instrumentation (WMI) provider class configures settings for assigned access.

構文Syntax

class WEDL_AssignedAccess {
    [Key] string UserSID;
    [Read, Write] string AppUserModelId;
    [Read] sint32 Status;
};

MembersMembers

次の表には、任意のメソッドとプロパティをこのクラスに属しているが一覧表示します。The following tables list any methods and properties that belong to this class.

メソッドMethods

このクラスには、メソッドは含まれません。This class contains no methods.

プロパティProperties

プロパティProperty データの種類Data type 修飾子Qualifiers 説明Description

UserSIDUserSID

stringstring

[キー][key]

割り当てられたアクセス アカウントとして使用するユーザー アカウントのセキュリティ識別子 (SID)。The security identifier (SID) for the user account that you want to use as the assigned access account.

AppUserModelIdAppUserModelId

stringstring

[読み取り、書き込み][read, write]

アプリケーション ユーザー モデル ID (AUMID)、Windows アプリの割り当てられたアクセス アカウント用に起動します。The Application User Model ID (AUMID) of the Windows app to launch for the assigned access account.

状態Status

ブール値Boolean

なしnone

割り当てられたアクセスの構成の現在の状態を示します。Indicates the current status of the assigned access configuration:

ValueValue 説明Description

00

有効なアカウントが構成されているが、Windows アプリが指定されていません。A valid account is configured, but no Windows app is specified. 割り当てられたアクセスが有効になっていません。Assigned access is not enabled.

11

割り当てられたアクセスが有効になっているとします。Assigned access is enabled.

0x1000x100

UserSID エラー: アカウントを見つけることができません。UserSID error: cannot find the account.

0x1030x103

UserSID エラー: アカウント プロファイルが存在しません。UserSID error: the account profile does not exist.

0x2000x200

AppUserModelID エラー: Windows アプリを見つけることができません。AppUserModelID error: cannot find the Windows app.

0x2010x201

タスク スケジューラのエラー:タスクをスケジュールできませんでした。Task Scheduler error: Could not schedule task. タスク スケジューラ サービスが実行されていることを確認します。Make sure that the Task Scheduler service is running.

0 xffffffff0xffffffff

指定されていないエラーです。Unspecified error.

注釈Remarks

割り当てられたアクセスの変更; で現在署名されているすべてのセッションを与えません。サインアウトして、もう一度サインインする必要があります。Changes to assigned access do not affect any sessions that are currently signed in; you must sign out and sign back in.

Example

次の Windows PowerShell スクリプトでは、このクラスを使用して、割り当てられたアクセス アカウントを設定する方法を示します。The following Windows PowerShell script demonstrates how to use this class to set up an assigned access account.

#
#---Define variables---
#

$COMPUTER = "localhost"
$NAMESPACE = "root\standardcimv2\embedded"

# Define the assigned access account. 
# To use a different account, change $AssignedAccessAccount to a user account that is present on your device.

$AssignedAccessAccount = "KioskAccount"

# Define the Windows app to launch, in this example, use the Application Model User ID (AUMID) for Windows Calculator.
# To use a different Windows app, change $AppAUMID to the AUMID of the Windows app to launch.
# The Windows app must be installed for the account.

$AppAUMID = "Microsoft.WindowsCalculator_8wekyb3d8bbwe!App"

#
#---Define helper functions---
#

function Get-UsernameSID($AccountName) {

# This function retrieves the SID for a user account on a machine.
# This function does not check to verify that the user account actually exists.

    $NTUserObject = New-Object System.Security.Principal.NTAccount($AccountName)
    $NTUserSID = $NTUserObject.Translate([System.Security.Principal.SecurityIdentifier])

    return $NTUserSID.Value
}

#
#---Set up the new assigned access account---
#

# Get the SID for the assigned access account.

$AssignedAccessUserSID = Get-UsernameSID($AssignedAccessAccount)

# Check to see if an assigned access account is already set up, and if so, clear it.

$AssignedAccessConfig = get-WMIObject -namespace $NAMESPACE -computer $COMPUTER -class WEDL_AssignedAccess

if ($AssignedAccessConfig) {

# Configuration already exists.  Delete it so that we can create a new one, since only one assigned access account can be set up at a time.

    $AssignedAccessConfig.delete();

}

# Configure assigned access to launch the specified Windows app for the specified account.

Set-WmiInstance -class WEDL_AssignedAccess -ComputerName $COMPUTER -Namespace $NAMESPACE -Arguments @{
        UserSID = $AssignedAccessUserSID;
        AppUserModelId = $AppAUMID
        } | Out-Null;

# Confirm that the settings were created properly.

$AssignedAccessConfig = get-WMIObject -namespace $NAMESPACE -computer $COMPUTER -class WEDL_AssignedAccess

if ($AssignedAccessConfig) {

    "Set up assigned access for the " + $AssignedAccessAccount + " account."
    "  UserSID = " + $AssignedAccessConfig.UserSid
    "  AppModelId = " + $AssignedAccessConfig.AppUserModelId

} else {

    "Could not set up assigned access account."
}

要件Requirements

Windows エディションWindows Edition サポート対象Supported
Windows 10 HomeWindows 10 Home XNo
Windows 10 ProWindows 10 Pro Yes
Windows 10 EnterpriseWindows 10 Enterprise Yes
Windows 10 EducationWindows 10 Education Yes