グローバル資格の変更

グローバルデスクトップ資格を変更するには、--updateGlobalEntitlement オプションを指定して lmvutil コマンドを実行します。グローバルアプリケーション資格を変更するには、--updateGlobalApplicationEntitlement オプションを指定して lmvutil コマンドを実行します。

構文

lmvutil --updateGlobalEntitlement --entitlementName name [--description text] 
[--disabled] [--enabled] [--fromHome] [--disableFromHome] [--multipleSessionAutoClean] 
[--disableMultipleSessionAutoClean] [--multipleSessionsPerUser] 
[--disableMultipleSessionsPerUser] [--requireHomeSite] [--disableRequireHomeSite] 
[--defaultProtocol value] [--scope scope] [--htmlAccess] [--disableHtmlAccess] 
[--tags tags] [--notags] [--categoryFolder foldername] [--disableCategoryFolder]
[--clientRestrictions] [--disableClientRestrictions] [--collaboration] 
[--disableCollaboration] [--shortcutLocations {desktop | launcher | desktop,launcher}]

lmvutil --updateGlobalApplicationEntitlement --entitlementName name [--description text] 
[--disabled] [--enabled] [--fromHome] [--disableFromHome] [--multipleSessionAutoClean] 
[--disableMultipleSessionAutoClean] [--requireHomeSite] [--disableRequireHomeSite] 
[--defaultProtocol value] [--scope scope] [--htmlAccess] [--disableHtmlAccess] 
[--appVersion value] [--appPublisher value] [--appPath value] [--tags tags] [--notags] 
[--preLaunch] [--disablePreLaunch] [--categoryFolder foldername] [--disableCategoryFolder]
[--clientRestrictions] [--disableClientRestrictions] [--shortcutLocations {desktop | launcher | desktop,launcher}]
[--multiSessionMode value]

使用上の注意

これらのコマンドは、ポッドフェデレーションにあるどの接続サーバインスタンスでも使用できます。クラウドポッドアーキテクチャ機能は、新しいデータをグローバルデータレイヤーに格納し、ポッドフェデレーション内のすべてのポッドでそのデータを複製します。

これらのコマンドは、グローバル資格が存在しない場合、範囲が無効な場合、クラウドポッドアーキテクチャ機能が初期化されていない場合、またはグローバル資格を更新できない場合に、エラーメッセージを返します。

オプション

グローバル資格を変更するときには、これらのオプションを指定できます。一部のオプションは、グローバルデスクトップ資格にのみ、またはグローバルアプリケーション資格にのみ適用されます。

