Partilhar via

Implementar pacotes utilizando o CRM Package Deployer e o Windows PowerShell

  • Artigo

 

Publicado: novembro de 2016

Aplica-se A: Dynamics CRM 2015

Microsoft Dynamics CRM Package Deployer e administradores de distribuição de pacotes num exemplo de Microsoft Dynamics CRM (local) ou de Microsoft Dynamics CRM Online . Um pacote “” podem consistir em alguns ou em qualquer seguintes:

  • Um ou mais ficheiros de solução do Dynamics 365.

  • Ficheiros lisos ou ficheiros de dados exportados de Ferramenta de Migração da Configuração. Para mais informações sobre o Ferramenta de Migração da Configuração, consulte Gerir dados de configuração.

  • Código personalizado que podem ser efetuadas durante ou após o pacote ser encaminhado para Microsoft Dynamics 365.

  • Específico conteúdo do pacote que a apresentar no início e fim do processo de implementação do pacote. Isto pode ser útil fornecer uma descrição de soluções e dos ficheiros que são implementados no pacote.

Os programadores criar pacotes utilizando o modelo de implementação do pacote em Microsoft Visual Studio.Mais informações:MSDN: Criar pacotes para o CRM Package Deployer

Após o pacote ser criado, pode executar o Implementador de Pacotes do CRM ou utilizando cmdlets de Windows PowerShell para a ferramenta.

Neste Tópico

Utilize a ferramenta Package Deployer do pacote do CRM para distribuir pacotes

Utilizar para implementar o Windows PowerShell pacotes

Resolver problemas de implementação do pacote utilizando ficheiros de registo

Melhores práticas de pacotes de distribuição

Utilize a ferramenta Package Deployer do pacote do CRM para distribuir pacotes

Só pode Ferramenta Implementador de Pacotes pacote processar uma de cada vez. Contudo, fornece os utilizadores a capacidade de selecionar um pacote para distribuir dos pacotes vários disponíveis no de Ferramenta Implementador de Pacotes. Alguns dos ecrãs e ações a ferramenta diferem com base na definição de pacote. Não necessita de instalar Ferramenta Implementador de Pacotes. Apenas transfira-a e execute-.

  1. Transferir o pacote para ser implementado. Um pacote é uma coleção de ficheiros e pastas criada na pasta de projetos do Visual Studio*(<Project>*\Bin\Debug) quando cria o projeto de pacote no Visual Studio. Copiar o seguinte da pasta de depuração do projeto:

    • Pasta <PackageName>: Esta pasta contém as soluções, a configuração de importação e os conteúdos para o pacote.

    • <PackageName>.dll: A assemblagem contém o código para o pacote. Por predefinição, o nome da assemblagem é igual ao nome do projeto do Visual Studio.

    Para obter informações detalhadas sobre como criar um pacote utilizando Visual Studio, consulte MSDN: Criar um pacote para a ferramenta Package Deployer.

    Para este tópico, vamos assumir que a pasta e a assemblagem do pacote da pasta de depuração de projetos do Visual Studio (<Project>\Bin\Debug) são copiadas para a pasta c:\DeployPackage.

  2. Transfira o pacote SDK do Microsoft Dynamics CRM. Em seguida, execute o ficheiro executável transferido para extrair o conteúdo do pacote.

  3. Navegue para a pasta SDK\Tools\PackageDeployer e copie a pasta e a assemblagem do pacote a partir de c:\DeployPackage para a pasta SDK\Tools\PackageDeployer.

  4. Após os ficheiros serem copiados, execute a ferramenta fazendo duplo clique no ficheiro PackageDeployer.exe na pasta SDK\Tools\PackageDeployer.

  5. Clique em Continuar no ecrã principal da ferramenta.

  6. No ecrã Ligar ao Microsoft Dynamics CRM, forneça detalhes de autenticação para ligar ao servidor do Dynamics 365 onde pretende implementar o pacote. Se tiver várias organizações e quiser selecionar a organização em que pretende implementar o pacote do selecione a caixa de verificação Apresentar sempre a lista de organizações disponíveis. Clique em Iniciar sessão.

  7. Se tiver várias organizações no Dynamics 365 e selecionou Apresentar sempre a lista de organizações disponíveis, o ecrã seguinte permite escolher a organização a que pretende ligar. Selecione uma organização do Dynamics 365 para ligar.

  8. O ecrã seguinte pede-lhe para selecionar um pacote ser implementado. Selecione o nome do pacote, clique Seguinte.

    Selecionar o seu pacote na Ferramenta Package Deployer

  9. Siga as instruções nos ecrãs subsequentes para concluir a implementação do pacote.

    Os são apresentados por com base na definição do pacote selecionado para a implementação. Para uma implementação do pacote ponto-a-ponto que utilize o Ferramenta Implementador de Pacotes, consulte o tópico para a implementação de pacotes de Unified Service Desk: Deploy sample Unified Service Desk applications to CRM Server using Package Deployer

Utilizar para implementar o Windows PowerShell pacotes

