Freigeben über


Microsoft.Network networkWatchers/packetCaptures 2024-03-01

Bicep-Ressourcendefinition

Der Ressourcentyp "networkWatchers/packetCaptures" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.Network/networkWatchers/packetCaptures-Ressource zu erstellen, fügen Sie Der Vorlage den folgenden Bicep hinzu.

resource symbolicname 'Microsoft.Network/networkWatchers/packetCaptures@2024-03-01' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    bytesToCapturePerPacket: int
    captureSettings: {
      fileCount: int
      fileSizeInBytes: int
      sessionTimeLimitInSeconds: int
    }
    continuousCapture: bool
    filters: [
      {
        localIPAddress: 'string'
        localPort: 'string'
        protocol: 'string'
        remoteIPAddress: 'string'
        remotePort: 'string'
      }
    ]
    scope: {
      exclude: [
        'string'
      ]
      include: [
        'string'
      ]
    }
    storageLocation: {
      filePath: 'string'
      localPath: 'string'
      storageId: 'string'
      storagePath: 'string'
    }
    target: 'string'
    targetType: 'string'
    timeLimitInSeconds: int
    totalBytesPerSession: int
  }
}

Eigenschaftswerte

Microsoft.Network/networkWatchers/packetCaptures

Name Beschreibung Wert
Name Der Ressourcenname Zeichenfolge (erforderlich)
Elternteil In Bicep können Sie die übergeordnete Ressource für eine untergeordnete Ressource angeben. Sie müssen diese Eigenschaft nur hinzufügen, wenn die untergeordnete Ressource außerhalb der übergeordneten Ressource deklariert wird.

Weitere Informationen finden Sie unter Untergeordnete Ressource außerhalb der übergeordneten Ressource.
Symbolischer Name für Ressource vom Typ: networkWatchers
Eigenschaften Eigenschaften der Paketerfassung. PacketCaptureParametersOrPacketCaptureResultProperties (erforderlich)

PacketCaptureFilter

Name Beschreibung Wert
localIPAddress Lokale IP-Adresse, nach der gefiltert werden soll. Notation: "127.0.0.1" für die Eingabe einer einzelnen Adresse. "127.0.0.1-127.0.0.255" für den Bereich. "127.0.0.1; 127.0.0.5"? für mehrere Einträge. Mehrere Bereiche werden derzeit nicht unterstützt. Das Mischen von Bereichen mit mehreren Einträgen wird derzeit nicht unterstützt. Default = null. Schnur
localPort Lokaler Port, nach dem gefiltert werden soll. Notation: "80" für single port entry." 80-85 Zoll für Bereich. "80; 443;" für mehrere Einträge. Mehrere Bereiche werden derzeit nicht unterstützt. Das Mischen von Bereichen mit mehreren Einträgen wird derzeit nicht unterstützt. Default = null. Schnur
Protokoll Protokoll, nach dem gefiltert werden soll. "Beliebig"
"TCP"
"UDP"
remoteIPAddress Lokale IP-Adresse, nach der gefiltert werden soll. Notation: "127.0.0.1" für die Eingabe einer einzelnen Adresse. "127.0.0.1-127.0.0.255" für den Bereich. "127.0.0.1; 127.0.0.5;" für mehrere Einträge. Mehrere Bereiche werden derzeit nicht unterstützt. Das Mischen von Bereichen mit mehreren Einträgen wird derzeit nicht unterstützt. Default = null. Schnur
remotePort Remoteport, nach dem gefiltert werden soll. Notation: "80" für single port entry." 80-85 Zoll für Bereich. "80; 443;" für mehrere Einträge. Mehrere Bereiche werden derzeit nicht unterstützt. Das Mischen von Bereichen mit mehreren Einträgen wird derzeit nicht unterstützt. Default = null. Schnur

PacketCaptureMachineScope

Name Beschreibung Wert
ausschließen Liste der AzureVMSS-Instanzen, die von der Ausführung der Paketerfassung von AzureVMSS ausgeschlossen werden müssen. string[]
einschließen Liste der AzureVMSS-Instanzen zum Ausführen der Paketerfassung. string[]

