Instalowanie Microsoft Dynamics 365 for Outlook przy użyciu wiersza polecenia
Instalowanie programu Microsoft Dynamics 365 for Outlook jest dwuetapową procedurą. Po pierwsze należy uruchomić Instalatora, aby zainstalować pliki na komputerze. Następnie uruchom kreatora konfiguracji usługi Dynamics 365 for Customer Engagement w celu skonfigurowania aplikacji i zakończenia instalacji.
Ważne
Jeśli występuje konflikt między wartością w pliku konfiguracji a wartością w parametrach wiersza polecenia, pierwszeństwo ma parametr wiersza polecenia.
Krok 1: Instalowanie plików
Uwaga
Zobacz Zainstaluj Dynamics 365 for Outlook, aby poznać instrukcje dotyczące pobierania.
Następujące polecenie wyświetla dostępne opcje uruchamiania konfiguracji Microsoft Dynamics CRM for Outlook z wiersza polecenia:
Setupclient.exe [/A] [/Q] [/X] [/L or /LV "[drive:][[ path] logfilename.log]"] [/targetdir "[drive:][ path]"] [/installofflinecapability] [/disableofflinecapability] [/ignoreofflinequeue]
Przykłady poleceń dla instalacji Dynamics 365 for Outlook
Dla użytkowników, którzy podróżują lub którzy nie zawsze są połączeni z programem Dynamics 365 Server, program Dynamics 365 for Microsoft Office Outlook with Offline Access zapewnia dostęp do danych ich klientów. Aby zainstalować Dynamics 365 for Microsoft Office Outlook z dostępem w trybie offline w trybie quiet:
Setupclient /Q /l c:\clientinstalllog.txt /installofflinecapability /targetdir "c:\Program Files\Microsoft Dynamics CRM Client"
Aby odinstalować Dynamics 365 for Microsoft Office Outlook z dostępem w trybie offline w trybie quiet:
SetupClient /x /q
Parametry dla instalacji Dynamics 365 for Outlook
| Parametr | opis |
|---|---|
| Brak | Jeżeli nie określono parametrów, program Setupclient.exe wyświetli wszystkie ekrany. |
| installofflinecapability | Określa, czy tryb offline zostanie zainstalowany. Po dodaniu tego parametru tryb offline i jego składniki są instalowane. Jeśli ten parametr nie jest określony, jest instalowany tylko klient internetowy. |
| /targetdir <"drive:\path"> | Określa folder, w którym zostaną zainstalowane pliki programu Dynamics 365 for Outlook. |
| /A | Tworzy instalację administracyjną programu Dynamics 365 for Outlook przez utworzenie pakietu Instalatora Windows. Ten pakiet pozwala użytkownikom uruchamiać Setup z udziału sieciowego lub pozwala nieadministracyjnym użytkownikom uruchamiać Setup, który jest sterowany przez zasady grupy. Ten parametr musi być używany z parametrem /targetdir opisanym wcześniej. Podczas korzystania z tego parametru wartość /targetdir nie musi określać katalogu na komputerze lokalnym. Może być używany zmapowany dysk lub udział sieciowy, taki jak \\share\mscrm_client_admin.
Ważne: Jeżeli nie zostanie określony folder docelowy za pomocą parametru /targetdir, Setup instaluje instalację administracyjną w domyślnym folderze <drive:> Program Files\Microsoft Dynamics CRM. Na przykład polecenie: Setupclient /Q /A /targetdir "\\share\mscrm_client_admin" |
| /Q | Instalacja w trybie cichym. Ten parametr wymaga pliku konfiguracji w formacie XML. Parametr /i zawiera nazwę pliku konfiguracji XML. Na ekranie nie pojawią się żadne okna dialogowe ani komunikaty o błędach. Aby przechwycić informacje komunikatu o błędzie, należy dołączyć parametr pliku dziennika (/L lub /LV). |
| /L [drive:][[path] logfilename.log] | Tworzy plik dziennika z przebiegu instalacji. Należy określić nazwę pliku dziennika i miejsce jego lokalizacji, ale ścieżka nie może być ścieżką względną, taką jak %appdata%\CRMLogs. |
| /LV [drive:][[path] logfilename.log] | Tworzy pełny plik dziennika z przebiegu instalacji. Należy określić nazwę pliku dziennika i miejsce jego lokalizacji, ale ścieżka nie może być ścieżką względną, taką jak %appdata%\CRMLogs. |
| disableofflinecapability | Po określeniu tego parametru program Dynamics 365 for Outlook jest tak skonfigurowany, aby ukryć przycisk „przejścia do trybu offline” w aplikacji. Ten przycisk umożliwia użytkownikom przełączanie się do programu Dynamics 365 for Outlook w trybie offline. |
| ignoreofflinequeue | Po określeniu tego parametru Setup nie będzie próbował synchronizować elementów, które mogą pozostać w kolejce offline podczas uaktualniania. |
| /X | Odinstalowuje program Dynamics 365 for Outlook. Jest to opcja trybu konserwacji, która jest dostępna tylko wtedy, kiedy aplikacja jest już zainstalowana. |
Przykładowy plik konfiguracji XML programu Dynamics 365 for Outlook do instalacji
Poniższy przykładowy plik konfiguracji instaluje program Dynamics 365 for Outlook bez możliwości dostępu w trybie offline do folderu Program Files.
Uwaga
Można użyć tego samego pliku, który zawiera elementy instalacji i konfiguracji. Konfiguracja i Kreator konfiguracji ignorują elementy, które nie są istotne dla operacji.
<Deployments>
<TargetDir>c:\program files\Microsoft Dynamics CRM\Client</TargetDir>
<InstallOfflineCapability>false</InstallOfflineCapability>
</Deployments>
Krok 2: Konfigurowanie Dynamics 365 for Outlook pomocą pliku konfiguracji XML
Po zainstalowaniu programu Dynamics 365 for Outlook należy go skonfigurować. Można to zrobić, uruchamiając Kreatora konfiguracji aplikacji Dynamics 365 dla programu Outlook w wierszu polecenia. Plik Configuration Wizard ma nazwę Microsoft.Crm.Application.Outlook.ConfigWizard.exe i znajduje się w folderze Client\ConfigWizard, gdzie zainstalowano Dynamics 365 for Outlook. Domyślnie, ten folder to C:\Program Files\Microsoft Dynamics CRM.
Uwaga
Poświadczenia użytkownika, który będzie uruchamiał program Dynamics 365 for Outlook, są używane do uwierzytelniania w programie Dynamics 365 for Customer Engagement. W związku z tym, aby dokonać cichej konfiguracji programu Dynamics 365 for Outlook, należy uruchomić narzędzie Configuration Wizard w kontekście użytkownika, np. uruchamiając plik wsadowy wywoływany przez użytkownika lub jako jednorazowy wpis w skrypcie logowania. Aby uzyskać więcej informacji, zobacz Poświadczenia użytkownika są wymagane podczas uruchamiania Kreatora konfiguracji. Aby wdrożyć Dynamics 365 for Outlook przy użyciu zasad grupy firmy Microsoft, zobacz Wdróż Microsoft Dynamics 365 for Outlook za pomocą zasad grupy.
Jeśli ścieżka do pliku konfiguracji nie zostanie określona Configuration Wizard szuka domyślnego pliku konfiguracji (default_client_config.xml) w folderze pliku niemobilnego (%localappdata%\Microsoft\MSCRM\). Jeśli plik nie jest zlokalizowany w folderze profilu niemobilnego, Configuration Wizard szuka folderu, gdzie jest zainstalowany program Dynamics 365 for Outlook. Domyślnie rozwiązanie Dynamics 365 for Outlook jest instalowane w folderze CRM C:\Program Files\Microsoft Dynamics CRM.
Jeśli plik konfiguracji znajduje się w lokalizacji profilu mobilnego używanej przez inne aplikacje (AppData\Roaming\Microsoft\MSCRM\), nie będzie honorowany.
Przykłady poleceń dla konfiguracji Dynamics 365 for Outlook
Następujące polecenie konfiguruje program Microsoft Dynamics 365 for Outlook with Offline Access za pomocą pliku o nazwie config_client.xml w trybie cichym oraz generuje wyjściowy plik dziennika o nazwie clientinstall.log:
Microsoft.Crm.Application.Outlook.ConfigWizard.exe /Q /i c:\config_client.xml /xa /l c:\clientinstall.log
Parametr konfiguracji trybu cichego /Q wymaga pliku konfiguracji w formacie XML. Na ekranie nie pojawią się żadne okna dialogowe ani komunikaty o błędach. Aby przechwycić informacje komunikatu o błędzie, należy dołączyć parametr pliku dziennika (/L) lub pełnego protokołowania (/LV).
Ważne
Do uruchomienia narzędzia Configuration Wizard w trybie cichym są wymagane prawidłowe poświadczenia użytkownika przechowywane w magazynie systemu Windows. Więcej informacji: Poświadczenia użytkownika są wymagane podczas uruchamiania Kreatora konfiguracji
Parametr wiersza polecenia /i [drive:] [[path] configfilename.xml]] dostarcza narzędziu Microsoft Dynamics CRM for Outlook Setup wymagane informacje. To te same informacje, których wymaga każdy ekran instalacyjny. Elementy XML muszą być w języku angielskim (amerykańskim); nie można używać znaków specjalnych ani rozszerzonych. Plik konfiguracji XML, który zawiera przetłumaczone elementy XML, nie będzie działał poprawnie. Wyjaśnienie każdego elementu XML i przykładowy plik XML następują poniżej:
Parametr /xa, jeśli jest używany z parametrem /q, powoduje usunięcie wszystkich organizacji, które są skonfigurowane dla programu Dynamics 365 for Outlook.
Parametr /R może służyć do pomijania interfejsu użytkownika narzędzia Configuration Wizard i wyświetlania tylko okna dialogowego postępu. Ten parametr wymaga prawidłowego pliku XMLSetup, który ma nazwę Default_Client_Config.xml i musi być zlokalizowany w AppData lokalnego użytkownika lub w folderze instalacyjnym Klienta.
Elementy pliku konfiguracji XML programu Dynamics 365 for Outlook
| Element | opis |
|---|---|
| <Deployments></Deployments> | Plik konfiguracji musi być prawidłowym plikiem XML używającym <Deployment> jako elementu głównego. |
| <InstallOfflineCapability>true/false</InstallOfflineCapability> | Określa typ instalacji programu Dynamics 365 for Outlook. Określanie spowoduje true zainstalowanie firmy Microsof Dynamics 365 for Outlook z możliwością dostępu w trybie offline. |
| <TargetDir>drive:\path</TargetDirectory> | Określa folder, w którym zostaną zainstalowane pliki programu Dynamics 365 for Outlook. |
| <Deployment></Deployment> | Element nadrzędny dla wszystkich kolejnych elementów. |
| <DiscoveryUrl>https://website:portnumber</DiscoveryUrl> | Określa adres URL usługi Sieci Web Dynamics 365 for Customer EngagementDiscovery. W przypadku Dynamics 365 for Customer Engagement użyj pełnego adresu URL organizacji, takiego jak https://orgname.crm.dynamics.com (lub, w zależności od środowiska online i lokalizacji), użyj adresu URL usługi odnajdywania w formularzu https://disco.crm.dynamics.com. Aby zapoznać się z lista adresów URL, zobacz MSDN: Usługa odnajdowania. |
| <FederatedAuthentication>true/false</FederatedAuthentication> | Określa, czy poświadczenia federacyjne (Azure Active Directory) są używane do uwierzytelniania w Configuration Wizard. Jeśli określisz false, możesz użyć poświadczeń, takich jak user@contoso.onmicrosoft.com.. |
| <Organizations></Organizations> | Jest to element nadrzędny dla następującego elementu <Organizacja>. |
| <Organization FriendlyName="My Friendly Organization Name" IsPrimary="true"/"false">OrganizationName</Organization> | Określa nazwę organizacji, z którą klient będzie się łączył. FriendlyName. Określa nazwę wyświetlaną inną niż nazwa organizacji w programie Outlook. IsPrimary. Określa organizację, która będzie skonfigurowana jako organizacja synchronizująca w programie Dynamics 365 for Outlook. Uwaga:OrganizationName uwzględnia wielkość liter. |
| <CEIPNotification>true/false</CEIPNotification> | Określa, czy Dynamics 365 for Outlook będzie wyświetlać powiadomienie "Chcę dołączyć do programu poprawy jakości obsługi klienta". Ustawieniem domyślnym jest true i powiadomienie jest wyświetlane. Jeśli określisz false, powiadomienie nie pojawia się w Dynamics 365 for Outlook. Więcej informacji: Program poprawy jakości obsługi klienta firmy Microsoft |
Poświadczenia użytkownika są wymagane podczas uruchamiania Kreatora konfiguracji
Kreator konfiguracji wymaga podania danych uwierzytelniających użytkownika. Podczas cichego konfigurowania z użyciem /Q z plikiem Microsoft.Crm.Application.Outlook.ConfigWizard.exe, Configuration Wizard będzie szukać poświadczeń klienta w Magazynie systemu Windows. Jeśli Configuration Wizard nie może odnaleźć poświadczeń lub poświadczenia nie są w wymaganym formacie, konfigurowanie nie zostanie ukończone i w pliku dziennika konfiguracji zostanie zarejestrowany błąd. Należy zauważyć, że Configuration Wizard nie obsługuje dodawania UPN użytkownika ani hasła w pliku konfiguracji XML. Aby uzyskać więcej informacji dotyczących magazynu systemu Windows i Menedżera poświadczeń, zobacz Menedżer poświadczeń systemu Windows.
Przykładowy plik konfiguracji XML programu Dynamics 365 for Outlook do konfiguracji
Następujący przykładowy plik konfiguracji konfiguruje program Dynamics 365 for Outlook do łączenia się z organizacją podstawową o nazwie Contoso i inną organizacją o nazwie AdventureWorksCycle na serwerze programu Dynamics 365 Server o nazwie crmserver.
Uwaga
Można użyć tego samego pliku, który zawiera elementy instalacji i konfiguracji. Konfiguracja i Kreator konfiguracji ignorują elementy, które nie są istotne dla operacji.
Przykładowy plik Default_Client_Config.xml
<Deployments>
<Deployment>
<DiscoveryUrl>https://crmserver</DiscoveryUrl>
<Organizations>
<Organization IsPrimary='true'>Contoso</Organization>
<Organization>AdventureWorksCycle</Organization>
</Organizations>
<CEIPNotification>false</CEIPNotification>
</Deployment>
</Deployments>
Uwaga
Poprzedni przykład określa dwa różne organizacje, do których użytkownik ma dostęp i konfiguruje Dynamics 365 for Outlook, aby nie był wyświetlane powiadomienie "Chcę dołączyć do programu poprawy jakości obsługi klienta". Wartość w elemencie Organization nie może zawierać znaków specjalnych ani spacji. Dla Customer Engagement (on-premises) możesz znaleźć unikatową nazwę organizacji, uruchamiając polecenie cmdlet Get-CrmOrganization Windows PowerShell lub przejść do Ustawienia>Dostosowania>Zasoby dla programistów i pod Informacje referencyjne o wystąpieniu skopiować Unikatową nazwę.
Konfigurowanie Dynamics 365 for Outlook za pomocą skryptu
Napisz skrypt, który automatycznie aktualizuje ustawienia konfiguracyjne dla użytkowników programu Dynamics 365 for Outlook. Można użyć wierszy takich jak wskazano poniżej, aby wykonywać podstawowe czynności konfiguracyjne w oparciu o nowy plik konfiguracji, który jest przechowywany na komputerze o nazwie <
servername>.W poniższym skrypcie domyślny plik konfiguracji klienta jest zastępowany, organizacje skonfigurowanych wcześniej są usuwane, poświadczenia użytkownika są dodawane do magazynu systemu Windows, a nowa organizacja jest instalowana.
copy /y \\<servername>\share\Default_Client_Config.xml "c:\Program Files\Microsoft Dynamics CRM\Default_Client_Config.xml" "C:\Program Files\Microsoft Dynamics CRM\Client\ConfigWizard\Microsoft.Crm.Application.Outlook.ConfigWizard.exe" /q /xa cmdkey /generic:Microsoft_CRM_https://disco.crm.dynamics.com/ /user:user@contoso.com /password{password_goes_here} "C:\Program Files\Microsoft Dynamics CRM\Client\ConfigWizard\Microsoft.Crm.Application.Outlook.ConfigWizard.exe" /q /i "C:\Program Files\Microsoft Dynamics CRM\Default_Client_Config.xml"Napiwek
Należy rozważyć uruchomienie skryptu jako skryptu logowania lub wymuszenie uruchomienia skryptu w określonym czasie, na przykład za pomocą programu Microsoft System Center 2012 Configuration Manager.
W skrypcie można również dołączyć logikę wykrywania, która wykrywa, czy komputer kliencki został już skonfigurowany. Jeśli tak, skrypt może zakończyć działanie bez wykonywania żadnej akcji.
Przykładowy plik Default_Client_Config.xml
<Deployment> <DiscoveryUrl>https://CrmDiscoveryUrl</DiscoveryUrl> <Organizations> <Organization IsPrimary='true'>Organization1</Organization> </Organizations> </Deployment>Uruchom skrypt na każdym komputerze klienckim w organizacji, w której serwer został zmieniony. Można uruchomić skrypt na różne sposoby, w tym poprzez kartę Profil w oknie dialogowym właściwości użytkownika w przystawce Active Directory Users and Computers (ADUC) lub za pomocą obiektów zasad grupy (GPO).