PowershellでWunderListのAPIを触ってみる(新刊.netのRSS Feedを利用して本をWunderListに登録する)

環境

Invoke-RestMethod と ConvertTo-Json が必要なのでPowershell v3.0以降で動くはず

前準備

Authorization | Wunderlist Developerに従って以下のことをしておく

  1. WunderListへのアプリケーションの登録
  2. Web Server Application Integrationに従って、アカウントの認証設定のうえ、codeを入手しておく

実際にやってみる

今回は新刊.netrssフィードを利用して、ほしい本(とその著者)をWunderListのInboxに投入する。 ConfigとBookList Feedには環境に応じた値を入れること。

# Config
$conf=@{client_id = "CLIENT ID"; client_secret = "SECRET"; code = "CODE"}
$list_id=ID # Inbox id (integer) 

# Object to convert to json for create task api
$task=@{list_id = $list_id ; title = "";}

# BookList Feed
$source = "http://sinkan.net/?action_rss=true&uid=12345&mode=schedule&key=hogehoge";

# Get access token
$headers = @{"X-Access-Token"=""; "X-Client-ID"=$conf.client_id; "Content-Type"="application/json" }
$body = $conf | ConvertTo-Json
$headers.'X-Access-Token' = $(Invoke-RestMethod -Method Post -Uri "https://www.wunderlist.com/oauth/access_token" -Body $body -Headers $headers).access_token

#Get NewBookList and Create tasks into Inbox
Invoke-RestMethod $source | % { 
    $task.title = $($_.title.'#cdata-section' +  "/" + $_.creator.'#cdata-section') ; $task } | % {
      ConvertTo-Json $_ } | % {
        $body=[System.Text.Encoding]::UTF8.GetBytes($_); $_ } | % { 
          Invoke-RestMethod -method POST -Uri "a.wunderlist.com/api/v1/tasks" -Headers $headers -Body $body } 

メモ

  • 自分ひとりで使うなら、登録時のアプリのURLやリダイレクトURLはテキトーで良い。
  • リクエストのヘッダの仕様などはAuthorization | Wunderlist Developer参照
  • Invoke-RestMethodさえ使えればあまり難しくはない、かと思いきや日本語の書名が文字化けしてとても苦労した。結局、せっかくだからおれはこのInvoke-RestMethodをつかうぜ | たっぷす庵を参考にさせてもらって、JSONごとByte配列にしてリクエストに突っ込んだがもっとうまい方法はあると思う。
  • JSONをByteにするところで、パイプの入力オブジェクトを出力しているのは、後続のパイプでもともとの入力だった$taskの数だけ後続の処理をするため。これをしないとByte配列の要素数分、後続のパイプの処理が実行されてしまう。
  • 上記のコードはAPIを呼び出す部分と、API用のパラメータを作る部分に関数なりで分割した方がきれいなのだと思うが、かき捨てのコードなのでそこまでしてはいない
  • はじめて認証付きのAPIを触ったのだが、意外と簡単だった。
  • パイプを多用したので、ErrorActionをうまく使ってtry-catchなりtrapしてやらないとエラーが拾えなさそう。
  • list_idは以下のようなAPIで取得できる
Invoke-RestMethod -method GET -uri "a.wunderlist.com/api/v1/lists" -Headers $headers

Windowsでオープン拡張辞書を利用して改行を含む文字列を辞書登録する

WindowsIMEに複数行の文字列を登録したい場合は、オープン拡張辞書を作成する。 Microsoftから配布されているオープン拡張辞書を作成するためのエクセルファイルを利用して作成できる。 ただし、一部制限事項はあるので注意が必要。

ダウンロードとインストール

  1. Download Microsoft Office IME 2010 オープン拡張辞書作成用 Excel テンプレート from Official Microsoft Download Centerからテンプレートをダウンロードする
  2. ダウンロードしたファイル内のsetup.exeを実行し必要なツールをインストールする

使い方

  1. ダウンロードしたファイル内のIME Open Extended Dictionary Builder.xltxを開く
  2. 画面右の作業タブで入力中によみを自動入力のチェックをはずす
  3. 内容を記入する([変換後の文字列]にALT+ENTERで改行入力できる)
  4. 画面右の作業タブで辞書の作成ボタンを押す

