Skip to content

Commit 2cf9b9d

Browse files
committed
Improved Acrolinx score a bit
1 parent 8bf3b06 commit 2cf9b9d

File tree

3 files changed

+25
-25
lines changed

3 files changed

+25
-25
lines changed

articles/iot-edge/how-to-configure-multiple-nics.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -29,13 +29,13 @@ For more information about networking concepts and configurations, see [Azure Io
2929
- Virtual switch different from the default one used during EFLOW installation. For more information on creating a virtual switch, see [Create a virtual switch for Azure IoT Edge for Linux on Windows](./how-to-create-virtual-switch.md).
3030

3131
## Create and assign a virtual switch
32-
During the EFLOW VM deployment, the VM had a switched assigned for all the communications between the Windows host OS and the virtual machine. This will always be the switch used for VM lifecycle management communications, and it's not possible to delete it.
32+
During the EFLOW VM deployment, the VM had a switch assigned for all communications between the Windows host OS and the virtual machine. You always use the switch for VM lifecycle management communications, and it's not possible to delete it.
3333

34-
The following steps in this section show how to assign a network interface to the EFLOW virtual machine. Ensure that the virtual switch being used and the networking configuration aligns with your networking environment. For more information about networking concepts like type of switches, DHCP and DNS, see [Azure IoT Edge for Linux on Windows networking](./iot-edge-for-linux-on-windows-networking.md).
34+
The following steps in this section show how to assign a network interface to the EFLOW virtual machine. Ensure that the virtual switch and the networking configuration align with your networking environment. For more information about networking concepts like type of switches, DHCP and DNS, see [Azure IoT Edge for Linux on Windows networking](./iot-edge-for-linux-on-windows-networking.md).
3535

3636
1. Open an elevated _PowerShell_ session by starting with **Run as Administrator**.
3737

38-
1. Check the virtual switch to be assigned to the EFLOW VM is available.
38+
1. Check that the virtual switch you assign to the EFLOW VM is available.
3939
```powershell
4040
Get-VMSwitch -Name "{switchName}" -SwitchType {switchType}
4141
```
@@ -49,7 +49,7 @@ The following steps in this section show how to assign a network interface to th
4949
```
5050
:::image type="content" source="./media/how-to-configure-multiple-nics/ps-cmdlet-add-eflow-network.png" alt-text="EFLOW attach virtual switch":::
5151
52-
1. Check that the virtual switch was correctly assigned to the EFLOW VM.
52+
1. Check that you correctly assigned the virtual switch to the EFLOW VM.
5353
```powershell
5454
Get-EflowNetwork -vSwitchName "{switchName}"
5555
```
@@ -58,13 +58,13 @@ For more information about attaching a virtual switch to the EFLOW VM, see [Powe
5858
5959
6060
## Create and assign a network endpoint
61-
Once the virtual switch was successfully assigned to the EFLOW VM, you need to create a networking endpoint assigned to virtual switch to finalize the network interface creation. If you're using Static IP, ensure to use the appropriate parameters: _ip4Address_, _ip4GatewayAddress_ and _ip4PrefixLength_.
61+
Once you successfully assign the virtual switch to the EFLOW VM, create a networking endpoint assigned to virtual switch to finalize the network interface creation. If you're using Static IP, ensure to use the appropriate parameters: _ip4Address_, _ip4GatewayAddress_ and _ip4PrefixLength_.
6262
6363
1. Open an elevated _PowerShell_ session by starting with **Run as Administrator**.
6464
6565
1. Create the EFLOW VM network endpoint
6666
67-
- If you're using DHCP, no Static IP parameters are needed.
67+
- If you're using DHCP, you don't need Static IP parameters.
6868
```powershell
6969
Add-EflowVmEndpoint -vSwitchName "{switchName}" -vEndpointName "{EndpointName}"
7070
```
@@ -81,7 +81,7 @@ Once the virtual switch was successfully assigned to the EFLOW VM, you need to c
8181
8282
:::image type="content" source="./media/how-to-configure-multiple-nics/ps-cmdlet-add-eflow-endpoint.png" alt-text="EFLOW attach network endpoint":::
8383
84-
1. Check that the network endpoint was correctly created and assigned to the EFLOW VM. You should see the two network interfaces assigned to the virtual machine.
84+
1. Check that you correctly created the network endpoint and assigned it to the EFLOW VM. You should see two network interfaces assigned to the virtual machine.
8585
```powershell
8686
Get-EflowVmEndpoint
8787
```
@@ -92,7 +92,7 @@ For more information about creating and attaching a network endpoint to the EFLO
9292
9393
9494
## Check the VM network configurations
95-
The final step is to make sure the networking configurations were applied correctly and the EFLOW VM has the new network interface configured. The new interface will show up as _"eth1"_ if it's the first extra interface added to the VM.
95+
The final step is to make sure the networking configurations applied correctly and the EFLOW VM has the new network interface configured. The new interface shows up as _"eth1"_ if it's the first extra interface added to the VM.
9696
9797
1. Open PowerShell in an elevated session. You can do so by opening the **Start** pane on Windows and typing in "PowerShell". Right-click the **Windows PowerShell** app that shows up and select **Run as administrator**.
9898
@@ -105,9 +105,9 @@ The final step is to make sure the networking configurations were applied correc
105105
ifconfig
106106
```
107107
108-
The default interface **eth0** is the one used for all the VM management. You should see another interface, like **eth1**, which is the new interface that was assigned to the VM. Following the examples above, if you previously assigned a new endpoint with the static IP 192.168.0.103 you should see the interface **eth1** with the _inet addr: 192.168.0.103_.
108+
The default interface **eth0** is the one used for all the VM management. You should see another interface, like **eth1**, which is the new interface you assigned to the VM. Following the examples, if you previously assigned a new endpoint with the static IP 192.168.0.103 you should see the interface **eth1** with the _inet addr: 192.168.0.103_.
109109
110110
:::image type="content" source="./media/how-to-configure-multiple-nics/ps-cmdlet-eflow-ifconfig.png" alt-text="Screenshot of EFLOW virtual machine network interfaces.":::
111111
112112
## Next steps
113-
Follow the steps in [How to configure networking for Azure IoT Edge for Linux on Windows](./how-to-configure-iot-edge-for-linux-on-windows-networking.md) to make sure all the networking configurations were applied correctly.
113+
Follow the steps in [How to configure networking for Azure IoT Edge for Linux on Windows](./how-to-configure-iot-edge-for-linux-on-windows-networking.md) to make sure you applied all the networking configurations correctly.

articles/iot-edge/how-to-deploy-modules-cli.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -15,9 +15,9 @@ services: iot-edge
1515

1616
[!INCLUDE [iot-edge-version-all-supported](includes/iot-edge-version-all-supported.md)]
1717

18-
Once you create IoT Edge modules with your business logic, you want to deploy them to your devices to operate at the edge. If you have multiple modules that work together to collect and process data, you can deploy them all at once and declare the routing rules that connect them.
18+
Once you create Azure IoT Edge modules with your business logic, you want to deploy them to your devices to operate at the edge. If you have multiple modules that work together to collect and process data, you can deploy them all at once. You can also declare the routing rules that connect them.
1919

20-
[Azure CLI](/cli/azure) is an open-source cross platform command-line tool for managing Azure resources such as IoT Edge. It enables you to manage Azure IoT Hub resources, device provisioning service instances, and linked-hubs out of the box. The new IoT extension enriches Azure CLI with features such as device management and full IoT Edge capability.
20+
[Azure CLI](/cli/azure) is an open-source cross platform, command-line tool for managing Azure resources such as IoT Edge. It enables you to manage Azure IoT Hub resources, device provisioning service instances, and linked-hubs out of the box. The new IoT extension enriches Azure CLI with features such as device management and full IoT Edge capability.
2121

2222
This article shows how to create a JSON deployment manifest, then use that file to push the deployment to an IoT Edge device. For information about creating a deployment that targets multiple devices based on their shared tags, see [Deploy and monitor IoT Edge modules at scale](how-to-deploy-cli-at-scale.md)
2323

@@ -28,14 +28,14 @@ This article shows how to create a JSON deployment manifest, then use that file
2828

2929
If you don't have an IoT Edge device set up, you can create one in an Azure virtual machine. Follow the steps in one of the quickstart articles to [Create a virtual Linux device](quickstart-linux.md) or [Create a virtual Windows device](quickstart.md).
3030

31-
* [Azure CLI](/cli/azure/install-azure-cli) in your environment. At a minimum, your Azure CLI version must be 2.0.70 or above. Use `az --version` to validate. This version supports az extension commands and introduces the Knack command framework.
31+
* [Azure CLI](/cli/azure/install-azure-cli) in your environment. At a minimum, your Azure CLI version must be 2.0.70 or higher. Use `az --version` to validate. This version supports az extension commands and introduces the Knack command framework.
3232
* The [IoT extension for Azure CLI](https://github.com/Azure/azure-iot-cli-extension).
3333

3434
## Configure a deployment manifest
3535

3636
A deployment manifest is a JSON document that describes which modules to deploy, how data flows between the modules, and desired properties of the module twins. For more information about how deployment manifests work and how to create them, see [Understand how IoT Edge modules can be used, configured, and reused](module-composition.md).
3737

38-
To deploy modules using the Azure CLI, save the deployment manifest locally as a .json file. You will use the file path in the next section when you run the command to apply the configuration to your device.
38+
To deploy modules using the Azure CLI, save the deployment manifest locally as a .json file. You use the file path in the next section when you run the command to apply the configuration to your device.
3939

4040
Here's a basic deployment manifest with one module as an example:
4141

@@ -115,7 +115,7 @@ Here's a basic deployment manifest with one module as an example:
115115

116116
You deploy modules to your device by applying the deployment manifest that you configured with the module information.
117117

118-
Change directories into the folder where your deployment manifest is saved. If you used one of the Visual Studio Code IoT Edge templates, use the `deployment.json` file in the **config** folder of your solution directory and not the `deployment.template.json` file.
118+
Change directories into the folder where you saved your deployment manifest. If you used one of the Visual Studio Code IoT Edge templates, use the `deployment.json` file in the **config** folder of your solution directory and not the `deployment.template.json` file.
119119

120120
Use the following command to apply the configuration to an IoT Edge device:
121121

@@ -125,7 +125,7 @@ Use the following command to apply the configuration to an IoT Edge device:
125125

126126
The device ID parameter is case-sensitive. The content parameter points to the deployment manifest file that you saved.
127127

128-
:::image type="content" source="./media/how-to-deploy-cli/set-modules.png" alt-text="Screenshot showing the az iot edge set-modules command output .":::
128+
:::image type="content" source="./media/how-to-deploy-cli/set-modules.png" alt-text="Screenshot showing the az iot edge set-modules command line output.":::
129129

130130
## View modules on your device
131131

@@ -139,7 +139,7 @@ View the modules on your IoT Edge device:
139139

140140
The device ID parameter is case-sensitive.
141141

142-
:::image type="content" source="./media/how-to-deploy-cli/list-modules.png" alt-text="Screenshot showing the az iot hub module-identity list command output .":::
142+
:::image type="content" source="./media/how-to-deploy-cli/list-modules.png" alt-text="Screenshot showing the az iot hub module-identity list command output.":::
143143

144144
## Next steps
145145

0 commit comments

Comments
 (0)