PacketCaptureParametersOrPacketCaptureResultProperties

Name Beschreibung Wert
bytesToCapturePerPacket Die Anzahl der pro Paket erfassten Bytes, die verbleibenden Bytes werden abgeschnitten. Int

Zwänge:
Min.-Wert = 0
Max. Wert = 4294967295
captureSettings Die Aufnahmeeinstellung enthält die Werte "FileCount", "FileSizeInBytes", "SessionTimeLimitInSeconds". PacketCaptureSettings-
continuousCapture Diese fortlaufende Erfassung ist ein boolescher Nullwert, der den Wert "null", "true" oder "false" enthalten kann. Wenn dieser Parameter nicht übergeben wird, wird er als "null" betrachtet, der Standardwert ist "null". Bool
Filter Eine Liste der Paketerfassungsfilter. PacketCaptureFilter-[]
Umfang Eine Liste der AzureVMSS-Instanzen, die eingeschlossen oder ausgeschlossen werden können, um die Paketerfassung auszuführen. Wenn sowohl eingeschlossen als auch ausgeschlossen leer sind, wird die Paketerfassung auf allen Instanzen von AzureVMSS ausgeführt. PacketCaptureMachineScope-
storageLocation Der Speicherort für eine Paketerfassungssitzung. PacketCaptureStorageLocation- (erforderlich)
Ziel Die ID der zielbezogenen Ressource, nur AzureVM und AzureVMSS als Zieltyp werden derzeit unterstützt. Zeichenfolge (erforderlich)
targetType Zieltyp der bereitgestellten Ressource. "AzureVM"
"AzureVMSS"
timeLimitInSeconds Maximale Dauer der Aufnahmesitzung in Sekunden. Int

Zwänge:
Min.-Wert = 0
Maximalwert = 18000
totalBytesPerSession Maximale Größe der Aufnahmeausgabe. Int

Zwänge:
Min.-Wert = 0
Max. Wert = 4294967295

PacketCaptureSettings

Name Beschreibung Wert
fileCount Anzahl der Dateien. Der Standardwert der Anzahl ist 10 und die maximale Zahl ist 10000. Int

Zwänge:
Min.-Wert = 0
Max. Wert = 10000
fileSizeInBytes Anzahl der pro Paket erfassten Bytes. Standardwert in Byte 104857600 (100 MB) und maximal in Byte 4294967295 (4 GB). Int

Zwänge:
Min.-Wert = 0
Max. Wert = 4294967295
sessionTimeLimitInSeconds Die maximale Dauer der Aufnahmesitzung in Sekunden beträgt 604800s (7 Tage) für eine Datei. Standardwert in den zweiten 86400er Jahren (1 Tag). Int

Zwänge:
Min.-Wert = 0
Maximalwert = 604800

PacketCaptureStorageLocation

Name Beschreibung Wert
filePath Dieser Pfad ist ungültig, wenn 'Continuous Capture' mit 'true' oder 'false' bereitgestellt wird. Ein gültiger lokaler Pfad auf der Ziel-VM. Muss den Namen der Aufnahmedatei (*.cap) enthalten. Für den virtuellen Linux-Computer muss er mit /var/captures beginnen. Erforderlich, wenn keine Speicher-ID angegeben wird, andernfalls optional. Schnur
localPath Dieser Pfad ist gültig, wenn "Fortlaufende Erfassung" mit "true" oder "false" bereitgestellt wird und erforderlich ist, wenn keine Speicher-ID angegeben wird, andernfalls optional. Muss den Namen der Aufnahmedatei (*.cap) enthalten. Für den virtuellen Linux-Computer muss er mit /var/captures beginnen. Schnur
storageId Die ID des Speicherkontos zum Speichern der Paketerfassungssitzung. Erforderlich, wenn kein localPath oder FilePath bereitgestellt wird. Schnur
storagePath Der URI des Speicherpfads zum Speichern der Paketerfassung. Muss ein wohlgeformter URI sein, der den Speicherort beschreibt, um die Paketerfassung zu speichern. Schnur

