CData PowerShell Cmdlets for Procore はじめに：インストールから接続まで

このガイドでは、CData API Driver for Cmdlets の使い方を詳しく解説します。Cmdlet のインストール、初回接続の設定、クエリの実行、そして PowerShell で Procore のデータ を操作するための次のステップをご紹介します。

インストールとライセンス認証

システム要件

CData PowerShell Cmdlets は、PowerShell が動作するあらゆる環境で実行できます。

Windows

• Windows 10/11
• Windows Server 2016 以降
• PowerShell 5.1 または PowerShell 7 以降

macOS / Linux

• PowerShell 7 以降
• 追加のシステムライブラリは不要
• アーキテクチャ固有のインストーラーは不要

Cmdlet のインストール

CData Cmdlets は PowerShell Gallery から配布されており、プラットフォーム間で簡単かつ一貫したインストールプロセスを実現しています。

インストール手順

1. 管理者モードで PowerShell を開きます
2. 以下のコマンドを実行して Cmdlet モジュールをインストールします：

   Install-Module APICmdlets -Repository PSGallery -Force

   このコマンドは：

   • 公式の PowerShell Gallery からモジュールをダウンロードします
   • PowerShell 環境にインストールします
   • すべての Cmdlet をすぐに使用できるように登録します

モジュールの確認

インストールを確認するには：

Get-Module -ListAvailable "*API*"

ライセンス認証

Cmdlets は試用版と正規ライセンスの両方の認証に対応しています。

試用版ライセンス

試用版の認証は自動的に行われ、キーは不要です。インストール後すぐに Cmdlet を使用できます。

正規ライセンスの認証

正規ライセンスを購入された場合、CData Orders チームからプロダクトキーを受け取ります。

ライセンスの認証

以下のコマンドを実行します：

Set-ModuleLicense ""

認証が成功すると、確認メッセージが表示されます。

ライセンスに関するよくある質問

ライセンスは複数のマシンで使用できますか？

サブスクリプションプランによります。注文確認メールを確認するか、[email protected] までお問い合わせください。

ライセンスキーを紛失しました。どうすればよいですか？

注文番号を添えて [email protected] までメールでお問い合わせください。

ライセンスを別のマシンに移行できますか？

以下のリンクからライセンス移行リクエストを送信してください：https://www.cdata.com/lic/transfer/

ライセンスはどこで管理できますか？

CData カスタマーポータルにアクセスしてください：https://portal.cdata.com/

接続設定

モジュールがインストールされ、ライセンスが認証されたら、

Connect-Procore cmdlet

必要な接続プロパティを取得したら、PowerShell で Procore のデータ にアクセスしてレプリケーションを準備するには、基本的に 4 つのステップがあります。

まず、Profile 接続プロパティにProcore プロファイルのディスク上の場所を設定します（例：C:\profiles\Procore.apip）。次に、ProfileSettings 接続プロパティにProcore の接続文字列を設定します（以下を参照）。

Procore API プロファイル設定

Procore に認証し、自分のデータに接続したり、他のユーザーが自分のデータに接続できるようにするには、OAuth 標準を使用できます。

まず、Procore にOAuth アプリケーションを登録します。Developer Account にログインし、Create New App に移動することで登録できます。アプリを登録するために必要なすべてのステップに従います。まずSandbox Manifest の新しいバージョンを作成し、Production に昇格させてProduction Credentials を取得します。OAuth アプリケーションにはclient id とclient secret が割り当てられます。

以下の接続プロパティを設定すると、接続の準備が整います：

• AuthScheme：OAuth に設定します。
• InitiateOAuth：GETANDREFRESH に設定します。InitiateOAuth を使用してOAuthAccessToken を取得するプロセスを管理できます。
• OAuthClientId：アプリ設定で指定されているclient_id を設定します。
• OAuthClientSecret：アプリ設定で指定されているclient_secret を設定します。
• CallbackURL：アプリ設定で指定されているRedirect URI を設定します。

Procore のデータ の取得

1. モジュールをインストールします：

   Install-Module APICmdlets

2. Procore に接続します：

     $api = Connect-API  -Profile $Profile -Authscheme $Authscheme -OAuthClientId $OAuthClientId -OAuthClientSecret $OAuthClientSecret -CallbackUrl $CallbackUrl
     

PowerShell での Procore のデータ のクエリ

接続後、標準 SQL のようなコマンドを使用してデータをクエリできます。

クエリ例：

$results = Select-API `
    -Connection $conn `
    -Table "Companies" `
    -Columns "Id,Name" `
    -Where "Id != ''"

結果を表示します：

$results

これで PowerShell から Procore のデータ にアクセスできるようになりました。

よくある問題

認証エラー

解決策： ユーザー名、パスワード、セキュリティトークンを確認してください。OAuth アプリケーションの場合、アプリケーションのセキュリティ設定で CData を認可する必要がある場合があります。認可のサポートについては [email protected] までお問い合わせください。

