New-AzNetworkWatcherPacketCaptureV2
V2 Versi Packet Capture Cmdlet yang membuat sumber daya pengambilan paket baru dan memulai sesi pengambilan paket pada VM, VMSS, atau beberapa instans VMSS.
Sintaks
SetByResource (Default)
New-AzNetworkWatcherPacketCaptureV2
-NetworkWatcher <PSNetworkWatcher>
-Name <String>
-TargetId <String>
[-StorageAccountId <String>]
[-StoragePath <String>]
[-LocalFilePath <String>]
[-BytesToCapturePerPacket <Int32>]
[-TotalBytesPerSession <UInt32>]
[-TimeLimitInSecond <Int32>]
[-Scope <PSPacketCaptureMachineScope>]
[-TargetType <String>]
[-Filter <PSPacketCaptureFilter[]>]
[-ContinuousCapture <Boolean>]
[-LocalPath <String>]
[-CaptureSetting <PSPacketCaptureSettings>]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
SetByName
New-AzNetworkWatcherPacketCaptureV2
-NetworkWatcherName <String>
-ResourceGroupName <String>
-Name <String>
-TargetId <String>
[-StorageAccountId <String>]
[-StoragePath <String>]
[-LocalFilePath <String>]
[-BytesToCapturePerPacket <Int32>]
[-TotalBytesPerSession <UInt32>]
[-TimeLimitInSecond <Int32>]
[-Scope <PSPacketCaptureMachineScope>]
[-TargetType <String>]
[-Filter <PSPacketCaptureFilter[]>]
[-ContinuousCapture <Boolean>]
[-LocalPath <String>]
[-CaptureSetting <PSPacketCaptureSettings>]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
SetByLocation
New-AzNetworkWatcherPacketCaptureV2
-Location <String>
-Name <String>
-TargetId <String>
[-StorageAccountId <String>]
[-StoragePath <String>]
[-LocalFilePath <String>]
[-BytesToCapturePerPacket <Int32>]
[-TotalBytesPerSession <UInt32>]
[-TimeLimitInSecond <Int32>]
[-Scope <PSPacketCaptureMachineScope>]
[-TargetType <String>]
[-Filter <PSPacketCaptureFilter[]>]
[-ContinuousCapture <Boolean>]
[-LocalPath <String>]
[-CaptureSetting <PSPacketCaptureSettings>]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Deskripsi
cmdlet New-AzNetworkWatcherPacketCaptureV2 membuat sumber daya pengambilan paket baru dan memulai sesi pengambilan paket pada VM, VMSS, atau beberapa instans VMSS.
Panjang sesi Pengambilan Paket dapat dikonfigurasi melalui batasan waktu atau batasan ukuran. Jumlah data yang diambil untuk setiap paket juga dapat dikonfigurasi.
Filter dapat diterapkan ke sesi pengambilan paket tertentu, memungkinkan Anda menyesuaikan jenis paket yang diambil. Filter dapat membatasi paket pada alamat IP & rentang alamat lokal dan jarak jauh, port lokal dan jarak jauh & rentang port, dan protokol tingkat sesi yang akan diambil. Filter dapat dikomposisikan, dan beberapa filter dapat diterapkan untuk memberi Anda granularitas pengambilan.
Contoh
Contoh 1: Membuat Pengambilan Paket pada VM
$nw = Get-AzResource | Where {$_.ResourceType -eq "Microsoft.Network/networkWatchers" -and $_.Location -eq "WestCentralUS" }
$networkWatcher = Get-AzNetworkWatcher -Name $nw.Name -ResourceGroupName $nw.ResourceGroupName
$storageAccount = Get-AzStorageAccount -ResourceGroupName contosoResourceGroup -Name contosostorage123
$filter1 = New-AzPacketCaptureFilterConfig -Protocol TCP -RemoteIPAddress "1.1.1.1-255.255.255" -LocalIPAddress "10.0.0.3" -LocalPort "1-65535" -RemotePort "20;80;443"
$filter2 = New-AzPacketCaptureFilterConfig -Protocol UDP
New-AzNetworkWatcherPacketCaptureV2 -NetworkWatcher $networkWatcher -TargetId $vm.Id -TargetType "azurevm" -Name "PacketCaptureTest" -StorageAccountId $storageAccount.id -TimeLimitInSecond 60 -Filter $filter1, $filter2
Name : PacketCaptureTest
Id : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/NetworkWatcherRG/providers/Microsoft.Network/networkWatchers/NetworkWatcher_eastus/packetCaptures/PacketCaptureTest
Etag : W/"0b3c52cb-aa63-4647-93d3-3221c13ccdd2"
ProvisioningState : Succeeded
Target : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosoResourceGroup/providers/Microsoft.Compute/virtualMachines/SampleVM
TargetType : AzureVM
BytesToCapturePerPacket : 0
TotalBytesPerSession : 1073741824
TimeLimitInSeconds : 18000
StorageLocation : {
"StorageId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosoResourceGroup/providers/Microsoft.Storage/storageAccounts/contosostorage123",
"StoragePath": "https://contosostorage123.blob.core.windows.net/network-watcher-logs/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/contosoResourceGroup/providers/microsoft.compute/virtualmachines/SampleVM/2022/07/21/packetcapture_09_20_07_166.cap"
}
Filters : [
{
"Protocol": "TCP",
"RemoteIPAddress": "1.1.1.1-255.255.255",
"LocalIPAddress": "10.0.0.3",
"LocalPort": "1-65535",
"RemotePort": "20;80;443"
},
{
"Protocol": "UDP",
"RemoteIPAddress": "",
"LocalIPAddress": "",
"LocalPort": "",
"RemotePort": ""
}
]
Scope : {
"Include": [],
"Exclude": []
}
Dalam contoh ini kita membuat tangkapan paket bernama "PacketCaptureTest" dengan beberapa filter dan batas waktu. Setelah sesi selesai, sesi akan disimpan ke akun penyimpanan yang ditentukan.
Catatan: Ekstensi Azure Network Watcher harus diinstal pada komputer virtual target untuk membuat pengambilan paket.
Contoh 2: Membuat Pengambilan Paket pada VMSS
$nw = Get-AzResource | Where {$_.ResourceType -eq "Microsoft.Network/networkWatchers" -and $_.Location -eq "WestCentralUS" }
$networkWatcher = Get-AzNetworkWatcher -Name $nw.Name -ResourceGroupName $nw.ResourceGroupName
$storageAccount = Get-AzStorageAccount -ResourceGroupName contosoResourceGroup -Name contosostorage123
$filter1 = New-AzPacketCaptureFilterConfig -Protocol TCP -RemoteIPAddress "1.1.1.1-255.255.255" -LocalIPAddress "10.0.0.3" -LocalPort "1-65535" -RemotePort "20;80;443"
$filter2 = New-AzPacketCaptureFilterConfig -Protocol UDP
New-AzNetworkWatcherPacketCaptureV2 -NetworkWatcher $networkWatcher -TargetId $vmss.Id -TargetType "azurevmss" -Name "PacketCaptureTest" -StorageAccountId $storageAccount.id -TimeLimitInSecond 60 -Filter $filter1, $filter2
Name : PacketCaptureTest
Id : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/NetworkWatcherRG/providers/Microsoft.Network/networkWatchers/NetworkWatcher_eastus/packetCaptures/PacketCaptureTest
Etag : W/"0b3c52cb-aa63-4647-93d3-3221c13ccdd2"
ProvisioningState : Succeeded
Target : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosoResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/SampleVMSS
TargetType : AzureVMSS
BytesToCapturePerPacket : 0
TotalBytesPerSession : 1073741824
TimeLimitInSeconds : 60
StorageLocation : {
"StorageId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosoResourceGroup/providers/Microsoft.Storage/storageAccounts/contosostorage123",
"StoragePath": "https://contosostorage123.blob.core.windows.net/network-watcher-logs/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/contosoResourceGroup/providers/microsoft.compute/virtualmachinescalesets/SampleVMSS/2022/07/21/packetcapture_09_20_07_166.cap"
}
Filters : [
{
"Protocol": "TCP",
"RemoteIPAddress": "1.1.1.1-255.255.255",
"LocalIPAddress": "10.0.0.3",
"LocalPort": "1-65535",
"RemotePort": "20;80;443"
},
{
"Protocol": "UDP",
"RemoteIPAddress": "",
"LocalIPAddress": "",
"LocalPort": "",
"RemotePort": ""
}
]
Scope : {
"Include": [],
"Exclude": []
}
Dalam contoh ini kita membuat tangkapan paket bernama "PacketCaptureTest" dengan beberapa filter dan batas waktu. Setelah sesi selesai, sesi akan disimpan ke akun penyimpanan yang ditentukan.
Catatan: Ekstensi Azure Network Watcher harus diinstal pada set skala komputer virtual target dan semua instans masing-masing yang mematuhi model vmss terbaru, untuk membuat tangkapan paket.
Contoh 3: Membuat Pengambilan Paket pada beberapa Instans VMSS
$nw = Get-AzResource | Where {$_.ResourceType -eq "Microsoft.Network/networkWatchers" -and $_.Location -eq "WestCentralUS" }
$networkWatcher = Get-AzNetworkWatcher -Name $nw.Name -ResourceGroupName $nw.ResourceGroupName
$storageAccount = Get-AzStorageAccount -ResourceGroupName contosoResourceGroup -Name contosostorage123
$filter1 = New-AzPacketCaptureFilterConfig -Protocol TCP -RemoteIPAddress "1.1.1.1-255.255.255" -LocalIPAddress "10.0.0.3" -LocalPort "1-65535" -RemotePort "20;80;443"
$filter2 = New-AzPacketCaptureFilterConfig -Protocol UDP
$instance1 = $vmssInstance1.Name
$instance2 = $vmssInstance2.Name
$scope = New-AzPacketCaptureScopeConfig -Include $instance1, $instance2
New-AzNetworkWatcherPacketCaptureV2 -NetworkWatcher $networkWatcher -TargetId $vmss.Id -TargetType "azurevmss" -Scope $scope -Name "PacketCaptureTest" -StorageAccountId $storageAccount.id -TimeLimitInSecond 60 -Filter $filter1, $filter2
Name : PacketCaptureTest
Id : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/NetworkWatcherRG/providers/Microsoft.Network/networkWatchers/NetworkWatcher_eastus/packetCaptures/PacketCaptureTest
Etag : W/"0b3c52cb-aa63-4647-93d3-3221c13ccdd2"
ProvisioningState : Succeeded
Target : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosoResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/SampleVMSS
TargetType : AzureVMSS
BytesToCapturePerPacket : 0
TotalBytesPerSession : 1073741824
TimeLimitInSeconds : 18000
StorageLocation : {
"StorageId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosoResourceGroup/providers/Microsoft.Storage/storageAccounts/contosostorage123",
"StoragePath": "https://contosostorage123.blob.core.windows.net/network-watcher-logs/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/contosoResourceGroup/providers/microsoft.compute/virtualmachinescalesets/SampleVMSS/2022/07/21/packetcapture_09_20_07_166.cap"
}
Filters : [
{
"Protocol": "TCP",
"RemoteIPAddress": "1.1.1.1-255.255.255",
"LocalIPAddress": "10.0.0.3",
"LocalPort": "1-65535",
"RemotePort": "20;80;443"
},
{
"Protocol": "UDP",
"RemoteIPAddress": "",
"LocalIPAddress": "",
"LocalPort": "",
"RemotePort": ""
}
]
Scope : {
"Include": [
"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosoResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/SampleVMSS/virtualMachines/0",
"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosoResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/SampleVMSS/virtualMachines/1"
],
"Exclude": []
}
Dalam contoh ini kita membuat tangkapan paket bernama "PacketCaptureTest" dengan beberapa filter dan batas waktu. Setelah sesi selesai, sesi akan disimpan ke akun penyimpanan yang ditentukan.
Catatan: Ekstensi Azure Network Watcher harus diinstal pada set skala komputer virtual target dan pada instans masing-masing termasuk cakupan yang mematuhi model vmss terbaru, untuk membuat tangkapan paket.
Contoh 4: Membuat Pengambilan Paket pada VMSS dengan pengambilan berkelanjutan dan pengaturannya
$nw = Get-AzResource | Where {$_.ResourceType -eq "Microsoft.Network/networkWatchers" -and $_.Location -eq "WestCentralUS" }
$networkWatcher = Get-AzNetworkWatcher -Name $nw.Name -ResourceGroupName $nw.ResourceGroupName
$capSettings = New-AzPacketCaptureSettingsConfig -FileCount 2 -FileSizeInBytes 102400 -SessionTimeLimitInSeconds 60
New-AzNetworkWatcherPacketCaptureV2 -NetworkWatcher $networkWatcher -Name "PacketCaptureTest" -TargetId "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosoResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/SampleVMSS" -BytesToCapturePerPacket 1 -ContinuousCapture $false -CaptureSetting $capSettings -LocalPath "/var/captures/test1.cap"
Name : PacketCaptureTest
Id : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/NetworkWatcherRG/providers/Microsoft.Network/networkWatchers/NetworkWatcher_eastus/packetCaptures/PacketCaptureTest
Etag : W/"00000000-0000-0000-0000-000000000000"
ProvisioningState : Succeeded
Target : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosoResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/SampleVMSS
TargetType : AzureVMSS
BytesToCapturePerPacket : 1
StorageLocation : {
"StoragePath": "",
"LocalPath": "/var/captures/test1.cap"
}
ContinuousCapture : true
CaptureSettings : {
"fileCount":"2",
"fileSizeInBytes":"102400",
"sessionTimeLimitInSeconds":"60"
}
Filters : []
Scope : {}
Dalam contoh ini kita membuat tangkapan paket bernama "PacketCaptureTest" dengan penangkapan berkelanjutan sebagai true bersama dengan pengaturan pengambilan. Setelah sesi selesai, sesi akan disimpan ke akun penyimpanan yang ditentukan.
Catatan: Ekstensi Azure Network Watcher harus diinstal pada set skala komputer virtual target dan semua instans masing-masing yang mematuhi model vmss terbaru, untuk membuat tangkapan paket.
Parameter
-AsJob
Jalankan cmdlet di latar belakang
Properti parameter
Jenis: SwitchParameter
Nilai default: None
Mendukung wildcard: False
DontShow: False
Kumpulan parameter
(All)
Position: Named
Wajib: False
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
-BytesToCapturePerPacket
Byte untuk menangkap per paket.
Properti parameter
Jenis: Nullable<T> [ Int32 ]
Nilai default: None
Mendukung wildcard: False
DontShow: False
Kumpulan parameter
(All)
Position: Named
Wajib: False
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: True
Nilai dari argumen yang tersisa: False
-CaptureSetting
Pengaturan pengambilan menyimpan nilai 'FileCount', 'FileSizeInBytes', 'SessionTimeLimitInSeconds'. Pengaturan ini hanya berlaku, jika 'ContinuousCapture' disediakan.
Properti parameter
Kumpulan parameter
(All)
Position: Named
Wajib: False
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
-Confirm
Meminta konfirmasi sebelum menjalankan cmdlet.
Properti parameter
Jenis: SwitchParameter
Nilai default: None
Mendukung wildcard: False
DontShow: False
Alias: Cf
Kumpulan parameter
(All)
Position: Named
Wajib: False
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
-ContinuousCapture
Tangkapan berkelanjutan ini adalah boolean nullable, yang dapat menampung nilai 'null', 'true' atau 'false'. Jika kita tidak meneruskan parameter ini, maka akan dianggap sebagai 'null', nilai defaultnya adalah 'null'.
Properti parameter
Kumpulan parameter
(All)
Position: Named
Wajib: False
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: True
Nilai dari argumen yang tersisa: False
-DefaultProfile
Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan Azure.
Properti parameter
Jenis: IAzureContextContainer
Nilai default: None
Mendukung wildcard: False
DontShow: False
Alias: AzContext, AzureRmContext, AzureCredential
Kumpulan parameter
(All)
Position: Named
Wajib: False
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
-Filter
Filter untuk sesi pengambilan paket.
Properti parameter
Kumpulan parameter
(All)
Position: Named
Wajib: False
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
-LocalFilePath
Jalur file lokal.
Properti parameter
Jenis: String
Nilai default: None
Mendukung wildcard: False
DontShow: False
Kumpulan parameter
(All)
Position: Named
Wajib: False
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: True
Nilai dari argumen yang tersisa: False
-LocalPath
Jalur ini valid jika 'ContinuousCapture' disediakan dan diperlukan jika tidak ada ID penyimpanan yang disediakan, jika tidak opsional. Harus menyertakan nama file pengambilan (*.cap).
Properti parameter
Jenis: String
Nilai default: None
Mendukung wildcard: False
DontShow: False
Kumpulan parameter
(All)
Position: Named
Wajib: False
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: True
Nilai dari argumen yang tersisa: False
-Location
Lokasi pengamat jaringan.
Properti parameter
Jenis: String
Nilai default: None
Mendukung wildcard: False
DontShow: False
Kumpulan parameter
SetByLocation
Position: Named
Wajib: True
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
-Name
Nama pengambilan paket.
Properti parameter
Jenis: String
Nilai default: None
Mendukung wildcard: False
DontShow: False
Alias: PacketCaptureName
Kumpulan parameter
(All)
Position: Named
Wajib: True
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: True
Nilai dari argumen yang tersisa: False
-NetworkWatcher
Sumber daya pengamat jaringan.
Properti parameter
Jenis: PSNetworkWatcher
Nilai default: None
Mendukung wildcard: False
DontShow: False
Kumpulan parameter
SetByResource
Position: Named
Wajib: True
Nilai dari alur: True
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
-NetworkWatcherName
Nama pengamat jaringan.
Properti parameter
Jenis: String
Nilai default: None
Mendukung wildcard: False
DontShow: False
Kumpulan parameter
SetByName
Position: Named
Wajib: True
Nilai dari alur: True
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
-ResourceGroupName
Nama grup sumber daya pengamat jaringan.
Properti parameter
Jenis: String
Nilai default: None
Mendukung wildcard: False
DontShow: False
Kumpulan parameter
SetByName
Position: Named
Wajib: True
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: True
Nilai dari argumen yang tersisa: False
-Scope
Cakupan Instans VMSS yang akan Disertakan atau Dikecualikan.
Properti parameter
Kumpulan parameter
(All)
Position: Named
Wajib: False
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
-StorageAccountId
Id akun penyimpanan.
Properti parameter
Jenis: String
Nilai default: None
Mendukung wildcard: False
DontShow: False
Kumpulan parameter
(All)
Position: Named
Wajib: False
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: True
Nilai dari argumen yang tersisa: False
-StoragePath
Jalur penyimpanan.
Properti parameter
Jenis: String
Nilai default: None
Mendukung wildcard: False
DontShow: False
Kumpulan parameter
(All)
Position: Named
Wajib: False
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: True
Nilai dari argumen yang tersisa: False
-TargetId
ID komputer virtual target atau ID set skala komputer virtual
Properti parameter
Jenis: String
Nilai default: None
Mendukung wildcard: False
DontShow: False
Kumpulan parameter
(All)
Position: Named
Wajib: True
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: True
Nilai dari argumen yang tersisa: False
-TargetType
Jenis Target Sumber Daya.
Properti parameter
Jenis: String
Nilai default: None
Mendukung wildcard: False
DontShow: False
Kumpulan parameter
(All)
Position: Named
Wajib: False
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
-TimeLimitInSecond
Batas waktu dalam detik.
Properti parameter
Jenis: Nullable<T> [ Int32 ]
Nilai default: None
Mendukung wildcard: False
DontShow: False
Kumpulan parameter
(All)
Position: Named
Wajib: False
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: True
Nilai dari argumen yang tersisa: False
-TotalBytesPerSession
Total byte per sesi.
Properti parameter
Kumpulan parameter
(All)
Position: Named
Wajib: False
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: True
Nilai dari argumen yang tersisa: False
-WhatIf
Menunjukkan apa yang akan terjadi ketika cmdlet dijalankan.
Cmdlet tidak dijalankan.
Properti parameter
Jenis: SwitchParameter
Nilai default: None
Mendukung wildcard: False
DontShow: False
Alias: wi
Kumpulan parameter
(All)
Position: Named
Wajib: False
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
CommonParameters
Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters .
Output