ARM-Vorlagenressourcendefinition

Der Ressourcentyp "networkWatchers/packetCaptures" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.Network/networkWatchers/packetCaptures-Ressource zu erstellen, fügen Sie Ihrer Vorlage den folgenden JSON-Code hinzu.

{
  "type": "Microsoft.Network/networkWatchers/packetCaptures",
  "apiVersion": "2024-03-01",
  "name": "string",
  "properties": {
    "bytesToCapturePerPacket": "int",
    "captureSettings": {
      "fileCount": "int",
      "fileSizeInBytes": "int",
      "sessionTimeLimitInSeconds": "int"
    },
    "continuousCapture": "bool",
    "filters": [
      {
        "localIPAddress": "string",
        "localPort": "string",
        "protocol": "string",
        "remoteIPAddress": "string",
        "remotePort": "string"
      }
    ],
    "scope": {
      "exclude": [ "string" ],
      "include": [ "string" ]
    },
    "storageLocation": {
      "filePath": "string",
      "localPath": "string",
      "storageId": "string",
      "storagePath": "string"
    },
    "target": "string",
    "targetType": "string",
    "timeLimitInSeconds": "int",
    "totalBytesPerSession": "int"
  }
}

Eigenschaftswerte

Microsoft.Network/networkWatchers/packetCaptures

Name Beschreibung Wert
apiVersion Die API-Version '2024-03-01'
Name Der Ressourcenname Zeichenfolge (erforderlich)
Eigenschaften Eigenschaften der Paketerfassung. PacketCaptureParametersOrPacketCaptureResultProperties (erforderlich)
Art Der Ressourcentyp "Microsoft.Network/networkWatchers/packetCaptures"

PacketCaptureFilter

Name Beschreibung Wert
localIPAddress Lokale IP-Adresse, nach der gefiltert werden soll. Notation: "127.0.0.1" für die Eingabe einer einzelnen Adresse. "127.0.0.1-127.0.0.255" für den Bereich. "127.0.0.1; 127.0.0.5"? für mehrere Einträge. Mehrere Bereiche werden derzeit nicht unterstützt. Das Mischen von Bereichen mit mehreren Einträgen wird derzeit nicht unterstützt. Default = null. Schnur
localPort Lokaler Port, nach dem gefiltert werden soll. Notation: "80" für single port entry." 80-85 Zoll für Bereich. "80; 443;" für mehrere Einträge. Mehrere Bereiche werden derzeit nicht unterstützt. Das Mischen von Bereichen mit mehreren Einträgen wird derzeit nicht unterstützt. Default = null. Schnur
Protokoll Protokoll, nach dem gefiltert werden soll. "Beliebig"
"TCP"
"UDP"
remoteIPAddress Lokale IP-Adresse, nach der gefiltert werden soll. Notation: "127.0.0.1" für die Eingabe einer einzelnen Adresse. "127.0.0.1-127.0.0.255" für den Bereich. "127.0.0.1; 127.0.0.5;" für mehrere Einträge. Mehrere Bereiche werden derzeit nicht unterstützt. Das Mischen von Bereichen mit mehreren Einträgen wird derzeit nicht unterstützt. Default = null. Schnur
remotePort Remoteport, nach dem gefiltert werden soll. Notation: "80" für single port entry." 80-85 Zoll für Bereich. "80; 443;" für mehrere Einträge. Mehrere Bereiche werden derzeit nicht unterstützt. Das Mischen von Bereichen mit mehreren Einträgen wird derzeit nicht unterstützt. Default = null. Schnur

PacketCaptureMachineScope

Name Beschreibung Wert
ausschließen Liste der AzureVMSS-Instanzen, die von der Ausführung der Paketerfassung von AzureVMSS ausgeschlossen werden müssen. string[]
einschließen Liste der AzureVMSS-Instanzen zum Ausführen der Paketerfassung. string[]

