Windows PowerShell を使用した展開の管理
公開日: 2017年1月
対象: Dynamics 365 (on-premises)、Dynamics CRM 2016
Windows PowerShell を使用すると、展開コマンドを容易に実行して、展開マネージャー ユーザー インターフェイスから実行できるタスクなどの、展開の構成を変更することができます。 また、Microsoft Dynamics 365 SDK で説明されているメソッドを使用して、これらのタスクを実行することもできます。 別々のサーバーの役割をインストールする場合、フル サーバーの役割をインストールするとき、または 展開ツール サーバーの役割をインストールするときに、PowerShell コマンドレットがコンピューターにインストールされます。 コマンドを実行するには、最初に PowerShell で Microsoft Dynamics 365 を登録する必要があります。 このトピックでは、これを実行する方法と、PowerShell の使用に役立つそのほかのタスクについて説明します 。
Microsoft Dynamics 365 の PowerShell の コマンドレットに関するヘルプは、Microsoft Dynamics CRM PowerShell リファレンス にあります。
PowerShell の使い方の詳細については、「Windows PowerShell でのスクリプティング」を参照してください。
展開 Web サービス のプログラム的な使用方法の詳細については、MSDN: 展開 Web サービスを使用した展開の管理を参照してください。
このトピックの内容
Dynamics 365 PowerShell コマンドレットの使い方の基本
PowerShell コマンドレットの使用
PowerShell コマンドレットを使用してプロパティを設定
Dynamics 365 PowerShell コマンドレットのヘルプの取得
PowerShell を使用した展開構成設定の更新
Dynamics 365 PowerShell コマンドレットの使い方の基本
コマンドレットの登録
Microsoft Dynamics 365 サーバーの管理者アカウントにサインインします。
PowerShell コマンド プロンプトを開きます。
次のコマンドを入力します。
Add-PSSnapin Microsoft.Crm.PowerShellこのコマンドにより、Dynamics 365PowerShell スナップインが現在のセッションに追加されます。 このスナップインは、Microsoft Dynamics 365 サーバーのインストールおよびセットアップ時に登録されます。
重要
-
XRM ツール コネクタ コマンドレット、Get-CrmConnection、Get-CrmOrganizations の詳細については、「MSDN: XRM ツール用の PowerShell コマンドレットを使用して CRM に接続」を参照してください。
-
Package Deployer コマンドレットの登録については、「Dynamics CRM Package Deployer および Windows PowerShell を使用してパッケージを展開する」を参照してください。
-
Dynamics 365 の PowerShell コマンドを登録する必要があります。登録しない場合、コマンドレットを実行しようとしたときに、次のメッセージが表示されます。
用語「Microsoft Dynamics 365 Windows PowerShell command」は、コマンドレット、関数、スクリプト ファイル、または操作可能なプログラムの名前として認識されません。 名前が正しく記述されていることを確認し、パスが含まれている場合はそのパスが正しいことを確認してから、再試行してください。"
Dynamics 365 のコマンドレットの一覧を取得
PowerShell プロンプトで、以下を入力します。
Get-Help *Crm*
コマンドレットのヘルプを取得
PowerShell プロンプトで、次のように入力して、CrmCmdletName を次のコマンドの名前に置き換えます。
Get-Help CrmCmdletName
特定のコマンドレットの詳細なヘルプについては、Import-CRMOrganization コマンドレットのような、Get-HelpCRMCmdlet–full を使用します。
Get-Help Import-CRMOrganization -full
PowerShell コマンドレットの使用
Dynamics 365 の PowerShell コマンドを登録すると、タスクを実行する場合に使用できます。
次のコマンドを使用して、展開管理者の一覧を出力します。
PS C:\Users\Administrator> Get-CrmDeploymentAdministrator
このコマンドを実行すると、次の出力が得られます。
ID |
名前 |
ExtensionData |
-- |
---- |
------------- |
4f431656-90f8-e211-831c-00155da83c4f |
myDomainName\Administrator |
PowerShell コマンドレットを使用してプロパティを設定
Microsoft Dynamics 365 の PowerShell コマンドを登録したら、展開全体のプロパティの設定や組織プロパティの設定など、タスクの実行に使用できます。
たとえば、Microsoft Dynamics 365 展開管理者を追加するには、次のコマンドを実行します。domain\adminName は、追加する必要のある管理者の Active Directory ドメインとユーザー名です。
New-CrmDeploymentAdministrator domain\adminName
Dynamics 365 PowerShell コマンドレットのヘルプの取得
ヘルプのトピックへのリンクが付いた Microsoft Dynamics 365 の PowerShell のコマンドレットの一覧については、「Microsoft Dynamics CRM PowerShell リファレンス」を参照してください。
PowerShell を使用した展開構成設定の更新
クレームベース認証、インターネットに接続する展開 (IFD)、Web アドレスなど、展開全体の設定を更新するには、PowerShell を使用します。詳細:展開構成設定を更新する
関連項目
展開構成設定を更新する
Microsoft Dynamics 365 の運用
© 2017 Microsoft. All rights reserved. 著作権