Windows デスクトップ デバイスのスクリプトによるエンドポイント構成の自動化

スクリプトにより、Workspace ONE UEM を使用している Windows デスクトップ デバイスのエンドポイント構成の PowerShell コード スクリプトを実行します。

Freestyle 機能

スクリプトは、SaaS 環境で使用できる Freestyle 機能です。Freestyle の詳細については、「Freestyle Orchestrator」を参照してください。

スクリプトの説明

スクリプトは、[リソース] のメイン ナビゲーションにあります。コードを Windows デバイスにプッシュすることで、さまざまなプロセスを実行できます。たとえば、デバイスを再起動するようにユーザーに通知する PowerShell スクリプトをプッシュします。

スクリプトで 変数 を使用して、パスワードや API キーなどの機密性の高い静的なデータを保護するか、デバイス ID やユーザー名などの動的データの参照値として使用することができます。また、このコードを Windows ユーザーが使用できるようにして、必要に応じてデバイス上で実行することも可能です。Workspace ONE Intelligent Hub をスクリプトと統合することによりコードを使用できるようにすると、ユーザーはカタログの [アプリ] 領域でコードにアクセスできます。

重要：プライバシー上の理由から、従業員所有デバイスにスクリプトを割り当てることは許可されていません。

スクリプトが正常に実行さたかどうかを確認する方法

スクリプトが正常に実行されたかどうかを確認するには、デバイスの [デバイス詳細] 画面の [スクリプト] タブを使用します。Workspace ONE UEM console で、該当する組織グループに移動し、[デバイス] > [リスト表示] の順に選択して、該当するデバイスを選択します。[スクリプト] タブの [状態] 列で、[実行済み] 状態または [失敗] 状態を確認します。状態は、終了コード（エラーコードまたはリターンコードとも呼ばれる）によって異なります。

• 実行済み - Workspace ONE UEM では、終了コードが 0 を返すと、この状態が表示されます。
• 失敗 - Workspace ONE UEM では、終了コードが 0 以外の値を返すと、この状態が表示されます。

Windows デスクトップ デバイス用のスクリプトを作成する

Workspace ONE UEM によって管理される Windows デスクトップのスクリプトは、PowerShell を使用したエンド ユーザーのデバイスでのコードの実行がサポートされています。スクリプトを Workspace ONE Intelligent Hub for Windows と統合し、ユーザーのスクリプトをセルフサービスで有効にします。

注: スクリプトを 2,000 台（デフォルト値）未満のデバイスに公開している場合、デバイスにはリソースを取得するように直ちに通知されます。ただし、割り当てられたスマート グループに 2,000 台以上のデバイスがある場合、デバイスは、次回 Workspace ONE UEM Console にチェックインする際にリソースを受け取ります。

手順

1. [リソース] > [スクリプト] > [追加] の順に進みます。
2. Windows を選択します。

3. [全般] タブでスクリプト設定を構成します。

   設定	説明
   名前	スクリプトの名前を入力します。
   説明	スクリプトの説明を入力します。
   App Catalog のカスタマイズ	Workspace ONE Intelligent Hub カタログのスクリプトへのセルフサービスのアクセスを有効にします。 表示名 - カタログでユーザーに表示する名前を入力します。 表示の説明 - スクリプトの実行に関する簡単な説明を入力します。 アイコン - スクリプトのアイコンをアップロードします。 カテゴリ - スクリプトのカテゴリを選択します。カテゴリは、ユーザーがカタログ内のアプリケーションをフィルタリングするのに役立ちます。 カタログのスクリプトの設定は完了していますが、別の構成を使用して Workspace ONE Intelligent Hub にスクリプトを表示するように設定できます。デバイスにスクリプトを割り当てる場合は、Hub に表示 メニュー項目を有効にします。有効にしない場合、これらのカスタマイズはカタログに表示されません。

4. [詳細] タブのスクリプト設定を構成します。

   設定	説明
   言語	Workspace ONE UEM では、PowerShell をサポートしています。
   実行コンテキスト	この設定は、ユーザーまたはシステムのどちらのコンテキストでスクリプトを実行するのかを制御します。
   実行アーキテクチャ	この設定は、アーキテクチャに基づいてデバイスでスクリプトを実行するかどうかを制御します。32 ビット デバイスまたは 64 ビット デバイスでのみ実行するようにスクリプトを制限できます。また、デバイス アーキテクチャに基づくスクリプトを実行するように制限することもできます。また、デバイスのアーキテクチャに関係なく強制的に 32 ビットとしてスクリプトを実行させることもできます。
   タイムアウト	スクリプトがループするか、何らかの理由で応答しなくなった場合に、システムがスクリプトを実行してから停止するまでの時間を秒単位で入力します。
   コード	スクリプトをアップロードするか、所定のテキスト ボックスに独自のスクリプトを書き込みます。

5. [次へ] を選択して [変数] タブを構成します。
   
   キーおよび変数の値を指定して、API キー、サービス アカウント名、パスワードなどの静的な値を追加します。または、キーを指定して enrollmentuser などの動的な値を追加し、参照値アイコンを選択します。スクリプトで変数を使用するには、$env:key を使用して変数を参照します。たとえば、変数定義に SystemAccount という名前のキーと admin01 の値が設定されている場合、そのスクリプトでは変数をスクリプト変数、$account = $env:SystemAccount を参照することにより指定したアカウントに割り当てることができます。

6. デバイスにスクリプトを割り当てるには、スクリプトを選択して [割り当て] を選択し、[新しい割り当て] を選択します。

7. [定義] タブで [割り当て名] を入力し、[スマート グループの選択] メニュー項目を使用して、スクリプトをプッシュするデバイスのグループを選択します。
8. 展開 タブの トリガ で、スクリプトを開始するトリガを選択します。複数のトリガを選択できます。
9. Workspace ONE Intelligent Hub でスクリプトの [App Catalog のカスタマイズ] 設定を表示するには、[Hub に表示] を有効にします。カタログのユーザーからスクリプトを非表示にするには、このオプションを無効にします。

次に行うこと

スクリプトのステータスを表示するには、デバイスの [デバイス詳細] の [スクリプト] タブに移動します。