Administre a implantação usando o Windows PowerShell

 

Publicado: janeiro de 2017

Aplicável a: Dynamics 365 (on-premises), Dynamics CRM 2016

Com o Windows PowerShell você pode executar facilmente comandos de implantação para alterar a configuração da sua implantação, como tarefas que podem ser executadas usando a interface de usuário do Gerenciador de Implantação. É possível também usar os métodos descritos no SDK do Microsoft Dynamics 365 para executar essas tarefas. Os cmdlets do PowerShell são instalados no computador ao instalar a função servidor completo ou ao instalar a função do servidor Ferramentas de Implantação, se você estiver instalando funções do servidor individuais. Para executar comandos, primeiro você deve registrar os comandos do Microsoft Dynamics 365 com o PowerShell. Este tópico descreve como fazer isso mais tarefas adicionais para ajudá-lo a usar o PowerShell.

Encontre ajuda sobre os cmdlets do PowerShell para Microsoft Dynamics 365 em Referência do PowerShell para Microsoft Dynamics CRM.

Para obter mais informações sobre o uso do PowerShell, consulte Scripts com o Windows PowerShell.

Para obter mais informações sobre o uso programático do Serviço Web de Implantação, consulte MSDN: administrar a implantação usando o serviço Web de implantação.

Neste tópico

Introdução ao uso dos cmdlets PowerShell do Dynamics 365

Usar os cmdlets do PowerShell

Definir propriedades usando cmdlets do PowerShell

Obter os tópicos de Ajuda do cmdlet PowerShell do Dynamics 365

Atualizar definições de configuração de implantação usando o PowerShell.

Introdução ao uso dos cmdlets PowerShell do Dynamics 365

Registrar o cmdlets

1. Entre com a conta de administrador no servidor do Microsoft Dynamics 365.

2. Abra um prompt de comando do PowerShell.

3. Digite o seguinte comando.

   Add-PSSnapin Microsoft.Crm.PowerShell
   

   Esse comando adiciona o snap-in do Dynamics 365PowerShell à sessão atual. O snap-in é registrado durante a instalação e configuração do servidor do Microsoft Dynamics 365.

Importante

• Para informações sobre registro de cmdlets de conector de ferramenta XRM, Get-CrmConnection e Get-CrmOrganizations, consulte MSDN: Usar cmdlets do PowerShell para ferramentas XRM e conectar ao CRM.

• Para informações sobre registro do cmdlets de Package Deployer, consulte Implantar pacotes usando o Dynamics CRM Package Deployer e o Windows PowerShell.

• Você deve registrar os comandos Dynamics 365PowerShell; caso contrário, você receberá a seguinte mensagem quando tentar executar um cmdlet:

  O termo "Comando do Windows PowerShell do Microsoft Dynamics 365" não é reconhecido como o nome de um cmdlet, função, arquivo de script ou programa operável. Verifique a ortografia do nome ou, se um caminho tiver sido incluído, verifique se o caminho está correto e tente novamente.

Obter uma lista de cmdlets do Dynamics 365

• No prompt do PowerShell, digite o seguinte.

  Get-Help *Crm*
  

Obter ajuda para um cmdlet

• No prompt do PowerShell, digite o seguinte, substituindo CrmCmdletName pelo nome de um comando.

  Get-Help CrmCmdletName
  

Para obter ajuda detalhada para um cmdlet específico, use o Get-HelpCRMCmdlet–full, como o cmdlet Import-CRMOrganization.

Get-Help Import-CRMOrganization -full

Usar os cmdlets do PowerShell

Após registrar os comandos do Dynamics 365PowerShell, você pode usá-los para executar tarefas.

Use o comando a seguir para a saída da lista de administradores de implantação.

PS C:\Users\Administrator> Get-CrmDeploymentAdministrator

Esse comando resulta na saída a seguir.

ID	Nome	ExtensionData
--	----	-------------
4f431656-90f8-e211-831c-00155da83c4f	myDomainName\Administrator

Definir propriedades usando cmdlets do PowerShell

Após registrar os comandos do Microsoft Dynamics 365PowerShell, você pode usá-los para executar tarefas, como definir propriedades em toda implantação ao definir algumas propriedades da organização.

Por exemplo, para adicionar um administrador de implantação do Microsoft Dynamics 365, execute o seguinte comando onde domain\adminName é o domínio do Active Directory e o nome de usuário do administrador que você deseja adicionar.

New-CrmDeploymentAdministrator domain\adminName

Obter os tópicos de Ajuda do cmdlet PowerShell do Dynamics 365

Para obter uma lista completa de cmdlets do Microsoft Dynamics 365PowerShell com links para os tópicos da Ajuda, consulte a Referência do PowerShell para o Microsoft Dynamics CRM.

Atualizar definições de configuração de implantação usando o PowerShell.

Use o PowerShell para atualizar as configurações de implantação, como a autenticação baseada em declarações, a IFD (implantação para a internet) e os endereços da Web.Para obter mais informações:Atualizar definições de configuração de implantação.

Confira Também

Atualizar definições de configuração de implantação.
Operando o Microsoft Dynamics 365

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais