ワークスペース環境管理 2407

動的トークン

動的トークンは、任意のWorkspace Environment Managementで使用できます アクション それらをより強力にするために。

動的トークンは、次のフィールドで使用できます。

  • グループポリシー設定

    • アクション に設定 削除 価値: 価値
    • アクション に設定 設定値 そして 種類 に設定 REG_SZ:価値、データ
    • アクション に設定 設定値 そして 種類 に設定 REG_EXPAND_SZ:価値、データ
    • アクション に設定 設定値 そして 種類 に設定 REG_MULTI_SZ:価値、データ

注意:

グループ ポリシー設定には、マシン設定とユーザー設定の 2 種類があります。 マシン設定では、一部の動的トークンはサポートされていません。 見る グループ ポリシー設定の動的トークンのサポート.

グループポリシー設定の動的トークンサポート

動的トークンの使用 グループ ポリシー設定 さまざまな環境での適応性の高いポリシー設定が可能になり、手動設定が削減され、ポリシー管理が簡素化されます。

グループ ポリシー設定には、次の 2 種類があります。

  • マシン設定。 これらの設定は、ログオンするユーザーに関係なく、マシンにのみ適用されます。
  • ユーザー設定。 これらの設定は、ログオンするマシンに関係なく、ユーザーにのみ適用されます。

すべての動的トークンは、グループ ポリシー設定でサポートされています。 次のものは、マシン設定ではサポートされていません。

  • ハッシュタグ

    • ##FullUserName##
    • ##UserInitials##
    • ##ClientName##
    • ##ClientIPAddress##
    • ##UserLDAPPath##
    • ##ClientRemoteOS##
  • ADAttribute(アトリビュート)
    • [ADAttribute:attrName]
    • [UserParentOU:レベル]
  • HKCUのレジストリ

アプリケーション

  • インストールアプリケーション アプリケーションの種類として: コマンドライン, 作業ディレクトリそして パラメーター
  • ファイル/フォルダ アプリケーションの種類として: ターゲット
  • 関連URL アプリケーションの種類として: ショートカットURL
  • アイコンファイル

プリンター

  • ターゲットパス

ネットワークドライブ

  • ターゲットパス そして 表示名

仮想ドライブ

  • ターゲットパス

レジストリ

  • ターゲットパス, ターゲット名そして 目標値

注意:

目標値 フィールドは環境変数の拡張をサポートしていません。 環境変数を使用すると、期待どおりに機能しません。

環境変数

  • 変数値

ポート

  • ポートターゲット

Ini ファイル

  • ターゲットパス, ターゲットセクション, ターゲット値の名前そして 目標値

注意:

ターゲットセクション, ターゲット値の名前そして 目標値 フィールドは環境変数の拡張をサポートしていません。 環境変数を使用すると、期待どおりに機能しません。

外部タスク

  • パス そして 引数

ファイルシステムの操作

  • ソースパス そして ターゲットパス

特定のフィルター条件

  • 例: と 条件の種類として Active Directory 属性の一致* : **テスト済みの Active Directory 属性 そして マッチング結果

注意:

フィルター条件でサポートされているフィールドの完全なリストについては、次を参照してください。 フィルター条件の支持性マトリックス.

文字列操作

スクリプト内の文字列を操作して、ドライブをマップしたり、アプリケーションを起動したりする必要がある場合があります。 Workspace Environment Management エージェントは、次の文字列操作を受け入れます。