PacketCaptureParametersOrPacketCaptureResultProperties

Name Beschreibung Wert
bytesToCapturePerPacket Die Anzahl der pro Paket erfassten Bytes, die verbleibenden Bytes werden abgeschnitten. Int

Zwänge:
Min.-Wert = 0
Max. Wert = 4294967295
captureSettings Die Aufnahmeeinstellung enthält die Werte "FileCount", "FileSizeInBytes", "SessionTimeLimitInSeconds". PacketCaptureSettings-
continuousCapture Diese fortlaufende Erfassung ist ein boolescher Nullwert, der den Wert "null", "true" oder "false" enthalten kann. Wenn dieser Parameter nicht übergeben wird, wird er als "null" betrachtet, der Standardwert ist "null". Bool
Filter Eine Liste der Paketerfassungsfilter. PacketCaptureFilter-[]
Umfang Eine Liste der AzureVMSS-Instanzen, die eingeschlossen oder ausgeschlossen werden können, um die Paketerfassung auszuführen. Wenn sowohl eingeschlossen als auch ausgeschlossen leer sind, wird die Paketerfassung auf allen Instanzen von AzureVMSS ausgeführt. PacketCaptureMachineScope-
storageLocation Der Speicherort für eine Paketerfassungssitzung. PacketCaptureStorageLocation- (erforderlich)
Ziel Die ID der zielbezogenen Ressource, nur AzureVM und AzureVMSS als Zieltyp werden derzeit unterstützt. Zeichenfolge (erforderlich)
targetType Zieltyp der bereitgestellten Ressource. "AzureVM"
"AzureVMSS"
timeLimitInSeconds Maximale Dauer der Aufnahmesitzung in Sekunden. Int

Zwänge:
Min.-Wert = 0
Maximalwert = 18000
totalBytesPerSession Maximale Größe der Aufnahmeausgabe. Int

Zwänge:
Min.-Wert = 0
Max. Wert = 4294967295

PacketCaptureSettings

Name Beschreibung Wert
fileCount Anzahl der Dateien. Der Standardwert der Anzahl ist 10 und die maximale Zahl ist 10000. Int

Zwänge:
Min.-Wert = 0
Max. Wert = 10000
fileSizeInBytes Anzahl der pro Paket erfassten Bytes. Standardwert in Byte 104857600 (100 MB) und maximal in Byte 4294967295 (4 GB). Int

Zwänge:
Min.-Wert = 0
Max. Wert = 4294967295
sessionTimeLimitInSeconds Die maximale Dauer der Aufnahmesitzung in Sekunden beträgt 604800s (7 Tage) für eine Datei. Standardwert in den zweiten 86400er Jahren (1 Tag). Int

Zwänge:
Min.-Wert = 0
Maximalwert = 604800

PacketCaptureStorageLocation

Name Beschreibung Wert
filePath Dieser Pfad ist ungültig, wenn 'Continuous Capture' mit 'true' oder 'false' bereitgestellt wird. Ein gültiger lokaler Pfad auf der Ziel-VM. Muss den Namen der Aufnahmedatei (*.cap) enthalten. Für den virtuellen Linux-Computer muss er mit /var/captures beginnen. Erforderlich, wenn keine Speicher-ID angegeben wird, andernfalls optional. Schnur
localPath Dieser Pfad ist gültig, wenn "Fortlaufende Erfassung" mit "true" oder "false" bereitgestellt wird und erforderlich ist, wenn keine Speicher-ID angegeben wird, andernfalls optional. Muss den Namen der Aufnahmedatei (*.cap) enthalten. Für den virtuellen Linux-Computer muss er mit /var/captures beginnen. Schnur
storageId Die ID des Speicherkontos zum Speichern der Paketerfassungssitzung. Erforderlich, wenn kein localPath oder FilePath bereitgestellt wird. Schnur
storagePath Der URI des Speicherpfads zum Speichern der Paketerfassung. Muss ein wohlgeformter URI sein, der den Speicherort beschreibt, um die Paketerfassung zu speichern. Schnur

