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

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

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

システム要件

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 StripeCmdlets -Repository PSGallery -Force

   このコマンドは：

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

モジュールの確認

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

Get-Module -ListAvailable "*Stripe*"

ライセンス認証

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

試用版ライセンス

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

正規ライセンスの認証

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

ライセンスの認証

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

Set-ModuleLicense ""

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

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

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

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

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

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

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

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

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

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

接続設定

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

Connect-Stripe cmdlet

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

Stripeへの接続

それでは、Stripe への接続について説明していきましょう。Stripe では、本番API キーまたはOAuth のいずれかによる認証をサポートしています。

本番API キー

本番API キーで接続するには、以下の2つの設定パラメータを設定する必要があります。

• AuthScheme = APIKey
• LiveAPIKey = 本番API キーの値

本番API キーの値を取得するには、以下の手順で確認できます：

1. Stripe ダッシュボードにログインします
2. 開発者 → API キー → シークレットキー → 本番環境のキーを表示 に移動します

Stripe では、テストモードで作成されたシークレットキーを使用して、'StripeV2' データモデルのエンティティにはアクセスできませんのでご注意ください。ライブモードまたはサンドボックスモードで作成されたシークレットキーをご利用ください。 さらに、制限付きキーを使用して'StripeV2' データモデルのエンティティにアクセスすることも許可されていません。

OAuth については、ヘルプドキュメントの「接続の確立」をご確認ください。

Stripe のデータ の取得

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

   Install-Module StripeCmdlets

2. Stripe に接続します：

     $stripe = Connect-Stripe  -OAuthClientId $OAuthClientId -OAuthClientSecret $OAuthClientSecret -CallbackURL $CallbackURL
     

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

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

クエリ例：

$results = Select-Stripe `
    -Connection $conn `
    -Table "Customers" `
    -Columns "Email,Discount" `
    -Where "Email != ''"

結果を表示します：

$results

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

よくある問題

認証エラー

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

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

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

Cmdlet が見つからない

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

Get-Module -ListAvailable "*Stripe*"

クエリが遅い

解決策：

• フィルターを追加してデータセットのサイズを削減してください
• サポートされている場合は $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 StripeCmdlets -Scope CurrentUser

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

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

Install-Module StripeCmdlets -Repository PSGallery -Force

接続

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

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

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

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

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

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

Connect-Stripe

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

多くの 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 StripeCmdlets -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] までお問い合わせください。