モーダル 説明 例:
#Left(文字列,長さ)# 左側に指定された文字数を返します。 #Left(ABCDEF,2)# 収益 血液型
#Right(文字列,長さ)# 右側に指定された文字数を返します。 #Right(ABCDEF,2)# 収益 エフ
#Truncate(文字列,長さ)# 文字列の長さが指定した長さ以下の場合は、文字列全体を返します。 文字列の長さが指定した長さより大きい場合は、左側に指定した文字数を返します。 #Truncate(ABCDEF,3)# 収益 甲乙丙
&トリム (文字列)& 文字列の先頭と末尾の空白をすべて削除します。 &トリム( a b c )& 収益 a b c
&RemoveSpaces(文字列)& 文字列の空白をすべて削除します。 &RemoveSpaces( a b c )& 収益 甲乙丙
&Expand(文字列)& 文字列に \% で囲まれた環境変数が含まれている場合は、変数を展開します。 &拡大(%userprofile%\destop)& 収益 C:\Users\Jill\デスクトップ
$Split(文字列、スプリッタ],インデックス)$ [] で囲まれたスプリッタに基づいて文字列を部分文字列に分割し、インデックス付きの部分文字列を返します。 $Split(abc-def-hij,[-],2)$ 収益 ヒジ
#Mid(文字列,開始インデックス)# 文字列内の指定されたインデックスから開始し、その後のすべての文字を返します。 #Mid(ABCDEF,2)# 収益 cdef の
!Mid(文字列,開始インデックス,長さ)! 文字列内の指定されたインデックスから開始し、指定された文字数を返します。 !ミッド(abcdef,1,2)! 収益 紀元前
!substring(文字列,開始インデックス,長さ)! 文字列内の指定されたインデックスから開始し、指定された文字数を返します。 !部分文字列(abcdef,1,2)! 収益 紀元前
#Mod(文字列,長さ)# 文字列を長さで除算し、余りを返します。 文字列は整数に変換できる必要があります。 #Mod(7,3)# 収益 1

注意:

  • 文字列操作は、ハッシュタグと Active Directory 属性でもサポートされています。 例えば: #Left([AD属性:名前],2)# ここで、現在のドメイン・ユーザーの name 属性は 管理者 収益 広告そして $Split(##ClientIPAddress##,[\.],2)$ 収益 157.
  • !Mid(文字列,開始インデックス,長さ)! そして !substring(文字列,開始インデックス,長さ)! 操作は常に最後に実行されます。

ハッシュタグ

ハッシュタグは、Workspace Environment Management アイテムの処理で広く使用されている代替機能です。 次の例は、ハッシュタグの使用方法を示しています。

に書き込むには .ini ファイル、 %UserName%.ini ファイルのパスとWorkspace Environment Managementはそれを処理し、最終的なディレクトリを展開します。 ただし、Workspace Environment Management が書き込む値を評価するには、 .ini それ自体はもっと複雑です:あなたは書きたいかもしれません %UserName% 文字通り、または展開された値を書き込むことができます。

柔軟性を高めるために、 ##UserName## はハッシュタグとして存在するため、 %UserName% 値のためには、それを文字通り書きます。 ##UserName## 展開された値を書き込みます。

例については、次の表を参照してください。

モーダル 説明 例:
##UserName## 展開された環境変数 “%username%” ジル
##UserProfile## 展開された環境変数 “%userprofile%” C:\Users\ジル
##FullUserName## Active Directory でユーザーのフル ネームを返します ジル・チョウ
##UserInitials## Active Directory のユーザー名のイニシャルを返します。 JCの
##UserAppData## 特別なフォルダの実際のパスを返します - RoamingAppData C:\ Users \ Jill \ AppData\Rオーミング
##UserPersonal## 特別なフォルダの実際のパスを返します - ドキュメント C:\ユーザー\ジル\ドキュメント
##UserDocuments## 特別なフォルダの実際のパスを返します - ドキュメント C:\ユーザー\ジル\ドキュメント
##UserDesktop## 特別なフォルダの実際のパスを返します - デスクトップ C:\ Users \ Jill \ Desktopの
##UserFavorites## 特別なフォルダの実際のパスを返します - お気に入り C:\Users\Jill\お気に入り
##UserTemplates## 特別なフォルダの実際のパスを返します - テンプレート C:\ Users \ Jill \ AppData\Roaming\マイクロソフト\Windows\Tエンプレート
##UserStartMenu## スペシャルフォルダの実際のパスを返します - StartMenu C:\ Users \ Jill \ AppData\Roaming\マイクロソフト\Windows\スタートメニュー
##UserStartMenuPrograms## 特別なフォルダの実際のパスを返します - プログラム C:\ Users \ Jill \ AppData\Roaming\Microsoft\Windows\スタートメニュー\プログラム
##UserLocalAppData## 特別なフォルダの実際のパスを返します - LocalAppData C:\Users\Jill\AppData\ローカル
##UserMusic## 特別なフォルダの実際のパスを返します - 音楽 C:\ Users \ Jill \ ミュージック
##UserPictures## 特別なフォルダの実際のパスを返します - 画像 C:\ Users \ Jill \ Pictures
##UserVideos## 特別なフォルダの実際のパスを返します - ビデオ C:\Users\Jill\Videos
##UserDownloads## 特別なフォルダの実際のパスを返します - ダウンロード C:\Users\Jill\ダウンロード
##UserLinks## 特別なフォルダの実際のパスを返します - リンク C:\Users\Jill\Links
##UserContacts## 特別なフォルダの実際のパスを返します - 連絡先 C:\Users\Jill\連絡先
##UserSearches## 特別なフォルダの実際のパスを返します - SavedSearches C:\Users\Jill\Searches(英語)
##commonprograms## 特別なフォルダの実際のパスを返します - CommonPrograms C:\ProgramData\Microsoft\Windows\スタートメニュー\プログラム
##ComputerName## マシンの名前を返します WIN10EN-LR3B66L
##ClientName## クライアントマシンの名前を返します W2K16ST-5IS28JP
##ClientIPAddress## クライアントマシンのIPアドレスを返します 10.150.153.138
##IpAddress## マシンのIPアドレスを返します 10.150.153.213
##ADSite## マシンがメンバーである Active Directory サイトを返します NKGの
##DefaultRegValue## - 常に文字列。空
##UserLDAPPath## 現在のユーザーの識別名を返します CN=Jill Chou,OU=ユーザーアカウント,OU=APAC,DC=citrite,DC=net
##VUEMAgentFolder## エージェントフォルダを返します C:\Program Files (x86)\Citrix\Workspace Environment Management Agent
##RDSSessionID## リモートデスクトップセッションIDを返します 2
##RDSSessionName## リモート・デスクトップ・セッション名を返します RDP-TCPの#72
##ClientRemoteOS## 仮想デスクトップへの接続に使用したマシンのオペレーティングシステムを返します ウィンドウズ
##ClientOSInfos## マシンのOS情報を返します Windows 10 Enterprise 64 ビット

ハッシュタグ ##UserScreenCaptureComment## 製品の特定の部分で使用するために実装されています。 このタグは、メールテンプレートの 詳細設定 > UI エージェントのパーソナライゼーション > ヘルプデスクオプション. 含まれている場合、エージェントの画面キャプチャ ユーティリティの画面キャプチャの下にあるコメント フィールドがユーザーに表示されます。 コメントは、メールテンプレートにタグを配置した場所のサポートメールに含まれています。

Active Directory 属性

Active Directory 属性を操作するために、WEM は [ADAttribute:attrName] value は、関連する Active Directory 属性に置き換えます。 [ADAttribute:attrName]は、任意のActive Directory属性の動的トークンです。 指定された属性の値をチェックする関連フィルターがあります。

ユーザー組織単位 (OU) 構造の場合、WEM は [UserParentOU:レベル] value は、関連する Active Directory OU 名に置き換えます。 Active Directory パスは Active Directory 内の完全なユーザー パス (LDAP) であり、[UserParentOU:level] はそのサブセットです。

