HOWTO · PowerShell
Get-ADComputer -PowerShell でのフィルター処理
この記事では、PowerShell のオペレーティング システムの Get-ADComputer -Filter について説明します。
このページの内容
Get-ADComputer -Filter を使用して、属性で Active Directory のコンピューター アカウントを検索します。-Filter パラメーターは Name -like '*elitebook*' のような PowerShell 形式の式を受け取り、ドメイン コントローラーがその式をサーバー側で評価します。コマンドレットは、一致するアカウントごとに 1 つのコンピューター オブジェクトを返します。以下の Active Directory コマンドを実行するには、Remote Server Administration Tools (RSAT) と一緒にインストールされるかドメイン コントローラーにすでに存在する ActiveDirectory モジュールと、接続可能なドメインが必要です。これらのコマンドはその環境内でしか実行できないため、調整可能なインライン構文として記述しています。フェンスで囲まれたプログラムは、それらの比較をそのまま再現する自己完結型の実行可能な例であり、それぞれの実際の出力がすぐ下に示されています。
Get-ADComputer でコンピューター アカウントを取得する
Get-ADComputer は Active Directory から 1 つ以上のコンピューター アカウントを取得するコマンドレットで、ActiveDirectory モジュールの一部として提供されます。モジュールがインストールされているマシンでは、Get-Help Get-ADComputer を実行すると、コマンドレットのパラメーターとそれぞれが受け取る値の一覧が表示されます。
既知のアカウントを -Identity に渡すと、そのコンピューターだけを取得できます: Get-ADComputer -Identity PC-01。このパラメーターは識別名、GUID、セキュリティ識別子 (SID)、または sAMAccountName を受け取るため、手持ちのデータが提供する形式のままでアカウントを参照できます。
結果は、Name、DNSHostName、Enabled、SID などの限られた既定のプロパティ セットを持つコンピューター オブジェクトです。OperatingSystem のような属性は要求しない限り読み込まれません。Get-ADComputer -Identity PC-01 -Properties * を実行すると、アカウントに保存されているすべての属性を取得できます。
名前でコンピューターをフィルター処理する
コンピューター名の一部しかわからない場合でも、-Filter を使えば一致するすべてのアカウントを見つけられます。フィルター文字列の中では、-like がワイルドカード照合を実行します。* は任意の長さの文字列を表し、比較では大文字と小文字が区別されません。
次の例を実行します:
このセクションのコードと表示されるラベルや出力は英語のままです。
import fnmatch
print(fnmatch.fnmatchcase('ELITEBOOK-840-G8'.lower(), '*elitebook*'))
True
-Filter 内の同じパターンは、ディレクトリ内のすべてのコンピューター アカウントの Name 属性に適用されるため、Get-ADComputer -Filter "Name -like '*elitebook*'" は一致するすべてのマシンを返します。この照合は結果がネットワークを越える前にドメイン コントローラー上で実行されるため、すべてのアカウントを取得して Where-Object でローカルにテストするよりもはるかに高速です。各一致はコンピューター オブジェクトとして返されるので、結果を Format-Table、Select-Object、またはその他のコマンドレットにパイプしてさらに処理できます。
オペレーティング システムと複数の条件でコンピューターをフィルター処理する
管理者は、アップグレードを計画したりポリシーの適用対象を決めたりするために、特定のオペレーティング システムを実行しているマシンの一覧を必要とすることがよくあります。OperatingSystem 属性には Windows 10 Enterprise のような文字列が格納されるため、Get-ADComputer -Filter "OperatingSystem -like '*Windows 10*'" はバージョン名を含むすべてのエディションに一致します。
-eq は属性値全体を比較するため正確な文字列に適しており、-or と -and は 1 つのフィルターで複数の条件を組み合わせます。同じ比較を実行可能な形式で示します:
このセクションのコードと表示されるラベルや出力は英語のままです。
os_name = 'Windows 11 Pro'
print(os_name == 'Windows 10' or os_name == 'Windows 11 Pro')
True
ディレクトリに適用すると、Get-ADComputer -Filter "OperatingSystem -eq 'Windows 10' -or OperatingSystem -eq 'Windows 11'" は、記録されている値が 2 つの文字列のどちらか一方と完全に一致するコンピューターを返します。-or を -and に置き換えると、結果セットは広がるのではなく絞り込まれます。記録される値には通常 Pro のようなエディションの接尾辞が含まれるため、OperatingSystem -like 'Windows 10*' のような末尾のワイルドカードは、バージョン名だけを指定した -eq よりも多くのマシンに一致することがよくあります。
プロパティを選択して結果をエクスポートする
フィルター処理はドメイン コントローラー上で実行されるため、-Filter 内で使用する属性が返されるプロパティに含まれている必要はありません。ただし、OperatingSystem を表示または保存するには、-Properties で要求し、Select-Object で出力を整形します: Get-ADComputer -Filter "OperatingSystem -like 'Windows 10*'" -Properties OperatingSystem | Select-Object Name, OperatingSystem。
選択したオブジェクトを Export-Csv にパイプすると、ファイルに保存できます。-NoTypeInformation を指定すると .NET 型ヘッダーが省略され、CSV には列の行とデータだけが含まれます。-Path には任意の書き込み可能な場所を指定できます: Get-ADComputer -Filter * -Properties OperatingSystem | Select-Object Name, OperatingSystem | Export-Csv -Path .\computers.csv -NoTypeInformation。
結果の CSV はスプレッドシートで開いたり、レポート作成や後続の管理作業のために他の PowerShell コマンドに渡したりできます。