|
| 1 | +# Azure CLI databoxedge Extension # |
| 2 | +This is the extension for databoxedge |
| 3 | + |
| 4 | +### How to use ### |
| 5 | +Install this extension using the below CLI command |
| 6 | +``` |
| 7 | +az extension add --name databoxedge |
| 8 | +``` |
| 9 | + |
| 10 | +### Included Features ### |
| 11 | +#### databoxedge device #### |
| 12 | +##### Create ##### |
| 13 | +``` |
| 14 | +az databoxedge device create --location "eastus" --sku name="Edge" tier="Standard" --name "testedgedevice" \ |
| 15 | + --resource-group "GroupForEdgeAutomation" |
| 16 | +``` |
| 17 | +##### Show ##### |
| 18 | +``` |
| 19 | +az databoxedge device show --name "testedgedevice" --resource-group "GroupForEdgeAutomation" |
| 20 | +``` |
| 21 | +##### List ##### |
| 22 | +``` |
| 23 | +az databoxedge device list --resource-group "GroupForEdgeAutomation" |
| 24 | +``` |
| 25 | +##### Update ##### |
| 26 | +``` |
| 27 | +az databoxedge device update --name "testedgedevice" --tags Key1="value1" Key2="value2" \ |
| 28 | + --resource-group "GroupForEdgeAutomation" |
| 29 | +``` |
| 30 | +##### Create-or-update-security-setting ##### |
| 31 | +``` |
| 32 | +az databoxedge device create-or-update-security-setting --name "testedgedevice" --resource-group "AzureVM" \ |
| 33 | + --device-admin-password encryption-algorithm="AES256" encryption-cert-thumbprint="7DCBDFC44ED968D232C9A998FC105B5C70E84BE0" value="<value>" |
| 34 | +``` |
| 35 | +##### Download-update ##### |
| 36 | +``` |
| 37 | +az databoxedge device download-update --name "testedgedevice" --resource-group "GroupForEdgeAutomation" |
| 38 | +``` |
| 39 | +##### Get-extended-information ##### |
| 40 | +``` |
| 41 | +az databoxedge device get-extended-information --name "testedgedevice" --resource-group "GroupForEdgeAutomation" |
| 42 | +``` |
| 43 | +##### Install-update ##### |
| 44 | +``` |
| 45 | +az databoxedge device install-update --name "testedgedevice" --resource-group "GroupForEdgeAutomation" |
| 46 | +``` |
| 47 | +##### Scan-for-update ##### |
| 48 | +``` |
| 49 | +az databoxedge device scan-for-update --name "testedgedevice" --resource-group "GroupForEdgeAutomation" |
| 50 | +``` |
| 51 | +##### Show-network-setting ##### |
| 52 | +``` |
| 53 | +az databoxedge device show-network-setting --name "testedgedevice" --resource-group "GroupForEdgeAutomation" |
| 54 | +``` |
| 55 | +##### Show-update-summary ##### |
| 56 | +``` |
| 57 | +az databoxedge device show-update-summary --name "testedgedevice" --resource-group "GroupForEdgeAutomation" |
| 58 | +``` |
| 59 | +##### Upload-certificate ##### |
| 60 | +``` |
| 61 | +az databoxedge device upload-certificate --name "testedgedevice" \ |
| 62 | + --certificate "MIIC9DCCAdygAwIBAgIQWJae7GNjiI9Mcv/gJyrOPTANBgkqhkiG9w0BAQUFADASMRAwDgYDVQQDDAdXaW5kb3dzMB4XDTE4MTEyNzAwMTA0NVoXDTIxMTEyODAwMTA0NVowEjEQMA4GA1UEAwwHV2luZG93czCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAKxkRExqxf0qH1avnyORptIbRC2yQwqe3EIbJ2FPKr5jtAppGeX/dGKrFSnX+7/0HFr77aJHafdpEAtOiLyJ4zCAVs0obZCCIq4qJdmjYUTU0UXH/w/YzXfQA0d9Zh9AN+NJBX9xj05NzgsT24fkgsK2v6mWJQXT7YcWAsl5sEYPnx1e+MrupNyVSL/RUJmrS+etJSysHtFeWRhsUhVAs1DD5ExJvBLU3WH0IsojEvpXcjrutB5/MDQNrd/StGI6WovoSSPH7FyT9tgERx+q+Yg3YUGzfaIPCctlrRGehcdtzdNoKd0rsX62yCq0U6POoSfwe22NJu41oAUMd7e6R8cCAwEAAaNGMEQwEwYDVR0lBAwwCgYIKwYBBQUHAwIwHQYDVR0OBBYEFDd0VxnS3LnMIfwc7xW4b4IZWG5GMA4GA1UdDwEB/wQEAwIFIDANBgkqhkiG9w0BAQUFAAOCAQEAPQRby2u9celvtvL/DLEb5Vt3/tPStRQC5MyTD62L5RT/q8E6EMCXVZNkXF5WlWucLJi/18tY+9PNgP9xWLJh7kpSWlWdi9KPtwMqKDlEH8L2TnQdjimt9XuiCrTnoFy/1X2BGLY/rCaUJNSd15QCkz2xeW+Z+YSk2GwAc/A/4YfNpqSIMfNuPrT76o02VdD9WmJUA3fS/HY0sU9qgQRS/3F5/0EPS+HYQ0SvXCK9tggcCd4O050ytNBMJC9qMOJ7yE0iOrFfOJSCfDAuPhn/rHFh79Kn1moF+/CE+nc0/2RPiLC8r54/rt5dYyyxJDfXg0a3VrrX39W69WZGW5OXiw==" \ |
| 63 | + --resource-group "GroupForEdgeAutomation" |
| 64 | +``` |
| 65 | +##### Delete ##### |
| 66 | +``` |
| 67 | +az databoxedge device delete --name "testedgedevice" --resource-group "GroupForEdgeAutomation" |
| 68 | +``` |
| 69 | +#### databoxedge alert #### |
| 70 | +##### List ##### |
| 71 | +``` |
| 72 | +az databoxedge alert list --device-name "testedgedevice" --resource-group "GroupForEdgeAutomation" |
| 73 | +``` |
| 74 | +##### Show ##### |
| 75 | +``` |
| 76 | +az databoxedge alert show --name "159a00c7-8543-4343-9435-263ac87df3bb" --device-name "testedgedevice" \ |
| 77 | + --resource-group "GroupForEdgeAutomation" |
| 78 | +``` |
| 79 | +#### databoxedge bandwidth-schedule #### |
| 80 | +##### Create ##### |
| 81 | +``` |
| 82 | +az databoxedge bandwidth-schedule create --name "bandwidth-1" --device-name "testedgedevice" --days "Sunday" "Monday" \ |
| 83 | + --rate-in-mbps 100 --start "0:0:0" --stop "13:59:0" --resource-group "GroupForEdgeAutomation" |
| 84 | +``` |
| 85 | +##### Show ##### |
| 86 | +``` |
| 87 | +az databoxedge bandwidth-schedule show --name "bandwidth-1" --device-name "testedgedevice" \ |
| 88 | + --resource-group "GroupForEdgeAutomation" |
| 89 | +``` |
| 90 | +##### List ##### |
| 91 | +``` |
| 92 | +az databoxedge bandwidth-schedule list --device-name "testedgedevice" --resource-group "GroupForEdgeAutomation" |
| 93 | +``` |
| 94 | +##### Delete ##### |
| 95 | +``` |
| 96 | +az databoxedge bandwidth-schedule delete --name "bandwidth-1" --device-name "testedgedevice" \ |
| 97 | + --resource-group "GroupForEdgeAutomation" |
| 98 | +``` |
| 99 | +#### databoxedge job #### |
| 100 | +##### Show ##### |
| 101 | +``` |
| 102 | +az databoxedge job show --name "159a00c7-8543-4343-9435-263ac87df3bb" --device-name "testedgedevice" \ |
| 103 | + --resource-group "GroupForEdgeAutomation" |
| 104 | +``` |
| 105 | +#### databoxedge node #### |
| 106 | +##### List ##### |
| 107 | +``` |
| 108 | +az databoxedge node list --device-name "testedgedevice" --resource-group "GroupForEdgeAutomation" |
| 109 | +``` |
| 110 | +#### databoxedge operation-status #### |
| 111 | +##### Show ##### |
| 112 | +``` |
| 113 | +az databoxedge operation-status show --name "159a00c7-8543-4343-9435-263ac87df3bb" --device-name "testedgedevice" \ |
| 114 | + --resource-group "GroupForEdgeAutomation" |
| 115 | +``` |
| 116 | +#### databoxedge order #### |
| 117 | +##### Create ##### |
| 118 | +``` |
| 119 | +az databoxedge order create --device-name "testedgedevice" \ |
| 120 | + --contact-information company-name="Microsoft" contact-person="John Mcclane" email-list="[email protected]" phone="(800) 426-9400" \ |
| 121 | + --shipping-address address-line1="Microsoft Corporation" address-line2="One Microsoft Way" address-line3="Redmond" city="WA" country="USA" postal-code="98052" state="WA" \ |
| 122 | + --resource-group "GroupForEdgeAutomation" |
| 123 | +``` |
| 124 | +##### Show ##### |
| 125 | +``` |
| 126 | +az databoxedge order show --device-name "testedgedevice" --resource-group "GroupForEdgeAutomation" |
| 127 | +``` |
| 128 | +##### List ##### |
| 129 | +``` |
| 130 | +az databoxedge order list --device-name "testedgedevice" --resource-group "GroupForEdgeAutomation" |
| 131 | +``` |
| 132 | +##### Delete ##### |
| 133 | +``` |
| 134 | +az databoxedge order delete --device-name "testedgedevice" --resource-group "GroupForEdgeAutomation" |
| 135 | +``` |
| 136 | +#### databoxedge role #### |
| 137 | +##### Create ##### |
| 138 | +``` |
| 139 | +az databoxedge role create --name "IoTRole1" --device-name "testedgedevice" --resource-group "GroupForEdgeAutomation" \ |
| 140 | + --role "{\\"kind\\":\\"IOT\\",\\"properties\\":{\\"hostPlatform\\":\\"Linux\\",\\"ioTDeviceDetails\\":{\\"authentication\\":{\\"symmetricKey\\":{\\"connectionString\\":{\\"encryptionAlgorithm\\":\\"AES256\\",\\"encryptionCertThumbprint\\":\\"348586569999244\\",\\"value\\":\\"Encrypted<<HostName=iothub.azure-devices.net;DeviceId=iotDevice;SharedAccessKey=2C750FscEas3JmQ8Bnui5yQWZPyml0/UiRt1bQwd8=>>\\"}}},\\"deviceId\\":\\"iotdevice\\",\\"ioTHostHub\\":\\"iothub.azure-devices.net\\"},\\"ioTEdgeDeviceDetails\\":{\\"authentication\\":{\\"symmetricKey\\":{\\"connectionString\\":{\\"encryptionAlgorithm\\":\\"AES256\\",\\"encryptionCertThumbprint\\":\\"1245475856069999244\\",\\"value\\":\\"Encrypted<<HostName=iothub.azure-devices.net;DeviceId=iotEdge;SharedAccessKey=2C750FscEas3JmQ8Bnui5yQWZPyml0/UiRt1bQwd8=>>\\"}}},\\"deviceId\\":\\"iotEdge\\",\\"ioTHostHub\\":\\"iothub.azure-devices.net\\"},\\"roleStatus\\":\\"Enabled\\",\\"shareMappings\\":[]}}" |
| 141 | +``` |
| 142 | +##### Show ##### |
| 143 | +``` |
| 144 | +az databoxedge role show --name "IoTRole1" --device-name "testedgedevice" --resource-group "GroupForEdgeAutomation" |
| 145 | +``` |
| 146 | +##### List ##### |
| 147 | +``` |
| 148 | +az databoxedge role list --device-name "testedgedevice" --resource-group "GroupForEdgeAutomation" |
| 149 | +``` |
| 150 | +##### Delete ##### |
| 151 | +``` |
| 152 | +az databoxedge role delete --name "IoTRole1" --device-name "testedgedevice" --resource-group "GroupForEdgeAutomation" |
| 153 | +``` |
| 154 | +#### databoxedge share #### |
| 155 | +##### Create ##### |
| 156 | +``` |
| 157 | +az databoxedge share create --name "smbshare" --device-name "testedgedevice" --resource-group "GroupForEdgeAutomation" \ |
| 158 | + --description "" --access-protocol "SMB" \ |
| 159 | + --azure-container-info container-name="testContainerSMB" data-format="BlockBlob" storage-account-credential-id="/subscriptions/4385cf00-2d3a-425a-832f-f4285b1c9dce/resourceGroups/GroupForEdgeAutomation/providers/Microsoft.DataBoxEdge/dataBoxEdgeDevices/testedgedevice/storageAccountCredentials/sac1" \ |
| 160 | + --data-policy "Cloud" --monitoring-status "Enabled" --share-status "Online" \ |
| 161 | + --user-access-rights access-type="Change" user-id="/subscriptions/4385cf00-2d3a-425a-832f-f4285b1c9dce/resourceGroups/GroupForEdgeAutomation/providers/Microsoft.DataBoxEdge/dataBoxEdgeDevices/testedgedevice/users/user2" |
| 162 | +``` |
| 163 | +##### Show ##### |
| 164 | +``` |
| 165 | +az databoxedge share show --name "smbshare" --device-name "testedgedevice" --resource-group "GroupForEdgeAutomation" |
| 166 | +``` |
| 167 | +##### List ##### |
| 168 | +``` |
| 169 | +az databoxedge share list --device-name "testedgedevice" --resource-group "GroupForEdgeAutomation" |
| 170 | +``` |
| 171 | +##### Refresh ##### |
| 172 | +``` |
| 173 | +az databoxedge share refresh --name "smbshare" --device-name "testedgedevice" --resource-group "GroupForEdgeAutomation" |
| 174 | +``` |
| 175 | +##### Delete ##### |
| 176 | +``` |
| 177 | +az databoxedge share delete --name "smbshare" --device-name "testedgedevice" --resource-group "GroupForEdgeAutomation" |
| 178 | +``` |
| 179 | +#### databoxedge storage-account-credentials #### |
| 180 | +##### List ##### |
| 181 | +``` |
| 182 | +az databoxedge storage-account-credentials list --device-name "testedgedevice" \ |
| 183 | + --resource-group "GroupForEdgeAutomation" |
| 184 | +``` |
| 185 | +##### Show ##### |
| 186 | +``` |
| 187 | +az databoxedge storage-account-credentials show --name "sac1" --device-name "testedgedevice" \ |
| 188 | + --resource-group "GroupForEdgeAutomation" |
| 189 | +``` |
| 190 | +##### Delete ##### |
| 191 | +``` |
| 192 | +az databoxedge storage-account-credentials delete --name "sac1" --device-name "testedgedevice" \ |
| 193 | + --resource-group "GroupForEdgeAutomation" |
| 194 | +``` |
| 195 | +#### databoxedge storage-account #### |
| 196 | +##### List ##### |
| 197 | +``` |
| 198 | +az databoxedge storage-account list --device-name "testedgedevice" --resource-group "GroupForEdgeAutomation" |
| 199 | +``` |
| 200 | +##### Show ##### |
| 201 | +``` |
| 202 | +az databoxedge storage-account show --device-name "testedgedevice" --resource-group "GroupForEdgeAutomation" \ |
| 203 | + --name "blobstorageaccount1" |
| 204 | +``` |
| 205 | +##### Delete ##### |
| 206 | +``` |
| 207 | +az databoxedge storage-account delete --device-name "testedgedevice" --resource-group "GroupForEdgeAutomation" \ |
| 208 | + --name "storageaccount1" |
| 209 | +``` |
| 210 | +#### databoxedge container #### |
| 211 | +##### Create ##### |
| 212 | +``` |
| 213 | +az databoxedge container create --data-format "BlockBlob" --name "blobcontainer1" --device-name "testedgedevice" \ |
| 214 | + --resource-group "GroupForEdgeAutomation" --storage-account-name "storageaccount1" |
| 215 | +``` |
| 216 | +##### Show ##### |
| 217 | +``` |
| 218 | +az databoxedge container show --name "blobcontainer1" --device-name "testedgedevice" \ |
| 219 | + --resource-group "GroupForEdgeAutomation" --storage-account-name "storageaccount1" |
| 220 | +``` |
| 221 | +##### List ##### |
| 222 | +``` |
| 223 | +az databoxedge container list --device-name "testedgedevice" --resource-group "GroupForEdgeAutomation" \ |
| 224 | + --storage-account-name "storageaccount1" |
| 225 | +``` |
| 226 | +##### Refresh ##### |
| 227 | +``` |
| 228 | +az databoxedge container refresh --name "blobcontainer1" --device-name "testedgedevice" \ |
| 229 | + --resource-group "GroupForEdgeAutomation" --storage-account-name "storageaccount1" |
| 230 | +``` |
| 231 | +##### Delete ##### |
| 232 | +``` |
| 233 | +az databoxedge container delete --name "blobcontainer1" --device-name "testedgedevice" \ |
| 234 | + --resource-group "GroupForEdgeAutomation" --storage-account-name "storageaccount1" |
| 235 | +``` |
| 236 | +#### databoxedge trigger #### |
| 237 | +##### Create ##### |
| 238 | +``` |
| 239 | +az databoxedge trigger create --name "trigger1" --device-name "testedgedevice" \ |
| 240 | + --resource-group "GroupForEdgeAutomation" \ |
| 241 | + --file-event-trigger custom-context-tag="CustomContextTags-1235346475" role-id="/subscriptions/4385cf00-2d3a-425a-832f-f4285b1c9dce/resourceGroups/GroupForEdgeAutomation/providers/Microsoft.DataBoxEdge/dataBoxEdgeDevices/testedgedevice/roles/role1" share-id="/subscriptions/4385cf00-2d3a-425a-832f-f4285b1c9dce/resourceGroups/GroupForEdgeAutomation/providers/Microsoft.DataBoxEdge/dataBoxEdgeDevices/testedgedevice/shares/share1" |
| 242 | +``` |
| 243 | +##### Show ##### |
| 244 | +``` |
| 245 | +az databoxedge trigger show --name "trigger1" --device-name "testedgedevice" --resource-group "GroupForEdgeAutomation" |
| 246 | +``` |
| 247 | +##### List ##### |
| 248 | +``` |
| 249 | +az databoxedge trigger list --device-name "testedgedevice" --resource-group "GroupForEdgeAutomation" |
| 250 | +``` |
| 251 | +##### Delete ##### |
| 252 | +``` |
| 253 | +az databoxedge trigger delete --name "trigger1" --device-name "testedgedevice" \ |
| 254 | + --resource-group "GroupForEdgeAutomation" |
| 255 | +``` |
| 256 | +#### databoxedge user #### |
| 257 | +##### Create ##### |
| 258 | +``` |
| 259 | +az databoxedge user create --name "user1" --device-name "testedgedevice" --resource-group "GroupForEdgeAutomation" \ |
| 260 | + --encrypted-password encryption-algorithm="None" encryption-cert-thumbprint="blah" value="<value>" \ |
| 261 | + --user-type "Share" |
| 262 | +``` |
| 263 | +##### Show ##### |
| 264 | +``` |
| 265 | +az databoxedge user show --name "user1" --device-name "testedgedevice" --resource-group "GroupForEdgeAutomation" |
| 266 | +``` |
| 267 | +##### List ##### |
| 268 | +``` |
| 269 | +az databoxedge user list --device-name "testedgedevice" --resource-group "GroupForEdgeAutomation" |
| 270 | +``` |
| 271 | +##### Delete ##### |
| 272 | +``` |
| 273 | +az databoxedge user delete --name "user1" --device-name "testedgedevice" --resource-group "GroupForEdgeAutomation" |
| 274 | +``` |
| 275 | +#### databoxedge sku #### |
| 276 | +##### List ##### |
| 277 | +``` |
| 278 | +az databoxedge sku list |
| 279 | +``` |
0 commit comments