Automatyczne wdrażanie 3CX Softphone przy użyciu usługi Intune

Wprowadzenie

Wdrażanie aplikacji 3CX Softphone za pośrednictwem Microsoft Intune pozwala administratorom IT na jednoczesną instalację aplikacji na wielu urządzeniach z systemem Windows 11 bez konieczności ręcznej interwencji.

Konfiguracja portalu Intune

Aby skonfigurować portal Intune do automatycznej dystrybucji 3CX Softphone:

  • Zaloguj się do portalu Microsoft Intune przy użyciu konta administratora Intune.
  • Przejdź do „Apps” (Aplikacje) → „All Apps” (Wszystkie aplikacje).

  • Kliknij przycisk „Create” (Utwórz).

  • Ustaw typ aplikacji na „Microsoft Store app (new)” (Aplikacja ze sklepu Microsoft Store (nowa)); kliknij przycisk „Select” (Wybierz) na dole panelu.

  • Kliknij łącze „Search the Microsoft Store app (new)” (Wyszukaj aplikację ze sklepu Microsoft Store (nowa)).

  • W polu wyszukiwania wpisz „3CX”, wybierz aplikację 3CX z listy i kliknij przycisk „Select” (Wybierz) na dole panelu.

  • W zakładce „App information” (Informacje o aplikacji) pozostaw wszystkie pola z ich domyślnymi wartościami i kliknij przycisk „Next” (Dalej).

  • W zakładce „Assignments” (Przypisania) wybierz użytkowników, dla których aplikacja ma zostać wdrożona; zazwyczaj przypisuje się jedną lub więcej grup zabezpieczeń („Security Groups”) reprezentujących użytkowników, którzy muszą korzystać z aplikacji; po zakończeniu kliknij przycisk „Next” (Dalej).
  • W zakładce „Review + create” (Przejrzyj i utwórz) po prostu kliknij przycisk „Create” (Utwórz).

Aplikacja 3CX Softphone została dodana do usługi Intune i zostanie wdrożona u wybranych użytkowników.

Dodatkowo: Obsługa argumentów wiersza poleceń

Obecnie obsługiwane są następujące opcje wiersza poleceń:

  • --restore-defaults, -R: Przywraca wszystkie ustawienia konfigurowalne przez CLI do ich wartości domyślnych. Jeśli podano dodatkowe opcje, zostaną one zastosowane po przywróceniu ustawień domyślnych.
  • --host: Wstępnie ładuje adres URL centrali PBX podczas ręcznej autokonfiguracji (provisioningu) za pomocą poświadczeń lub 2FA.
  • --echo-cancellation, -e: Włącza lub wyłącza eliminację echa (true | false).
  • --ringer-volume, -r: Ustawia głośność dzwonka (25, 50, 75, 100).
  • --mic-gain, -m: Ustawia wzmocnienie mikrofonu (100–400).
  • --crm: Włącza lub wyłącza integrację CRM (true | false).
  • --crm-action: Ustawia zachowanie integracji CRM (OpenBrowser | OpenApp).
  • --crm-exe-path: Definiuje ścieżkę do pliku wykonywalnego dla integracji CRM.
  • --crm-exe-params: Definiuje parametry przekazywane do pliku wykonywalnego CRM.
  • --crm-notify-when: Ustawia moment wyzwalania powiadomień CRM (Ringing | Connected).
  • --tapi: Włącza lub wyłącza integrację TAPI (true | false).
  • --provision-via-desktop-app: Migruje istniejące konto aplikacji desktopowej (Desktop App) do nowego Softphonu.

Uwaga: Aby ustawienia zostały pomyślnie zastosowane, klient Softphone musi być zainstalowany i całkowicie zamknięty przed uruchomieniem poleceń. Wykonanie poleceń spowoduje automatyczne uruchomienie aplikacji. Administratorzy wdrażający te ustawienia za pomocą skryptów powinni wcześniej zakończyć działanie wszelkich uruchomionych instancji. Przykładowe polecenie PowerShell: Stop-Process -Name "3CXSoftphone" -Force

Pełny przykład PowerShell:

Start-Process "shell:AppsFolder\3CXDMCC.3CX_bhm4yemhnd70e!App" -ArgumentList "--host https://my3cxpbxurl.domain.tld --echo-cancellation true --ringer-volume 50 --mic-gain 250 --crm true --crm-action OpenApp --crm-exe-path ""C:\Program Files\App.exe"" --crm-exe-params ""%CallerNumber% %CallerDisplayName%"" --crm-notify-when Connected --tapi true"

Zobacz również


Ostatnia aktualizacja
Ten dokument został ostatnio zaktualizowany 27 lipca 2026 r.
https://www.3cx.pl/docs/softphone-intune/