Administre a implantação usando o Windows PowerShell

 

Publicado: novembro de 2016

Aplicável a: Dynamics CRM 2015

O Windows PowerShell permite 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 CRM 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 CRM 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 CRM 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 CRM

Usar os cmdlets do PowerShell

Definir propriedades usando cmdlets do PowerShell

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

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

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

Registrar o cmdlets

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

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 CRMPowerShell à sessão atual. O snap-in é registrado durante a instalação e configuração do servidor do Microsoft Dynamics CRM.

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 Package Deployer e Windows PowerShell do CRM.

• Você deve registrar os comandos do Dynamics CRMPowerShell. Caso contrário, receberá a seguinte mensagem quando tentar executar um cmdlet:

  O termo "Comando do Windows PowerShell do Microsoft Dynamics CRM" 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 CRM

1. No prompt do PowerShell, digite o seguinte:

   Get-Help *Crm*
   

Obter ajuda para um cmdlet

1. 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

Assim que registrar os comandos do Dynamics CRMPowerShell, você poderá 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

Assim que registrar os comandos do Microsoft Dynamics CRMPowerShell, você poderá 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 CRM, 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-CrmDeploymentAdminstrator domain\adminName

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

Para obter uma lista completa de cmdlets do Microsoft Dynamics CRMPowerShell 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 CRM 2015

© 2016 Microsoft Corporation. Todos os direitos reservados. Direitos autorais