表 1. グローバル資格変更時のオプション
オプション	説明
--entitlementName	変更するグローバル資格の名前。
--scope	グローバル資格の範囲。有効な値は以下のとおりです。 ANY。ポッドフェデレーションの任意のポッドで Horizon がリソースを探します。 SITE。ユーザーが接続しているポッドと同じサイト内のポッドでのみ Horizon がリソースを探します。 LOCAL。ユーザーが接続しているポッドでのみ Horizon がリソースを探します。
--description	（オプション）グローバル資格の説明。説明には 1 文字から 1024 文字が使用できます。
--disabled	（オプション）以前に有効化されたグローバル資格を無効化します。
--enabled	（オプション）以前に無効化されたグローバル資格を有効化します。
--fromHome	（オプション）ユーザーにホームサイトがある場合、ユーザーのホームサイトから Horizon がリソースを探し始めます。ユーザーにホームサイトがない場合、ユーザーが現在接続しているサイトで Horizon がリソースを探し始めます。
--disableFromHome	（オプション）グローバル資格で --fromHome 機能を無効にします。
--multipleSessionAutoClean	(オプション) 同じ資格の余剰ユーザーセッションをログオフします。複数のセッションは、セッションを含むポッドがオフラインになり、ユーザーが再度ログインして別のセッションを開始し、問題のポッドが元のセッションでオンラインに戻るときに発生する可能性があります。複数のセッションが発生すると、セッションを選択するように指示するメッセージが Horizon Client によって表示されます。このオプションは、ユーザーが選択しないセッションに何が発生するかを決定します。このオプションを指定しない場合、ユーザーは Horizon Client でログオフするか、セッションを起動してログオフして、自身の余剰セッションを手動で終了する必要があります。
--disableMultipleSessionAutoClean	（オプション）グローバル資格で --multipleSessionAutoClean 機能を無効にします。
--multipleSessionsPerUser	（オプション）ユーザーの複数セッションに関するポリシーを有効にします。これにより、複数のクライアントデバイスから個別のデスクトップセッションを開始できます。複数のクライアントデバイスからグローバルデスクトップ資格に接続するユーザーは、複数のデスクトップセッションを受け取ります。既存のデスクトップセッションに再接続するには、そのセッションが開始されたのと同じデバイスを使用する必要があります。このポリシーを有効にしないと、使用するクライアントデバイスに関係なく、ユーザーは常に既存のデスクトップセッションに再接続します。フローティングデスクトップ資格にのみ適用されます。
--disableMultipleSessionsPerUser	（オプション）グローバルデスクトップ資格でユーザーの複数セッションに関するポリシーを無効にします。
--requireHomeSite	(オプション) ユーザーにホームサイトがある場合のみグローバル資格が使用可能になります。このオプションは --fromHome オプションも指定されたときのみ適用可能です。
--disableRequireHomeSite	（オプション）グローバル資格で --requireHomeSite 機能を無効にします。
--defaultProtocol	（オプション）グローバル資格におけるデスクトップまたはアプリケーションのデフォルト表示プロトコルを指定します。グローバルデスクトップ資格の有効値は RDP、PCOIP、および BLAST であり、グローバルアプリケーション資格の有効値は PCOIP および BLAST です。
--htmlAccess	（オプション）HTML Access ポリシーを有効にします。これにより、HTML Access 機能を使用してグローバル資格のリソースにアクセスできます。HTML Access を使用すると、エンドユーザーは Web ブラウザを使用してリモートリソースにアクセスできるため、ローカルシステムにクライアントソフトウェアをインストールする必要がありません。
--disableHtmlAccess	（オプション）グローバル資格で HTML Access ポリシーを無効にします。
--appVersion	（オプション）アプリケーションのバージョン。グローバルアプリケーション資格にのみ適用されます。
--appPublisher	（オプション）アプリケーションのパブリッシャ。グローバルアプリケーション資格にのみ適用されます。
--appPath	（オプション）C:\Program Files\app1.exe などのアプリケーションのフルパス名。グローバルアプリケーション資格にのみ適用されます。
--tags	（オプション）Connection Server インスタンスからグローバル資格へのアクセスを制限する 1 つ以上のタグを指定します。複数のタグを指定するには、複数のタグ名をカンマまたはセミコロンで区切り、引用符を付けたリストを入力します。詳細については、グローバル資格に対する接続サーバ制限の実装を参照してください。
--notags	（オプション）グローバル資格からタグを削除します。
--preLaunch	（オプション）事前起動ポリシーを有効にします。これにより、ユーザーが Horizon Client でグローバルアプリケーション資格を開く前に、アプリケーションセッションが起動します。事前起動ポリシーを有効にすると、ユーザーはグローバルアプリケーション資格をより迅速に起動できます。グローバルアプリケーション資格のすべてのアプリケーションプールが、セッションの事前起動機能をサポートし、すべてのファームで事前起動セッションのタイムアウトが同じである必要があります。
--disablePreLaunch	（オプション）グローバルアプリケーション資格で事前起動ポリシーを無効にします。
--categoryFolder	（オプション）クライアントデバイスのグローバル資格用ショートカットを含むカテゴリフォルダの名前を指定します。最大で 4 つのフォルダレベルを設定できます。フォルダ名の長さは最大 64 文字です。サブフォルダを指定するには、バックスラッシュ (\) 文字を入力します。たとえば、dir1\dir2\dir3\dir4 と入力します。最大で 4 つのフォルダレベルを入力できます。フォルダ名の先頭または末尾にバックスラッシュは使用できません。また、バックスラッシュを重ねて使用することもできません。たとえば、\dir1、dir1\dir2\、dir1\\dir2、dir1\\\dir2 は無効です。Windows の予約キーワードは入力できません。また、--shortcutLocations オプションを使用して、Windows クライアントデバイス上のショートカットの場所を指定する必要があります。詳細については、グローバル資格のショートカットの設定を参照してください。
--disableCategoryFolder	（オプション）グローバル資格のカテゴリフォルダを削除します。
--clientRestrictions	（オプション）クライアントの制限ポリシーを有効にし、特定のクライアントコンピュータに対するグローバル資格へのアクセスを制限します。詳細については、グローバル資格に対するクライアント制限の実装を参照してください。
--disableClientRestrictions	（オプション）グローバル資格でクライアントの制限ポリシーを無効にします。
--collaboration	（オプション）セッション共同作業ポリシーを有効にします。これにより、リモートデスクトップセッションのユーザーが自身のセッションに他のユーザーを招待できます。グローバルデスクトップ資格内のすべてのデスクトッププールが、セッション共同作業機能をサポートしている必要があります。グローバルデスクトップ資格にのみ適用されます。
--disableCollaboration	（オプション）グローバルデスクトップ資格でセッション共同作業ポリシーを無効にします。
--shortcutLocations	（オプション）このオプションを使用して、クライアントデバイスのショートカットを変更または作成します。使用できる値は、デスクトップにショートカットを作成する desktop と、Windows のスタートメニューにショートカットを作成する launcher です。コンマで区切ると desktop と launcher の両方を指定できます。ショートカットはデスクトップと Windows スタートメニューの両方に作成されます。ショートカットを変更する場合、つまり、カテゴリフォルダがすでに作成されている場合は、カテゴリフォルダ名を変更する場合を除き、--categoryFolder オプションを指定する必要はありません。カテゴリフォルダが作成されていない場合は、--categoryFolder オプションを --shortcutLocations オプションと一緒に指定する必要があります。注：このオプションは --disableCategoryFolder オプションとは併用しないでください。
--multiSessionMode	（オプション）グローバルアプリケーション資格に複数セッションモードを設定します。DISABLED、ENABLED_DEFAULT_OFF、ENABLED_DEFAULT_ON、ENABLED_ENFORCED のいずれかの値を指定します。詳細については、グローバルアプリケーション資格の複数セッションモードの有効化を参照してください。

例

lmvutil --authAs adminEast --authDomain domainEast --authPassword "*" --updateGlobalEntitlement --entitlementName "Windows 8 Desktop" --scope ANY --isDedicated

lmvutil --authAs adminEast --authDomain domainEast --authPassword "*" 
--updateGlobalApplicationEntitlement --entitlementName "Microsoft Office PowerPoint" --scope ANY