Terraform -Ressourcendefinition (AzAPI-Anbieter)

Der Ressourcentyp "networkWatchers/packetCaptures" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

  • Ressourcengruppen

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.Network/networkWatchers/packetCaptures-Ressource zu erstellen, fügen Sie Ihrer Vorlage die folgende Terraform hinzu.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Network/networkWatchers/packetCaptures@2024-03-01"
  name = "string"
  body = jsonencode({
    properties = {
      bytesToCapturePerPacket = int
      captureSettings = {
        fileCount = int
        fileSizeInBytes = int
        sessionTimeLimitInSeconds = int
      }
      continuousCapture = bool
      filters = [
        {
          localIPAddress = "string"
          localPort = "string"
          protocol = "string"
          remoteIPAddress = "string"
          remotePort = "string"
        }
      ]
      scope = {
        exclude = [
          "string"
        ]
        include = [
          "string"
        ]
      }
      storageLocation = {
        filePath = "string"
        localPath = "string"
        storageId = "string"
        storagePath = "string"
      }
      target = "string"
      targetType = "string"
      timeLimitInSeconds = int
      totalBytesPerSession = int
    }
  })
}

Eigenschaftswerte

Microsoft.Network/networkWatchers/packetCaptures

Name Beschreibung Wert
Name Der Ressourcenname Zeichenfolge (erforderlich)
parent_id Die ID der Ressource, die das übergeordnete Element für diese Ressource ist. ID für Ressource vom Typ: networkWatchers
Eigenschaften Eigenschaften der Paketerfassung. PacketCaptureParametersOrPacketCaptureResultProperties (erforderlich)
Art Der Ressourcentyp "Microsoft.Network/networkWatchers/packetCaptures@2024-03-01"

PacketCaptureFilter

Name Beschreibung Wert
localIPAddress Lokale IP-Adresse, nach der gefiltert werden soll. Notation: "127.0.0.1" für die Eingabe einer einzelnen Adresse. "127.0.0.1-127.0.0.255" für den Bereich. "127.0.0.1; 127.0.0.5"? für mehrere Einträge. Mehrere Bereiche werden derzeit nicht unterstützt. Das Mischen von Bereichen mit mehreren Einträgen wird derzeit nicht unterstützt. Default = null. Schnur
localPort Lokaler Port, nach dem gefiltert werden soll. Notation: "80" für single port entry." 80-85 Zoll für Bereich. "80; 443;" für mehrere Einträge. Mehrere Bereiche werden derzeit nicht unterstützt. Das Mischen von Bereichen mit mehreren Einträgen wird derzeit nicht unterstützt. Default = null. Schnur
Protokoll Protokoll, nach dem gefiltert werden soll. "Beliebig"
"TCP"
"UDP"
remoteIPAddress Lokale IP-Adresse, nach der gefiltert werden soll. Notation: "127.0.0.1" für die Eingabe einer einzelnen Adresse. "127.0.0.1-127.0.0.255" für den Bereich. "127.0.0.1; 127.0.0.5;" für mehrere Einträge. Mehrere Bereiche werden derzeit nicht unterstützt. Das Mischen von Bereichen mit mehreren Einträgen wird derzeit nicht unterstützt. Default = null. Schnur
remotePort Remoteport, nach dem gefiltert werden soll. Notation: "80" für single port entry." 80-85 Zoll für Bereich. "80; 443;" für mehrere Einträge. Mehrere Bereiche werden derzeit nicht unterstützt. Das Mischen von Bereichen mit mehreren Einträgen wird derzeit nicht unterstützt. Default = null. Schnur

PacketCaptureMachineScope

Name Beschreibung Wert
ausschließen Liste der AzureVMSS-Instanzen, die von der Ausführung der Paketerfassung von AzureVMSS ausgeschlossen werden müssen. string[]
einschließen Liste der AzureVMSS-Instanzen zum Ausführen der Paketerfassung. string[]

PacketCaptureParametersOrPacketCaptureResultProperties