Ferramenta Implementador de Pacotes também fornece suporte de Windows PowerShell pacotes para distribuir.

Efetue os seguintes passos para utilizar os cmdlets de PowerShell para distribuir pacotes:

Pré-requisitos

Registar os cmdlets

Utilize o cmdlet para obter pacotes

Utilize o cmdlet para ligar ao servidor do CRM

Utilize o cmdlet para implementar pacotes

Detalhadas obter ajuda em cmdlets

Pré-requisitos

Seguem-se os pré-requisitos para utilizar os cmdlets de PowerShell :

  • PowerShell 3,0 ou superior é necessário para implementar um pacote utilizando PowerShell. Para verificar a versão de PowerShell, execute uma janela de PowerShell e execute o comando seguinte: $Host

  • Definir a política de execução para implementar scripts de PowerShell iniciada. Para tal, execute uma janela de PowerShell como administrador, e execute o comando seguinte: Set-ExecutionPolicy -ExecutionPolicy AllSigned

Registar os cmdlets

Tem de iniciar sessão cmdlets dos Windows PowerShell para Ferramenta Implementador de Pacotes antes de utilizá-lo. Para registar os cmdlets:

  1. Caso ainda não o tenha feito, transferir o pacote de Dynamics 365 SDK de Centro de Transferências da Microsoft, e executar o ficheiro de pacote para extrair o conteúdo do pacote. Vamos supor qual extraiu o pacote para a pasta c:\CRM no computador. O Ferramenta Implementador de Pacotes e outros ficheiros necessários ficam disponíveis na localização seguinte: c:\CRM\SDK\Tools\PackageDeployer.

  2. Inicie Windows PowerShell no computador com privilégios elevar (executar como administrador.)

  3. Na linha de comandos na janela do Windows PowerShell, altere o diretório para a pasta Windows PowerShell na pasta PackageDeployer. Neste caso:

    cd c:\CRM\SDK\Tools\PackageDeployer\PowerShell

  4. Execute o script RegisterXRMTooling.ps1 registar a assemblagem (dll) do Package Deployer Windows PowerShell e instalar o snap-in Windows PowerShell para o Ferramenta Implementador de Pacotes. Para tal, para introduzir o comando seguinte, e prima ENTER:

    .\RegisterXRMTooling.ps1

  5. Adicionar os Windows PowerShell para utilização em XRM de ferramentas. Isto cmdlets registará os seguintes: Get-CrmConnection e Get-CrmOrganizations.

    Add-PSSnapin Microsoft.Xrm.Tooling.Connector

  6. Adicione o snap-in do Windows PowerShell para o Package Deployer. Isto registará os seguintes cmdlets: Get-CrmPackages e Import-CrmPackage.

    Add-PSSnapin Microsoft.Xrm.Tooling.PackageDeployment

Agora está pronto a utilizar estes cmdlets de Windows PowerShell. Para criar os cmdlets que registou, execute o seguinte comando na linha na janela de Windows PowerShell :

Get-Help “Crm”

Utilize o cmdlet para obter pacotes

Antes de poder utilizar o cmdlet, certifique-se de que pretende copiar o pacote para a pasta de PackageDeployer (neste caso, c:\CRM\SDK\Tools\PackageDeployer). Um pacote é uma coleção de ficheiros e pastas criada na estrutura do projecto do Visual Studio(<Project>\Bin\Debug) quando cria o seu projecto no Visual Studio. Copie o inteiros da respetiva conceção desqualificar erros da pasta para a pasta de PackageDeployer. Para obter informações detalhadas sobre como criar um pacote utilizando o Visual Studio, consulte MSDN: Criar pacotes para o CRM Package Deployer.

  1. Na janela de PowerShell, utilize o cmdlet seguinte para reverter uma lista de pacotes de importação disponíveis no active directory especificado (neste caso, c:\CRM\SDK\Tools\PackageDeployer):

    Get-CrmPackages –PackageDirectory c:\CRM\SDK\Tools\PackageDeployer

  2. Se as informações sobre um pacote no diretório, pode utilizar o cmdlet de Obter CrmPackages - juntamente com o parâmetro de – PackageName para especificar o nome da assemblagem no que contém a definição de pacote.

    Get-CrmPackages –PackageDirectory c:\CRM\SDK\Tools\PackageDeployer –PackageName SampleCRMPackage.dll

