mut
v6.2.1 - Authentication updates
Jamf管理者の完璧なコンパニオンになるように設計された非公式のオールインワンマスアップデートツール
Mut V6へようこそ。 Mut V5とMut Classicに精通している場合、Mut V6はおそらく非常に馴染みがあります。ここで初めての場合は、Readme全体を読むことをお勧めします。
V6の新機能のクイックビデオツアーをご希望の場合は、ここでイントロビデオをご覧ください：https：//www.youtube.com/watch?v=g1cwowbr_ti
Mutは非常に強力なツールであり、優れた力で素晴らしい能力を分割する能力があります。常に、いくつかのデバイスのみで小さなテストアップデートを実行して、更新が意図したとおりに機能していることを確認し、更新のためにスコーピングが壊れないことを確認してください。
MUTは、Swiftで書かれたネイティブMacOSアプリケーションであり、JAMF管理者は、JAMFのデバイスとユーザーの属性（ユーザー名、アセットタグ、拡張属性など）にマス更新を行うことができます。
管理者は、静的グループに質量変更を加え、Mutを介したプレゼント登録の範囲を大量に変更することもできます。
MUTは、ログイン時に資格情報のチェックを自動的に実行します。提供する資格情報の問題を感知すると、それらの問題が何であるかがわかります。
MUTは、新しいJPAPIのトークンを生成することにより、これらのチェックを実行します。ユーザーはJPAPIのトークンを生成できるため、「バイパス認証」チェックボックスが存在する必要はなくなりました。このチェックボックスは、「不安定なSSLを許可する」チェックボックスに変更されました。不安定なSSLを許可する場合は、このチェックボックスを使用できますが、MUTはデフォルトでATSごとに標準SSLチェックを実行します。
すべての特権は、JAMF Pro Serverアクションで見つかり、特に明記しない限り、更新をチェックするだけです。
コンピューターテンプレート- コンピューター、ユーザー
グループとプレゼンテージテンプレート（少なくとも特権アクセスのために別々のユーザーを持つことをお勧めします）：
コンピューターグループ /プレゼント- 静的コンピューターグループ、コンピュータープレゼント登録
デバイスグループ /プレゼント- 静的モバイルデバイスグループ、モバイルデバイスプレゼント登録
ユーザーグループ- 静的ユーザーグループ
モバイルデバイステンプレート- モバイルデバイス、ユーザー
ユーザーテンプレート- ユーザー（更新、作成）
最初に認証すると、比較的単純な画面が表示されます。これには、MUTを使用するために必要なCSVテンプレートをダウンロードする大きなボタンがあります。これらのテンプレートは、新しい機能を許可するためにMUTアップグレードで変更される傾向があるため、更新後にこれらのテンプレートを再ダウンロードすることをお勧めします。
ダウンロードCSVテンプレートボタンを押すと、MUTはMUT Templates.Zipを保存する場所を尋ねます。 Mut.LogはTemplatesディレクトリにないようになり、ページの上部にある[設定]メニューの下にあるようになりました。
JAMF Proのオブジェクト（コンピューターやモバイルデバイスなど）の情報を更新するには、MUTが指定した場所に保存した関連するCSVテンプレートを使用する必要があります。たとえば、コンピューターオブジェクトを更新するには、「computertemplate.csv」を使用する必要があります。
MUTは、このCSVファイルのヘッダー行に対して確認チェックを実行します。CSVファイルをアップロードする前に、ヘッダー行（列の削除や列の再配置など）を変更しないことが非常に重要です。もしそうなら、MUTはファイルを拒否します。
MUTの一般的な使用の1つは、デバイスのセットに割り当てられたユーザー名の更新や、デバイスのアセットタグまたはバーコードの入力など、単一の属性を更新することです。
覚えておくべき最も重要なことは、CSVに完全に空白になったセルは無視されることです。スペースは完全に空白と同じではないことに注意してください。 「」と「」には大きな違いがあります。
MUTでフィールドが無視される場合、プレフィールドチェックには、そのフィールドの青の「（変更されていない）」というフレーズが表示されます。
デバイスのセットでユーザー名を更新したい場合、CSVファイルは次のようになります（Ellipsisの後の列を増やします。）：
| コンピューターシリアル | 表示名 | 資産タグ | バーコード1 | バーコード2 | ユーザー名 | 本名 | ... |
|---|---|---|---|---|---|---|---|
| C13371337 | 1337 |
MUTは、飛行前のチェックを実行するときに次のような画面を表示します。
おそらく、MUTの最も要求されている機能は、複数の属性を一度に更新できることです。この機能はMutで利用可能になりました。
オブジェクトの複数の属性を一度に更新するには、CSVファイルにこれらすべてのフィールドを入力するだけです。飛行前のチェックを実行すると、更新されるすべての情報が表示されます（ブランクフィールドは「（変更されていない）」として表示されます）。
アセットタグ、バーコード、ユーザー名、および一連のデバイスの本名を更新したい場合、CSVファイルは次のようになります（省略記号の後の列を増やします。）：
| コンピューターシリアル | 表示名 | 資産タグ | バーコード1 | バーコード2 | ユーザー名 | 本名 | ... |
|---|---|---|---|---|---|---|---|
| C1111111 | MUT-111 | 0123456789 | 0123456789 | Mike.Levenick | マイク・レヴェニック | ||
| C2222222 | MUT-222 | 1234567890 | 1234567890 | Ben.whitis | ベン炎 |
MUTは、飛行前のチェックを実行するときに次のような画面を表示します。
JAMF Pro 10.33の時点では、Enforce名のチェックボックスをJAMF Pro APIを介してチェックまたはチェックしていないエンドポイントがあります。
MUT V6はこのエンドポイントを活用でき、モバイルデバイスの名前を施行または強化することができます。モバイルデバイステンプレートには新しい「施行名」フィールドがあり、このフィールドは真またはfalseのブール値を受け入れます。
これらの更新は、独自に、または他の更新と組み合わせて実行できます。モバイルデバイス名を設定してその名前を強制し、アセットタグ、バーコード、ユーザー名を更新するには、CSVは次のようになります。
| コンピューターシリアル | 表示名 | 名前を強制します | 資産タグ | バーコード1 | バーコード2 | ユーザー名 | ... |
|---|---|---|---|---|---|---|---|
| C1111111 | mikes iPhone | 真実 | MUT-111 | 0123456789 | Mike.Levenick | ||
| C2222222 | mikes iPad | 真実 | MUT-222 | 1234567890 | Ben.whitis |
MUTは、デバイスまたはユーザーの拡張属性を更新することもできます。これを行うには、最初に拡張属性ID番号を特定する必要があります。 JAMF ProのGUIの拡張機能属性を設定（Gear Icon）> Computer Management>拡張属性> [更新するEAをクリックして表示]をクリックしているときに、この数値をURLで見つけることができます。
たとえば、ここに表示された拡張機能属性のEA IDは「2」です。
拡張機能属性を更新するには、テンプレートの既存のすべての列の後に新しい列に独自のヘッダーを追加し、文字列「EA_＃」をヘッダーに配置します。ここで、＃は更新したいEAのIDです。
たとえば、ID： "2"で拡張属性を更新するには、ヘッダー "EA_2"で新しい列を追加し、そのEAの値を列に配置します。
CSVはこのように見えます（単にフィットするために削除されています。CSVから列を削除しないでください）：
| コンピューターシリアル | 表示名 | 資産タグ | バーコード1 | ... | ... | サイト（IDまたは名前） | EA_2 |
|---|---|---|---|---|---|---|---|
| C1111111 | MUT-111 | 0123456789 | 新しい値 | ||||
| C2222222 | MUT-222 | 1234567890 | 新しい値 |
MUTは、飛行前のチェックを実行するときに次のような画面を表示します。 EA_2で下部に追加された新しいフィールドに注意してください。また、MUTが更新できるすべてのフィールドを確認するために、右手ウィンドウで下にスクロールする必要があることに注意してください。かなりの数があります！：
MUTを使用したもう1つの一般的なワークフローは、既存の属性をクリアすることです。これは、たとえば、デバイスのグループが新しいユーザーに再配布されたり、廃止されたり、ユーザー名と関連情報がクリアされている状況で発生します。
MUTは現在CSVの空白フィールドを無視しているため、特定の文字列を使用してMUTに値をクリアするように指示する必要があります。この文字列は現在「クリア！」です。 （引用符なしで感嘆符が付いています。）Preflight GUIでは、MUTはすべての赤で「クリアされる」文字列を表示し、フィールドがクリアされていることを知らせます。
デバイスからユーザー情報をクリアしたい場合、CSVはこのようなものになります（省略記号の後のより多くの列があります。）：
| コンピューターシリアル | 表示名 | 資産タグ | バーコード1 | バーコード2 | ユーザー名 | 本名 | ... |
|---|---|---|---|---|---|---|---|
| C1111111 | MUT-111 | 0123456789 | 0123456789 | クリア！ | クリア！ | ||
| C2222222 | MUT-222 | 1234567890 | 1234567890 | クリア！ | クリア！ |
そして、MUTは、飛行前のチェックを実行するときに次のような画面を表示します（このスクリーンショットのクリア値で少し船外に出ました...）：
MUT V6は、静的グループ（コンピューター、モバイルデバイス、またはユーザー）の内容を更新できます。グループにオブジェクトを追加するか、グループからオブジェクトを削除するか、そのグループの現在の内容全体を置き換えることができます。
これを行うには、CSVファイルには、そのグループの範囲に追加、削除、または交換されるオブジェクトの識別子の単一の列以外の何も含まれていません。この識別子は、コンピューターとモバイルデバイスのシリアル番号またはID、またはユーザーのユーザー名またはIDのいずれかです。
CSVファイルは次のようになります。
| シリアル番号またはユーザー名 |
|---|
| C1111111 |
| C2222222 |
| C3333333 |
| C4444444 |
| C555555 |
このCSVをMUTにアップロードすると、ドロップダウンを含むわずかに異なる画面に移動します。これらのドロップダウンは、実行するアクションを選択する方法です。また、修正する静的グループのIDを配置する必要があるボックスも含まれています。このIDは、変更されるグループを表示しながら、URLに記載されています。
たとえば、次のグループのグループIDは「3」です。
しかし、私たちのグループ番号は1337であるふりをしましょう。問題のデバイスをコンピューター静的グループ1337に追加するために、Mut GUIは次のようになります。
MUT V6の新機能の1つは、プレゼントの範囲を変更する機能です。この機能には、適切に機能するためにJAMF Pro V10.24+が必要です。
これを行うには、CSVファイルには、オブジェクトが追加、削除、または交換されるオブジェクトの識別子の単一の列だけが含まれている必要があります。この識別子は、コンピューターとモバイルデバイスのシリアル番号またはIDのいずれかです。
CSVファイルは次のようになります。
| シリアル番号またはユーザー名 |
|---|
| C1111111 |
| C2222222 |
| C3333333 |
| C4444444 |
| C555555 |
このCSVをMUTにアップロードすると、ドロップダウンを含むわずかに異なる画面に移動します。これらのドロップダウンは、実行するアクションを選択する方法です。また、箱のIDを変更する必要があるボックスも含まれています。このIDは、変更されるプレゼントを表示しながら、URLに記載されています。
たとえば、次のグループのPrestage IDは「1」です。
問題のデバイスをPrestage 1に追加するために、Mut GUIは次のようになります。
MUT V5は、グループとプレゼントを更新するために新しい方法を使用しました。この新しい方法ははるかに効率的でしたが、CSVを完璧にする必要がありました。すでに範囲内にあるデバイスを備えたライン、または環境内になくなったラインは、アップデート全体が実行されなくなります。このため、MUT Classicが利用可能になり、MUT V4が行ったように、グループまたはプレゼントのラインバイラインを更新しました。
これらのラインバイラインの提出ははるかに効率が低く、かなり時間がかかりますが、CSVに悪いラインがある場合、MUTは単純にスキップして先に進みます。
さて、Mut V6では、両方の世界で最高のものを得ています。 Mut V6は最初に新しい、より効率的な更新方法を試みますが、それが失敗するという偶然には、「クラシックモード」アップデートを試みるオプションが提示されます。
このクラシックモードでは、誤った行がまだ失敗することに注意することが重要ですが、これらの行は後のレビューのためにmut.logで報告され、他のラインはまだ正常に通過します。
グループ全体またはプレセージがCSVの最後のワーキングラインに置き換えるため、ClassicモードはMUTを介した「交換」更新試行と互換性がないことに注意することが重要です。
MUTの退役軍人は、すべてのアップデートの前にプリフライトチェックを実行する必要があることに使用され、提出する前に情報を確認することに慣れている可能性があります。
オブジェクトの属性の更新については、v6のプレイライトチェックがCSVをアップロードするとすぐに発生するようになりました。 CSVファイルに問題がある場合は、アップロードしようとするとすぐに警告が表示されます。また、CSVにエラーが含まれている場合、MUTは更新を実行できないようにしてください。
GroupおよびPrestage Scopeの更新についてV6のプレフィックチェックは、CSVをアップロードするときに部分的に発生しますが、ドロップダウンと識別子ボックスを入力したら、個別のプレイライトチェックを実行する必要があります。 [更新の送信]ボタンは、これらのフィールドを入力してからプリフライトチェックを実行するまで表示されません。
MUTで大量更新する前に、特にツールを初めて使用する場合は、数枚のデバイスのわずかなテスト更新を行うことを強くお勧めします。
JAMF Proサーバーに送信される更新に自信があると、「更新を送信」ボタンを押すことができます。
MUTのメインGUIには、ステータス/結果情報がほとんど表示されません。画面の上部にある[設定]メニューにアクセスして、mut.logを見つけることができます。この新しいログファイルには、更新のステータスに関する詳細な情報が含まれており、トラブルシューティングを大幅に支援する必要があります。
ログファイルはこのように見えます：