Name Beschreibung Wert
bytesToCapturePerPacket Die Anzahl der pro Paket erfassten Bytes, die verbleibenden Bytes werden abgeschnitten. Int

Zwänge:
Min.-Wert = 0
Max. Wert = 4294967295
captureSettings Die Aufnahmeeinstellung enthält die Werte "FileCount", "FileSizeInBytes", "SessionTimeLimitInSeconds". PacketCaptureSettings-
continuousCapture Diese fortlaufende Erfassung ist ein boolescher Nullwert, der den Wert "null", "true" oder "false" enthalten kann. Wenn dieser Parameter nicht übergeben wird, wird er als "null" betrachtet, der Standardwert ist "null". Bool
Filter Eine Liste der Paketerfassungsfilter. PacketCaptureFilter-[]
Umfang Eine Liste der AzureVMSS-Instanzen, die eingeschlossen oder ausgeschlossen werden können, um die Paketerfassung auszuführen. Wenn sowohl eingeschlossen als auch ausgeschlossen leer sind, wird die Paketerfassung auf allen Instanzen von AzureVMSS ausgeführt. PacketCaptureMachineScope-
storageLocation Der Speicherort für eine Paketerfassungssitzung. PacketCaptureStorageLocation- (erforderlich)
Ziel Die ID der zielbezogenen Ressource, nur AzureVM und AzureVMSS als Zieltyp werden derzeit unterstützt. Zeichenfolge (erforderlich)
targetType Zieltyp der bereitgestellten Ressource. "AzureVM"
"AzureVMSS"
timeLimitInSeconds Maximale Dauer der Aufnahmesitzung in Sekunden. Int

Zwänge:
Min.-Wert = 0
Maximalwert = 18000
totalBytesPerSession Maximale Größe der Aufnahmeausgabe. Int

Zwänge:
Min.-Wert = 0
Max. Wert = 4294967295

PacketCaptureSettings

Name Beschreibung Wert
fileCount Anzahl der Dateien. Der Standardwert der Anzahl ist 10 und die maximale Zahl ist 10000. Int

Zwänge:
Min.-Wert = 0
Max. Wert = 10000
fileSizeInBytes Anzahl der pro Paket erfassten Bytes. Standardwert in Byte 104857600 (100 MB) und maximal in Byte 4294967295 (4 GB). Int

Zwänge:
Min.-Wert = 0
Max. Wert = 4294967295
sessionTimeLimitInSeconds Die maximale Dauer der Aufnahmesitzung in Sekunden beträgt 604800s (7 Tage) für eine Datei. Standardwert in den zweiten 86400er Jahren (1 Tag). Int

Zwänge:
Min.-Wert = 0
Maximalwert = 604800

PacketCaptureStorageLocation

Name Beschreibung Wert
filePath Dieser Pfad ist ungültig, wenn 'Continuous Capture' mit 'true' oder 'false' bereitgestellt wird. Ein gültiger lokaler Pfad auf der Ziel-VM. Muss den Namen der Aufnahmedatei (*.cap) enthalten. Für den virtuellen Linux-Computer muss er mit /var/captures beginnen. Erforderlich, wenn keine Speicher-ID angegeben wird, andernfalls optional. Schnur
localPath Dieser Pfad ist gültig, wenn "Fortlaufende Erfassung" mit "true" oder "false" bereitgestellt wird und erforderlich ist, wenn keine Speicher-ID angegeben wird, andernfalls optional. Muss den Namen der Aufnahmedatei (*.cap) enthalten. Für den virtuellen Linux-Computer muss er mit /var/captures beginnen. Schnur
storageId Die ID des Speicherkontos zum Speichern der Paketerfassungssitzung. Erforderlich, wenn kein localPath oder FilePath bereitgestellt wird. Schnur
storagePath Der URI des Speicherpfads zum Speichern der Paketerfassung. Muss ein wohlgeformter URI sein, der den Speicherort beschreibt, um die Paketerfassung zu speichern. Schnur