使用 Windows PowerShell 管理部署

 

发布日期: 2017年1月

适用于: Dynamics 365 (on-premises),Dynamics CRM 2016

通过 Windows PowerShell,您可以轻松运行部署命令以更改部署配置,例如从 部署管理器 用户界面中能够执行的任务。 还可以使用 Microsoft Dynamics 365 SDK 中介绍的方法来执行这些任务。PowerShell cmdlet 是在您安装完全服务器角色或安装部署工具服务器角色(如果要安装单个服务器角色)时安装在计算机上的。 若要执行命令,您必须首先使用 PowerShell 注册 Microsoft Dynamics 365 命令。 本主题介绍如何执行此额外任务以帮助您使用 PowerShell。

Microsoft Dynamics CRM 引用中查找有关 Microsoft Dynamics 365 的 PowerShell cmdlet 帮助。

有关使用 PowerShell 的详细信息,请参阅使用 Windows PowerShell 编写脚本

有关以编程方式使用 部署 Web 服务 的详细信息,请参阅 MSDN:开发人员中心中的“使用部署 Web 服务管理部署”。

本主题内容

开始使用 Dynamics 365 PowerShell cmdlet

使用 PowerShell cmdlet

使用 PowerShell cmdlet 设置属性

获取 Dynamics 365 PowerShell cmdlet 帮助主题

使用 PowerShell 更新部署配置设置

开始使用 Dynamics 365 PowerShell cmdlet

注册 cmdlet

  1. 登录到 Microsoft Dynamics 365 服务器上的管理员帐户。

  2. 打开 PowerShell 命令提示符。

  3. 输入以下命令。

    Add-PSSnapin Microsoft.Crm.PowerShell
    

    此命令将 Dynamics 365PowerShell 管理单元添加到当前会话。 该管理单元在安装和设置 Microsoft Dynamics 365 服务器的过程中注册。

重要

  • 有关注册 XRM tooling connector cmdlet、Get-CrmConnection 和 Get-CrmOrganizations 的信息,请参阅 MSDN:使用 XRM PowerShell cmdlets 工具连接到 CRM

  • 有关注册 Package Deployer cmdlet 的信息,请参阅 使用 Dynamics CRM Package Deployer 和 Windows PowerShell 部署包

  • 您必须注册 Dynamics 365PowerShell 命令;否则,您在尝试运行 cmdlet 时将收到以下消息。

    Microsoft Dynamics 365 Windows PowerShell 命令”一词未被识别为 cmdlet、函数、脚本文件或可操作程序的名称。 请检查该名称的拼写,或者,如果包括路径,请确保路径正确并重试。

获取 Dynamics 365 cmdlet 的列表

  • 在 PowerShell 提示符处,键入以下内容。

    Get-Help *Crm*
    

获取 cmdlet 的帮助

  • 在 PowerShell 提示符处键入以下内容,使用命令名称替换 CrmCmdletName

    Get-Help CrmCmdletName
    

有关特定 cmdlet 的详细帮助,请使用 Get-HelpCRMCmdlet–full,如 Import-CRMOrganization cmdlet。

Get-Help Import-CRMOrganization -full

使用 PowerShell cmdlet

注册 Dynamics 365PowerShell 命令后,即可将其用于执行任务。

使用以下命令输出部署管理员列表。

PS C:\Users\Administrator> Get-CrmDeploymentAdministrator

此命令会造成以下输出。

ID

客户

延长日期

--

----

-------------

4f431656-90f8-e211-831c-00155da83c4f

myDomainName\管理员

使用 PowerShell cmdlet 设置属性

注册了 Microsoft Dynamics 365PowerShell 命令后,您就可以将其用于执行任务,例如设置相关部署属性或设置一些组织属性。

例如,要添加 Microsoft Dynamics 365 部署管理员,请运行以下命令,其中domain\adminName 是想要添加的管理员的 Active Directory 域和用户名。

New-CrmDeploymentAdministrator domain\adminName

获取 Dynamics 365 PowerShell cmdlet 帮助主题

要获取包含帮助主题链接的 Microsoft Dynamics 365PowerShell cmdlet 的完整列表,请参阅 Microsoft Dynamics CRM PowerShell 引用

使用 PowerShell 更新部署配置设置

使用 PowerShell 更新部署设置,如基于声明的身份验证、面向 Internet 的部署 (IFD) 和 Web 地址。详细信息:更新部署配置设置

另请参阅

更新部署配置设置
操作 Microsoft Dynamics 365

© 2017 Microsoft。 保留所有权利。 版权