たとえば、ユーザーが属する OU のネットワーク ドライブを構築するとします。 ネットワークドライブパスの動的トークン[UserParentOU:level]を使用して、ユーザーのOUを動的に解決できます。 動的トークンを使用するには、次の 2 つの方法があります。

  • [UserParentOU:level]動的トークンをネットワークドライブパスで直接使用します。 たとえば、’\Server\Share[UserParentOU:0]' というパスを使用できます。
  • OU という環境変数を設定し、その値を [UserParentOU:0] に設定します。 その後、ドライブを ‘\Server\Share\ としてマップできます%OU%`.

注意:

  • 数字の「0」は、OU構造で到達したいレベルに対応する番号に置き換えることができます。
  • パスに変数を追加できます。 これを行うには、OU レイアウトに一致する正確なフォルダー構造があることを確認します。

また、フィルタリングの目的で Active Directory 属性を使用することもできます。 で 行政 > フィルター > 条件 > フィルター条件一覧 タブでは、をクリックした後で「新規フィルタ条件」ウィンドウを開くことができます 足す. [新しいフィルタ条件] ウィンドウには、Active Directory 属性に関連付けられている次の 4 つのフィルタ条件の種類が表示されます。

  • Active Directory 属性の一致
  • Active Directory グループの一致
  • Active Directory パスの一致
  • Active Directory サイトの一致

Active Directory 属性の一致の場合、動的トークンは [ADAttribute:attrName] です。 Active Directory Group Match には、その条件の種類がグループ メンバーシップのチェックに使用されるため、動的トークンを使用できません。 Active Directory パスの一致の場合、完全な LDAP パスの動的トークンは ##UserLDAPPath## です。 Active Directory Site Match の場合、動的トークンは ##ADSite## です。

例については、次の表を参照してください。

モーダル 説明 例:  
[ADAttribute:attrName] ドメイン・ユーザーの指定された属性を返します [ADAttribute:名前] 収益 管理者  
[PrinterAttribute:プリンター名\ attrName]です。 指定したドメインプリンターの指定した属性を返します [PrinterAttribute:printer1|name] は printer1 を返します。
[UserParentOU:レベル] 現在のユーザーの親 OU の指定されたレベルを返します [UserParentOU:1]CN=Jill Chou,OU=ユーザーアカウント,OU=APAC,DC=citrite,DC=net 収益 アジア太平洋  

レジストリ

レジストリを操作するために、WEM は [レジストリ値:<Registry path>] value は、関連するレジストリ値に置き換えます。 たとえば、次の値を指定できます。

  • [レジストリ値:HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Norskale\Agent Host\AgentLocation]

XML ファイル

XML ファイルを操作するために、WEM は [GetXmlValue:<XML path>|<tag name>] value は、XML ファイル内の特定のタグ値に置き換えます。 XML パスは、実際のパス、またはパスに解決される環境変数にすることができます。 環境変数は % で囲む必要があります。 たとえば、次の値を指定できます。

  • [GetXmlValue:C:\citrix\test.xml|summary] または
  • [GetXmlValue:%xmlpath%|概要]

INI ファイル

.iniファイルを操作するために、WEM は [GetIniValue:<INI path>|<section name in the .ini file>|<key name in the .ini.file>] をキー値に置き換えます。 INI パスは、実際のパスまたはパスに解決される環境変数にすることができます。 環境変数は % で囲む必要があります。 たとえば、次の値を指定できます。

  • [GetIniValue:C:\citrix\test.ini|PLD_POOL_LIC_NODE_0_0|LicExpTime] または
  • [GetIniValue:%inipath%|PLD_POOL_LIC_NODE_0_0|LicExpTime]

追加情報

フィルター条件の支持性マトリックス

次の表に、テストされた値または一致結果が動的トークンをサポートするすべての条件タイプを示します。

コンディションタイプ テストされた値 マッチング結果
コンピュータ名の一致 - はい
クライアント名の一致 - はい
環境変数の一致 いいえ はい
レジストリ値の一致 はい はい
WMI クエリ結果の一致 - はい
XenAppファーム名の一致 - はい
XenAppゾーン名の一致 - はい
XenDesktopファーム名の一致 - はい
XenDesktopデスクトップグループ名の一致 - はい
Active Directory 属性の一致 はい はい
名前または値がリスト内にある はい はい
一致するコンピュータ名がありません - はい
クライアント名が一致しません - はい
環境変数の一致なし いいえ はい
一致するレジストリ値がありません はい はい
WMI クエリ結果の一致がありません - はい
XenAppファーム名が一致しない - はい
XenAppゾーン名が一致しません - はい
XenDesktopファーム名が一致しません - はい
XenDesktopデスクトップグループ名の一致がありません - はい
Active Directory 属性が一致しない はい はい
名前または値がリストにありません はい はい
動的値の一致 はい はい
動的値の一致なし はい はい
ファイルのバージョン一致 はい はい
一致するファイルバージョンがありません はい はい
公開されたリソース名 - はい
名前がリスト内にある はい はい
名前がリストにありません はい はい
ファイル/フォルダが存在します - はい
ファイル/フォルダが存在しません - はい