Utilize o cmdlet para ligar ao servidor do CRM

  1. Forneça as suas credenciais para ligar à instância de Microsoft Dynamics CRM Online ou de Microsoft Dynamics CRM (local). Executar o comando seguinte pede-lhe introduzir o seu nome de utilizador e a palavra-passe para ligar ao Dynamics 365 exemplo, e não armazená-lo-emos a variável de $Cred e, posteriormente usamo-lo ligar ao servidor do CRM.

    $Cred = Get-Credential

  2. Utilize o comando seguinte obter uma ligação à instância de Microsoft Dynamics CRM Online ou de Microsoft Dynamics CRM (local). A armazenaremos a ligação a variável de $CRMConn :

    • Se estiver a ligar-se ao Microsoft Dynamics CRM (local) exemplo:

      $CRMConn = Get-CrmConnection -ServerUrl http://<your_CRM_Server> -OrganizationName <your_Org_Name> -Credential $Cred

    • Se estiver a ligar-se ao servidor do Microsoft Dynamics CRM Online:

      $CRMConn = Get-CrmConnection -DeploymentRegion NorthAmerica –OnlineType Office365 –OrganizationName <your_Org_Name> -Credential $Cred

      Nota

      Para o parâmetro de DeploymentRegion, os valores são, NorthAmericaEMEAe APAC. Para o parâmetro OnlineType, os valores válidos são Office365 and LiveID.

  3. As suas credenciais são fornecidas validadas quando executar o comando no passo 2.

Utilize o cmdlet para implementar pacotes

Em seguida, utilize as informações de ligação de CRM à variável de $CRMConn pacotes para implementar à instância de Dynamics 365. Execute o seguinte comando distribuir o pacote:

Import-CrmPackage –CrmConnection $CRMConn –PackageDirectory c:\CRM\SDK\Tools\PackageDeployer –PackageName SampleCRMPackage.dll –UnpackFilesDirectory c:\UnpackedFiles -Verbose

Nota

  • CrmConnection, PackageDirectory, e os parâmetros de PackageName são obrigatórios.

  • Para o parâmetro de PackageName, tem de especificar o nome da assemblagem que contém a definição de pacote.

  • Não necessita de especificar o parâmetro de UnpackFilesDirectory se o pacote não desembala ficheiros durante a implementação do pacote. Quando definir um pacote em Visual Studio, especifique se descompactar os ficheiros que utilizam o parâmetro de agentdesktopzipfile em ImportConfig.xml).Mais informações:MSDN: Criar pacotes para o CRM Package Deployer

  • O parâmetro de Verbose é opcional, e é utilizado para apresentar num registo das atividades efectuadas durante o processo de implementação do pacote.

Detalhadas obter ajuda em cmdlets

Na janela de PowerShell, utilize o cmdlet de Get-Help com um nome do cmdlet para ver uma ajuda detalhadas sobre o cmdlet. Por exemplo, para obter ajuda para o cmdlet detalhada de Import-CrmPackage :

Get-Help Import-CrmPackage -full

Para ver a ajuda online do cmdlets, consulte Referência do CRM PowerShell.

Resolver problemas de implementação do pacote utilizando ficheiros de registo

O Ferramenta Implementador de Pacotes fornece suporte de registo para obter informações detalhadas sobre os erros que podem ocorrer ao iniciar sessão na instância do Microsoft Dynamics CRM utilizando a ferramenta e implementando pacotes. A ferramenta gera três ficheiros de registo disponíveis na localização seguinte no computador que executa a ferramenta: c:\Users\<UserName >\AppData\Roaming\Microsoft\PackageDeployer\<Version >.

  • Login_ErrorLog.log: Fornece informações sobre problemas que ocorreram quando utilizou a ferramenta para iniciar sessão na instância do Dynamics 365. Se existir quaisquer problemas no início de sessão, uma mensagem apresentadas no ecrã de início de sessão de ferramentas com uma hiperligação para o ficheiro de registo. A mensagem indica que um erro ao processar o pedido de início de sessão e o utilizador pode ver o registo de erros. Pode clicar na hiperligação na mensagem para ver o ficheiro de registo. O ficheiro de registo é criado a primeira vez que encontrar problemas de início de sessão na ferramenta. Depois, o ficheiro de registo é utilizado para registar informações sobre problemas de início de sessão sempre que estes ocorrerem.

  • PackageDeployer.log: Fornece informações detalhadas sobre cada tarefa efectuada na ferramenta durante a implementação dos pacotes. Pode ver o ficheiro de registo a partir da ferramenta clicando na hiperligação Ver Ficheiro de Registo na parte inferior do ecrã.

  • ComplexImportDetail.log: Fornece informações detalhadas sobre os dados importados na última implementação utilizando a ferramenta. Sempre que implementar um pacote utilizando esta ferramenta, os detalhes existentes no ficheiro de registo são movidos para um ficheiro denominado ComplexImportDetail._old.log no mesmo diretório e o ficheiro ComplexImportDetail.log apresenta informações sobre a importação mais recente efectuada utilizando a ferramenta.

Melhores práticas de pacotes de distribuição

A distribuição de pacotes, os administradores de Dynamics 365 tem de:

  • Insista num conjunto deste pacote para que possa monitorizar um conjunto de volta à sua origem.

  • Testar o pacote numa instância de pré-produção (de preferência uma imagem exata da instância de produção) antes de a executar num servidor de produção.

  • Fazer uma cópia de segurança da instância de produção antes de implementar o pacote.

Consulte Também

MSDN: Criar pacotes para o CRM Package Deployer
Administrar o CRM 2015

© 2016 Microsoft Corporation. Todos os direitos reservados. Direitos de Autor