注意点

  1. [変換後の文字列]には字数制限があるようで、長い言葉は登録できなかった
  2. [変換後の文字列]内の改行はCRとなるので、メモ帳では反映されない
  3. Windows10ではOfficeIMEを導入できないので、辞書生成前のエラーチェックができない(実際に辞書を作ってから取り込んでみるしかない)
  4. こちらによると[変換後の文字列]に;(セミコロン) を2回使用することはできないようだ

その他

ユーザー提供のオープン拡張辞書:TechNetフォーラム内にあるユーザーが作成したオープン拡張辞書公開のためのページ

Download Microsoft Office IME 2010 オープン拡張辞書作成用 Excel テンプレート from Official Microsoft Download Center:Microsoftダウンロードセンターで公開されているオープン拡張辞書を作成するためのExcelテンプレート

Microsoft Office IME 2010 オープン拡張辞書 | Microsoft Office IME 2010 | Microsoft Office 2010:Microsoftによるオープン拡張辞書の概要

辞書登録で複数行(改行)の入力をしたい! - gooブログはじめました!

Markdownでかっこをエスケープする

バックスラッシュ[]を使って特殊記号をエスケープできる。

誤:[Resolve\-DnsName](https://technet.microsoft.com/ja-jp/library/jj590781(v=wps.630).aspx)
正:[Resolve\-DnsName](https://technet.microsoft.com/ja-jp/library/jj590781\(v=wps.630\).aspx)

誤の場合は「~(v=wps.630).aspx)」の一つ目の閉じかっこでリンクが切れてしまう。

Powershellで名前解決する

なにも考えずにResolve-DnsNameする

PS C:> Resolve-DnsName google.com

Name                                           Type   TTL   Section    IPAddress
----                                           ----   ---   -------    ---------
google.com                                     AAAA   204   Answer     2404:6800:4004:80f::200e
google.com                                     A      204   Answer     216.58.197.238

(≒nslookup)

単純な名前解決だけでなく、リソースレコードを指定して名前解決することもできる。 以下はIPv6IPv4、MTAのリストの表示

PS C:\> Resolve-DnsName google.com -type AAAA

Name                                           Type   TTL   Section    IPAddress
----                                           ----   ---   -------    ---------
google.com                                     AAAA   231   Answer     2404:6800:4004:80f::200e


PS C:\> Resolve-DnsName google.com -type A

Name                                           Type   TTL   Section    IPAddress
----                                           ----   ---   -------    ---------
google.com                                     A      177   Answer     172.217.24.142


PS C:\> Resolve-DnsName google.com -type MX

Name                                     Type   TTL   Section    NameExchange                              Preference
----                                     ----   ---   -------    ------------                              ----------
google.com                               MX     2     Answer     alt4.aspmx.l.google.com                   50
google.com                               MX     2     Answer     alt3.aspmx.l.google.com                   40
google.com                               MX     2     Answer     aspmx.l.google.com                        10
google.com                               MX     2     Answer     alt2.aspmx.l.google.com                   30
google.com                               MX     2     Answer     alt1.aspmx.l.google.com                   20

参考

Powershellでローカルユーザーを管理する(Microsoft.PowerShell.LocalAccounts)

昨日の「Hey, Scripting Guy」!*1を読んでいて知ったのだが、最新のPowershell*2ではローカルユーザーを管理できる。

実行環境

Microsoft Windows 10 Pro (10.0.14393)

Major  Minor  Build  Revision
-----  -----  -----  --------
5      1      14393  576

実際のコマンド

まずはどんなコマンドがあるか、手元の環境で確認してみる。

PS D:\SandBox> # とりあえずコマンドを引く

PS D:\SandBox> Get-Command Get-LocalUser

CommandType     Name                                               Version    Source                                                                                           
-----------     ----                                               -------    ------                                                                                           
Cmdlet          Get-LocalUser                                      1.0.0.0    Microsoft.PowerShell.LocalAccounts                                                               



PS D:\SandBox> # 同じSourceに似たようなコマンドがないか調べる

PS D:\SandBox> get-command -Module  Microsoft.PowerShell.LocalAccounts

CommandType     Name                                               Version    Source                                                                                           
-----------     ----                                               -------    ------                                                                                           
Cmdlet          Add-LocalGroupMember                               1.0.0.0    Microsoft.PowerShell.LocalAccounts                                                               
Cmdlet          Disable-LocalUser                                  1.0.0.0    Microsoft.PowerShell.LocalAccounts                                                               
Cmdlet          Enable-LocalUser                                   1.0.0.0    Microsoft.PowerShell.LocalAccounts                                                               
Cmdlet          Get-LocalGroup                                     1.0.0.0    Microsoft.PowerShell.LocalAccounts                                                               
Cmdlet          Get-LocalGroupMember                               1.0.0.0    Microsoft.PowerShell.LocalAccounts                                                               
Cmdlet          Get-LocalUser                                      1.0.0.0    Microsoft.PowerShell.LocalAccounts                                                               
Cmdlet          New-LocalGroup                                     1.0.0.0    Microsoft.PowerShell.LocalAccounts                                                               
Cmdlet          New-LocalUser                                      1.0.0.0    Microsoft.PowerShell.LocalAccounts                                                               
Cmdlet          Remove-LocalGroup                                  1.0.0.0    Microsoft.PowerShell.LocalAccounts                                                               
Cmdlet          Remove-LocalGroupMember                            1.0.0.0    Microsoft.PowerShell.LocalAccounts                                                               
Cmdlet          Remove-LocalUser                                   1.0.0.0    Microsoft.PowerShell.LocalAccounts                                                               
Cmdlet          Rename-LocalGroup                                  1.0.0.0    Microsoft.PowerShell.LocalAccounts                                                               
Cmdlet          Rename-LocalUser                                   1.0.0.0    Microsoft.PowerShell.LocalAccounts                                                               
Cmdlet          Set-LocalGroup                                     1.0.0.0    Microsoft.PowerShell.LocalAccounts                                                               
Cmdlet          Set-LocalUser                                      1.0.0.0    Microsoft.PowerShell.LocalAccounts                                                                

続けていくつか使ってみる。

PS D:\SandBox>  #ローカルユーザーの一覧から最初3つを取得
PS D:\SandBox> (Get-LocalUser)[1..3]

Name           Enabled Description
----           ------- -----------
DefaultAccount False   システムで管理されるユーザー アカウントです。
Guest          False   コンピューター/ドメインへのゲスト アクセス用 (ビルトイン アカウント)
HomeGroupUser$ True    コンピューターへのホームグループ アクセス用のビルトイン アカウント


PS D:\SandBox>  #ローカルグループの一覧から最初3つを取得
PS D:\SandBox> (Get-LocalGroup)[1..3]

Name                                Description
----                                -----------
WinRMRemoteWMIUsers__               Members of this group can access WMI resources over management protocols (such a...
__vmware__                          VMware User Group
Access Control Assistance Operators このグループのメンバーは、このコンピューター上のリソースの認証属性およびアクセス...

PS D:\SandBox>  #Administratorsグループのメンバーを取得
PS D:\SandBox> Get-LocalGroupMember Administrators

ObjectClass Name                   PrincipalSource
----------- ----                   ---------------
ユーザー    examplePC\Administrator Local

もっと詳しい使い方は公式のリファレンスを読めばよい。 Microsoft.PowerShell.LocalAccounts

参考

PowerTip: Get a list of local Users in Windows 10 / Windows Server 2016 – Hey, Scripting Guy! Blog ⇒元ネタ

Tech TIPS:Windowsのnet userコマンドでユーザーアカウントを管理する - @IT ⇒該当コマンドレットが利用できない場合、昔ながらのnet user コマンドを使う。

余談

bashならどうするの?というメモ

ユーザーの情報を取得したいだけならgetentコマンドを利用する。/etc/groupだけではわからないようなLDAP連携の値も持ってこれる。

変更を加えたいなら

  • user(add|del|mod)
  • group(add|del|mod)