ネットワークまたはプロキシの問題

解決策： ファイアウォール設定とアウトバウンドアクセスを確認してください。ほとんどのクラウドアプリケーションはポート 443 を使用します。

Cmdlet が見つからない

解決策： モジュールがインストールされていることを確認してください -

Get-Module -ListAvailable "*Procore*"

クエリが遅い

解決策：

• フィルターを追加してデータセットのサイズを削減してください
• サポートされている場合は $Limit または $Top プロパティを使用してください
• 最適化のサポートについては [email protected] までお問い合わせください

接続に関するその他のトラブルシューティングについては、具体的なエラーメッセージを添えて [email protected] までお問い合わせください。

次のステップ

PowerShell Cmdlets のインストール、ライセンス認証、接続設定が完了しました。以下のシナリオを参考に、さらに活用してみてください：

サポート

ご不明な点がございましたら、お気軽にお問い合わせください：

• テクニカルサポート： [email protected]
• コミュニティフォーラム： CData Community Site
• ヘルプドキュメント： ローカルにインストールされているほか、オンラインでも参照可能です

FAQ（PowerShell Cmdlets）

インストールとライセンス

• Cmdlet のインストールには管理者権限が必要ですか？

必ずしも必要ではありません。

• Windows PowerShell 5.1（Windows）：管理者権限が推奨されます。特にすべてのユーザー向けにモジュールをインストールする場合に必要です。
• PowerShell 7 以降（Windows、macOS、Linux）：以下のコマンドを使用することで、管理者権限なしで現在のユーザー向けに Cmdlet をインストールできます：

  Install-Module APICmdlets -Scope CurrentUser

• インストーラーをダウンロードする必要がありますか？

CData PowerShell Cmdlets は PowerShell Gallery から配布されています。インストールは以下のコマンドで実行します：

Install-Module APICmdlets -Repository PSGallery -Force

接続

• 同じデータソースの複数のアカウントに接続するにはどうすればよいですか？

異なる認証プロパティを持つ個別の接続オブジェクトを作成します：

$conn1 = Connect-API -User User1 -Password Pwd1

$conn2 = Connect-API -User User2 -Password Pwd2

• PowerShell Cmdlets には DSN が必要ですか？

Cmdlet は ODBC DSN を使用しません。すべての接続プロパティは

Connect-Procore

で直接渡されます。
• プロキシサーバー経由で接続できますか？

多くの Cmdlet は以下のようなプロキシプロパティをサポートしています：

• ProxyServer
• ProxyPort
• ProxyUser
• ProxyPassword

データソース固有のヘルプドキュメントを参照してください。

パフォーマンスとトラブルシューティング

• クエリが遅いのはなぜですか？

よくある原因：

• フィルターがない（WHERE 句がない）
• 大量の結果セットを取得している
• クラウド API からのレイテンシ
• 増分戦略を使用していない

以下をお試しください：

• データをフィルタリングする（-Where パラメータ）
• 必要なカラムのみを選択する
• データソースの API スロットリング制限を確認する

クエリ最適化のサポートについては [email protected] までお問い合わせください。

• ログを有効にするにはどうすればよいですか？

以下のコマンドでモジュールのログを有効にします：

Set-ModuleLogging -Path "C:\logs\cdata.log" -Verbosity 3

CData サポートと連携する際は、ログファイルを安全にアップロードしてください。
• どのポートを開放する必要がありますか？

ほとんどのクラウドアプリケーション（Salesforce、HubSpot、Dynamics、Google API など）は HTTPS（443）を使用します。

ソースが追加のポートを必要とする場合は、固有のドキュメントを確認するか、[email protected] までお問い合わせください。

• コンテナ（Docker、Kubernetes）で Cmdlet を使用できますか？

コンテナに PowerShell 7 をインストールし、モジュールをインストールします：

pwsh -Command "Install-Module APICmdlets -Force"

その後、通常どおり認証を行います。

一般

• サポートされているすべての SQL/コマンド操作はどこで確認できますか？

各 Cmdlet にはローカルにインストールされたヘルプドキュメントが含まれており、オンラインでも参照可能です：https://www.cdata.com/powershell/

• PowerShell Cmdlets はどのくらいの頻度で更新されますか？

CData はメジャーアップデートを年次でリリースし、年間を通じて増分アップデートを行います。バージョンの入手可能性については、カスタマーポータルを確認するか、[email protected] までお問い合わせください。

• コード例はどこで確認できますか？

すべての Cmdlet にはヘルプドキュメントに例が含まれており、多くのサービスのオンライン例も提供されています：https://www.cdata.com/powershell/ 例には以下が含まれます：

• 基本的なクエリ
• Insert/Update/Delete
• OAuth フロー
• ファイル操作
• API 連携

この FAQ で解決しない場合は、[email protected] までお問い合わせください。