az network watcher packet-capture

  • Ссылка

Управление сеансами записи пакетов на виртуальных машинах.

Эти команды требуют включения Наблюдатель за сетями Azure для региона виртуальных машин и включения AzureNetworkWatcherExtension на виртуальной машине. Дополнительные сведения см. в статье https://learn.microsoft.com/en-us/azure/network-watcher/network-watcher-packet-capture-manage-cli.

Команды

Имя Описание Тип Состояние
az network watcher packet-capture create

Создайте и запустите сеанс записи пакетов.

 Основные сведения Общедоступная версия
az network watcher packet-capture delete

Удаление сеанса записи пакетов.

 Основные сведения Общедоступная версия
az network watcher packet-capture list

Вывод списка всех сеансов записи пакетов в регионе.

 Основные сведения Общедоступная версия
az network watcher packet-capture show

Отображение сведений о сеансе записи пакетов.

 Основные сведения Общедоступная версия
az network watcher packet-capture show-status

Отображение состояния сеанса записи пакетов.

 Основные сведения Общедоступная версия
az network watcher packet-capture stop

Остановите сеанс записи пакетов.

 Основные сведения Общедоступная версия
az network watcher packet-capture wait

Поместите интерфейс командной строки в состояние ожидания, пока не будет выполнено условие.

 Основные сведения Общедоступная версия

az network watcher packet-capture create

Изменить

Создайте и запустите сеанс записи пакетов.

