Składnia komendy PairTool

Ważne

Funkcja PairTool jest obecnie dostępna w wersji zapoznawczej. Te informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed jego wydaniem. Firma Microsoft nie udziela żadnych gwarancji, wyrażonych ani domniemanych, w odniesieniu do podanych tutaj informacji.

Aby uruchomić narzędzie PairTool, otwórz okno wiersza polecenia i wpisz polecenie przy użyciu następującej składni i poleceń.

pairtool [/enum-endpoints <...> | /enum-services <...> | /enum-containers <...> | 
          /enum-protocols <...> | /associate <...> | /associate-oob <...> | 
          /disassociate <...> | /challenge <...> | /?]

/enum-endpoints

Wylicza punkty końcowe urządzeń za pośrednictwem różnych protokołów, które obsługuje system Windows. Przykłady punktów końcowych: bezprzewodowy zestaw słuchawkowy, drukarka sieciowa lub telewizor.

  /enum-endpoints [/protocol <protocol1>[,<protocol2>[,...]] [/persisted]
                  [/sync] [/instance <id1>[,<id2>[,...]] [/url <url>]] 
                  [/continuous] [/format <txt | xml | csv>] 
                  [/output-file <filename>]

Flagi:

  • /protocol - Protokoły, za pomocą których można odnaleźć. Użyj przecinków, aby oddzielić wiele protokołów. Możliwe protokoły są wyliczane za pomocą polecenia /enum-protocols. Identyfikator protokołu i wartości klas są akceptowalnymi danymi wejściowymi.

  • /persisted — Wylicz punkty końcowe utrwalone w systemie operacyjnym. Opcja /persisted nie inicjuje odnajdywania za pośrednictwem sieci.

  • /sync - Zatrzymaj wyniki aż do pełnego wyliczenia. Flaga /sync może zająć dużo czasu, zanim zwróci jakiekolwiek wyniki. Wiele protokołów nie obsługuje koncepcji pełnego wyliczania, dlatego te protokoły używają długich limitów czasu.

  • /instance — Instancje punktów końcowych do bezpośredniego odkrycia. Użyj przecinków, aby oddzielić wiele wartości identyfikatora wystąpienia. Flaga instance umożliwia określenie, co niektóre protokoły opisują jako kierowane odkrywanie.

  • /continuous - Kontynuuj wyliczanie do momentu naciśnięcia Ctrl+C.

  • /url — Zaktualizuj zdalny adres PNPX na potrzeby odnajdywania bezpośredniego.

  • /format - Format danych wyjściowych. Prawidłowe opcje to txt, xmllub csv.

  • /output-file - Plik wyjściowy.

/enum-services

Wylicza usługi punktu końcowego urządzeń za pośrednictwem różnych protokołów, które obsługuje system Windows. Usługa punktu końcowego jest kontraktem programowym na potrzeby funkcjonalności obsługiwanej przez punkt końcowy. Przykłady usług punktów końcowych: Bluetooth GATT, UPnP Digital Media Renderer (DMR) lub skanowanie ESCL.

  /enum-services [/protocol <protocol1>[,<protocol2>[,...]] [/persisted] [/sync]
                 [/instance <id1>[,<id2>[,...]] [/continuous] 
                 [/format <txt | xml | csv>] [/output-file <filename>]

Flagi:

  • /protocol - Protokoły do odnalezienia za pomocą. Użyj przecinków, aby oddzielić wiele wartości protokołu.

  • /sync - Zatrzymaj wyniki aż do pełnego wyliczenia. Flaga /sync może zająć dużo czasu, zanim zwróci jakiekolwiek wyniki. Wiele protokołów nie obsługuje w pełni zdefiniowanej koncepcji, dlatego te protokoły używają długich limitów czasu.

  • /instance — Ukierunkowane odnajdywanie określonych wystąpień usługi. Użyj przecinków, aby oddzielić wiele wartości identyfikatora wystąpienia.

  • /continuous - Kontynuuj wyliczanie do momentu naciśnięcia Ctrl+C.

  • /format - Format danych wyjściowych jako tekst, XML lub CSV. Prawidłowe opcje to txt, xmllub csv.

  • /output-file - Plik wyjściowy.

/enum-containers

Wylicza kontenery punktów końcowych urządzeń za pośrednictwem różnych protokołów, które obsługuje system Windows. Kontener punktu końcowego to kolekcja co najmniej jednego punktu końcowego za pośrednictwem jednego lub większej liczby protokołów, które koncepcyjnie reprezentują, co użytkownik końcowy może postrzegać jako rzeczywiste urządzenie fizyczne. Przykłady kontenerów punktów końcowych w sieci: konsola XBOX w twojej sieci, serwer NAS lub telewizor smart.

  /enum-containers [/protocol <protocol1>[,<protocol2>[,...]] [/persisted]
                   [/sync] [/instance <id1>[,<id2>[,...]] [/continuous] 
                   [/format <txt | xml | csv>] [/output-file <filename>]

Flagi:

  • /protocol - Protokoły do odnalezienia za pomocą. Użyj przecinków, aby oddzielić wiele wartości protokołu.

  • /sync - Zatrzymaj wyniki aż do pełnego wyliczenia. Flaga /sync może zająć dużo czasu, zanim zwróci jakiekolwiek wyniki. Wiele protokołów nie obsługuje w pełni wyliczonej koncepcji, dlatego korzystają z długich limitów czasu.

  • /instance - Kierowane wykrywanie określonych wystąpień kontenera.

  • /continuous - Kontynuuj wyliczanie do momentu naciśnięcia Ctrl+C.

  • /format - Format danych wyjściowych jako tekst, XML lub CSV. Prawidłowe opcje to txt, xmllub csv.

  • /output-file - Plik wyjściowy.

/enum-protocols

Wylicza protokoły obsługiwane w systemie operacyjnym, na którym działa to narzędzie.

/enum-protocols [/format <txt | xml | csv>] [/output-file <filename>]

Flagi:

  • /format - Format danych wyjściowych jako tekst, XML lub CSV. Prawidłowe opcje to txt, xmllub csv.

  • /output-file - Plik wyjściowy.

/associate

Łączy lub paruje punkt końcowy. To narzędzie implementuje większość obsługiwanych ceremonii parowania. Opcje ceremonii umożliwiają narzędziu kojarzenie punktów końcowych bez dodatkowych danych wejściowych użytkownika.

Ustawianie parowania

Nie wszystkie protokoły są świadome parowania zestawów.

Ten łańcuch narzędzi ustawia skojarzenia sekwencyjnie jako szczegóły implementacji. Chociaż większość protokołów nie nakłada tego ograniczenia.

Niektóre protokoły wymagają podania identyfikatorów składowych z góry przy użyciu opcji /set [<id2>[,<id3>[,...]]]].

Inne protokoły, takie jak Bluetooth, mogą odkrywać tylko inne identyfikatory po sfinalizowaniu ustalenia podstawowego punktu końcowego. Te inne odnalezione punkty końcowe zestawu są skojarzone sekwencyjnie.

Parowanie poszczególnych użytkowników

Nie wszystkie protokoły są świadome skojarzenia poszczególnych użytkowników. W przypadku protokołów, które to robią, tworzą tylko stan PnP widoczny dla użytkownika wykonującego parowanie.

  /associate <id1> [/set [<id2>[,<id3>[,...]]]] [/per-user [<sid>]]
                   [/protection <none | encryption | authentication>] 
                   [/just-works] [/pin-display] [/pin-entry pin] [/pin-match]

Flagi:

  • /set — Skojarz punkty końcowe jako zestaw z opcjonalnymi pomocniczymi identyfikatorami punktów końcowych rozdzielonymi przecinkami.

  • /per-user — Powiąż punkt końcowy wyłącznie z bieżącym użytkownikiem lub użytkownikiem na podstawie podanego identyfikatora SID.

  • /protection - Poziom ochrony połączenia parowania. Prawidłowe opcje to none, encryptioni authentication. Jeśli ta opcja zostanie pominięta, protokół używa domyślnego poziomu ochrony, który jest zazwyczaj najwyższym poziomem obsługiwanym przez urządzenie.

  • /just-works - Użyj just-works, push-button lub podobnej procedury.

  • /pin-display — Użyj funkcji pin-display lub podobnej procedury, która wyświetla dane PIN z urządzenia.

  • /pin-entry - Użyj funkcji wprowadzenia kodu PIN lub podobnego procesu.

  • /pin-match - Użyj dopasowywania PIN lub podobnej procedury.

/associate-oob

Asocjuje lub innymi słowy paruje punkt końcowy przy użyciu binarnego OOB bloba. To narzędzie implementuje większość obsługiwanych ceremonii parowania. Opcje ceremonii umożliwiają narzędziu kojarzenie punktów końcowych bez dodatkowych danych wejściowych użytkownika.

  /associate-oob <protocol> </blob <...>> | </file <...>>
                 [/just-works] [/pin-display] [/pin-entry pin] [/pin-match]

Flagi:

  • /blob — Dane blob jako ciąg znaków.

  • /file — Plik zawierający dane obiektu blob.

  • /just-works - Użyj łatwych w obsłudze, jednym naciśnięciem przycisku itp. ceremonii.

  • /pin-display — Użyj funkcji pin-display lub podobnej procedury, która wyświetla dane PIN z urządzenia.

  • /pin-entry - Użyj funkcji wprowadzenia kodu PIN lub podobnego procesu.

  • /pin-match - Użyj dopasowywania PIN lub podobnej procedury.

/disassociate

Usuwa skojarzenia lub rozłącza punkt końcowy.

/disassociate <id>

/challenge

Zleć systemowi operacyjnemu sprawdzenie, czy skojarzony punkt końcowy jest obecny.

/challenge <id>
  • Last updated on