az network watcher packet-capture create --name
                                         --resource-group
                                         [--capture-limit]
                                         [--capture-size]
                                         [--exclude]
                                         [--file-path]
                                         [--filters]
                                         [--include]
                                         [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                         [--storage-account]
                                         [--storage-path]
                                         [--target]
                                         [--target-type {AzureVM, AzureVMSS}]
                                         [--time-limit]
                                         [--vm]

Примеры

Создайте сеанс записи пакетов на виртуальной машине.

az network watcher packet-capture create -g MyResourceGroup -n MyPacketCaptureName --vm MyVm --storage-account MyStorageAccount

Создайте сеанс записи пакетов на виртуальной машине с необязательными фильтрами для протоколов, локальных IP-адресов и диапазонов удаленных IP-адресов и портов.

az network watcher packet-capture create -g MyResourceGroup -n MyPacketCaptureName --vm MyVm --storage-account MyStorageAccount --filters '[{"protocol":"TCP", "remoteIPAddress":"1.1.1.1-255.255.255", "localIPAddress":"10.0.0.3", "remotePort":"20"}, {"protocol":"TCP", "remoteIPAddress":"1.1.1.1-255.255.255", "localIPAddress":"10.0.0.3", "remotePort":"80"}, {"protocol":"TCP", "remoteIPAddress":"1.1.1.1-255.255.255", "localIPAddress":"10.0.0.3", "remotePort":"443"}, {"protocol":"UDP"}]'

Создайте сеанс записи пакетов в VMSS.

az network watcher packet-capture create -g MyResourceGroup -n MyPacketCaptureName --vm MyVmVMSS --storage-account MyStorageAccount --target-type "AzureVMSS"

Создайте сеанс записи пакетов на vmSS с включением определенных экземпляров.

az network watcher packet-capture create -g MyResourceGroup -n MyPacketCaptureName --target MyVmVMSS --storage-account MyStorageAccount --target-type "AzureVMSS" --include "0" "1"

Создайте сеанс записи пакетов на vmSS с исключением конкретных экземпляров.

az network watcher packet-capture create -g MyResourceGroup -n MyPacketCaptureName --vm MyVmVMSS --storage-account MyStorageAccount --target-type "AzureVMSS" --exclude "0" "1"

Обязательные параметры

--name -n

Имя сеанса записи пакетов.

--resource-group -g

Имя группы ресурсов, в который находится целевой ресурс.

Необязательные параметры

--capture-limit

Максимальный размер выходных данных записи в байтах.

значение по умолчанию: 1073741824
--capture-size

Количество байтов, захваченных для каждого пакета. Превышение байтов усечено.

значение по умолчанию: 0
--exclude

Разделенный пробелами список экземпляров VMSS для исключения в записи пакетов. Поддержка сокращенного синтаксиса, json-file и yaml-file. Попробуйте "??", чтобы показать больше.

--file-path

Локальный путь на целевой виртуальной машине, на которой сохраняется запись пакетов. Для виртуальных машин Linux путь должен начинаться с /var/captures.

--filters

Список фильтров пакетов в кодировке JSON. Используется @{path} для загрузки из файла. Поддержка сокращенного синтаксиса, json-file и yaml-file. Попробуйте "??", чтобы показать больше.

--include

Разделенный пробелами список экземпляров VMSS для включения в запись пакетов, например 0 1 2. Поддержка сокращенного синтаксиса, json-file и yaml-file. Попробуйте "??", чтобы показать больше.

--no-wait

Не ожидать завершения длительной операции.

допустимые значения: 0, 1, f, false, n, no, t, true, y, yes
--storage-account

Имя или идентификатор учетной записи хранения для сохранения записи пакетов.

--storage-path

Полный универсальный код ресурса (URI) существующего контейнера хранилища, в котором хранится файл записи. Если он не указан, контейнер network-watcher-logs будет создан, если он не существует, и файл записи будет сохранен там.

--target

Имя или идентификатор целевого ресурса. Если --target-type это AzureVMSS, обязательно --target .

--target-type

Тип ресурса целевого объекта.

допустимые значения: AzureVM, AzureVMSS
значение по умолчанию: AzureVM
--time-limit

Максимальная длительность сеанса записи в секундах.

значение по умолчанию: 18000
--vm

Имя или идентификатор виртуальной машины для целевого объекта.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az network watcher packet-capture delete

Изменить

Удаление сеанса записи пакетов.

az network watcher packet-capture delete --location
                                         --name
                                         [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]

Примеры

Удаление сеанса записи пакетов. Это удаляет только сеанс, а не файл записи.

az network watcher packet-capture delete -n packetCaptureName -l westcentralus

Обязательные параметры

--location -l

Location. Значения из az account list-locations. Расположение по умолчанию можно настроить с помощью az configure --defaults location=<location>.

--name -n

Имя сеанса записи пакетов.

Необязательные параметры

--no-wait

Не ожидать завершения длительной операции.

допустимые значения: 0, 1, f, false, n, no, t, true, y, yes
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az network watcher packet-capture list

Изменить

Вывод списка всех сеансов записи пакетов в регионе.

az network watcher packet-capture list --location

Примеры

Вывод списка всех сеансов записи пакетов в регионе.

az az network watcher packet-capture list -l westus

Обязательные параметры

--location -l

Location. Значения из az account list-locations. Расположение по умолчанию можно настроить с помощью az configure --defaults location=<location>.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az network watcher packet-capture show

Изменить

Отображение сведений о сеансе записи пакетов.

az network watcher packet-capture show --location
                                       --name

Примеры

Отображение сеанса записи пакетов.

az network watcher packet-capture show -l westus -n MyPacketCapture

Обязательные параметры

--location -l

Location. Значения из az account list-locations. Расположение по умолчанию можно настроить с помощью az configure --defaults location=<location>.

--name -n

Имя сеанса записи пакетов.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az network watcher packet-capture show-status

Изменить

Отображение состояния сеанса записи пакетов.

az network watcher packet-capture show-status --location
                                              --name
                                              [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]

Примеры

Отображение состояния сеанса записи пакетов.

az network watcher packet-capture show-status -l westus -n MyPacketCapture

Обязательные параметры

--location -l

Location. Значения из az account list-locations. Расположение по умолчанию можно настроить с помощью az configure --defaults location=<location>.

--name -n

Имя, заданное сеансу записи пакетов.

Необязательные параметры

--no-wait

Не ожидать завершения длительной операции.

допустимые значения: 0, 1, f, false, n, no, t, true, y, yes
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az network watcher packet-capture stop

Изменить

Остановите сеанс записи пакетов.

az network watcher packet-capture stop --location
                                       --name
                                       [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]

Примеры

Остановите сеанс записи пакетов.

az network watcher packet-capture stop -l westus -n MyPacketCapture

Обязательные параметры

--location -l

Location. Значения из az account list-locations. Расположение по умолчанию можно настроить с помощью az configure --defaults location=<location>.

--name -n

Имя сеанса записи пакетов.

Необязательные параметры

--no-wait

Не ожидать завершения длительной операции.

допустимые значения: 0, 1, f, false, n, no, t, true, y, yes
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az network watcher packet-capture wait

Изменить

Поместите интерфейс командной строки в состояние ожидания, пока не будет выполнено условие.

az network watcher packet-capture wait [--created]
                                       [--custom]
                                       [--deleted]
                                       [--exists]
                                       [--ids]
                                       [--interval]
                                       [--name]
                                       [--subscription]
                                       [--timeout]
                                       [--updated]
                                       [--watcher-name]
                                       [--watcher-rg]

Необязательные параметры

--created

Подождите, пока не будет создано с помощью provisioningState по адресу "Успешно".

значение по умолчанию: False
--custom

Подождите, пока условие не будет удовлетворено пользовательским запросом JMESPath. Например, provisioningState!='InProgress', instanceView.statuses[?code='PowerState/running'].

--deleted

Дождитесь удаления.

значение по умолчанию: False
--exists

Подождите, пока ресурс не существует.

значение по умолчанию: False
--ids

Один или несколько идентификаторов ресурсов (через пробелы). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие аргументы Resource Id.

--interval

Интервал опроса в секундах.

значение по умолчанию: 30
--name -n

Имя сеанса записи пакетов.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--timeout

Максимальное ожидание в секундах.

значение по умолчанию: 3600
--updated

Подождите, пока не будет обновлено с помощью provisioningState по адресу "Успешно".

значение по умолчанию: False
--watcher-name

Имя наблюдателя за сетями.

--watcher-rg

Имя группы ресурсов, в который входит наблюдатель.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.