Update documentation

aaronparker · Mar 17, 2024 · 93f0ad7 · 93f0ad7
1 parent c0e1069
commit 93f0ad7
Show file tree

Hide file tree

Showing 17 changed files with 26 additions and 15 deletions.
diff --git a/docs/assets/android-chrome-192x192.png b/docs/assets/android-chrome-192x192.png
diff --git a/docs/assets/android-chrome-384x384.png b/docs/assets/android-chrome-384x384.png
diff --git a/docs/assets/android-chrome-512x512.png b/docs/assets/android-chrome-512x512.png
diff --git a/docs/assets/apple-touch-icon-precomposed.png b/docs/assets/apple-touch-icon-precomposed.png
diff --git a/docs/assets/apple-touch-icon.png b/docs/assets/apple-touch-icon.png
diff --git a/docs/assets/favicon-16x16.png b/docs/assets/favicon-16x16.png
diff --git a/docs/assets/favicon-32x32.png b/docs/assets/favicon-32x32.png
diff --git a/docs/assets/favicon.ico b/docs/assets/favicon.ico
diff --git a/docs/assets/favicon.png b/docs/assets/favicon.png
diff --git a/docs/assets/images/appregistration.jpeg b/docs/assets/images/appregistration.jpeg
diff --git a/docs/assets/mstile-144x144.png b/docs/assets/mstile-144x144.png
diff --git a/docs/assets/mstile-150x150.png b/docs/assets/mstile-150x150.png
diff --git a/docs/assets/mstile-310x150.png b/docs/assets/mstile-310x150.png
diff --git a/docs/assets/mstile-310x310.png b/docs/assets/mstile-310x310.png
diff --git a/docs/assets/mstile-70x70.png b/docs/assets/mstile-70x70.png
diff --git a/docs/assets/safari-pinned-tab.svg b/docs/assets/safari-pinned-tab.svg
diff --git a/docs/import-vcintuneapplication.md b/docs/import-vcintuneapplication.md
@@ -1,8 +1,6 @@
 # Import Redistributables into Microsoft Intune
 
-To install the Visual C++ Redistributables with Microsoft Endpoint Manager / Intune, `Import-VcIntuneApplication` will package each of the Visual C++ Redistributables and import them as a separate application into a target tenant.
-
-Visual C++ Redistributables can be filtered for release and processor architecture by `Get-VcList` and `Save-VcRedist` before passing to `Import-VcIntuneApplication`. The output from `Save-VcRedist` is required, because it includes the `Path` property that is populated with the path to each installer.
+To install the Visual C++ Redistributables with Microsoft Intune, use `Import-VcIntuneApplication` to package each of the Visual C++ Redistributables and import them as a separate application into a target tenant.
 
 An application package will be created for each Visual C++ Redistributable with properties including Name, Description, Publisher, App Version, Information URL, Privacy URL, Notes, Logo, Install command, Uninstall command, Install behavior, Operating system architecture, Minimum operating system, and Detection rules.
 
@@ -17,28 +15,41 @@ Set-PSRepository -Name PSGallery -InstallationPolicy Trusted
 Install-Module -Name VcRedist, IntuneWin32App
 ```
 
-## Parameters
-
-### Required parameters
+## Required parameters
 
 - `VcList` - An array containing details of the Visual C++ Redistributables from `Save-VcRedist`
 
-## Examples
+## Authentication
+
+### Interactive Authentication
+
+Before using `Import-VcIntuneApplication`, you need to authenticate to the Microsoft Intune tenant with `Connect-MSIntuneGraph`. This function is part of the `IntuneWin32App` module, so any supported authentication method can be used.
 
-Authenticate to a target tenant, retrieve the list of Visual C++ Redistributables for the 2022 version, download the installers to `C:\Temp\VcRedist` and imports each Redistributable into the target Intune tenant as separate application.
+For an interactive sign-in that will require credentials for an account with the Intune Administrator role, use this example:
 
 ```powershell
 Connect-MSIntuneGraph -TenantID contoso.onmicrosoft.com
-$Vc = Get-VcList -Release "2022"
-$VcList = Save-VcRedist -VcList $Vc -Path C:\Temp\VcRedist
-Import-VcIntuneApplication -VcList $VcList
 ```
 
-Authenticates to the specified tenant using an Azure AD app registration for non-interactive authentication, retrieves the supported list of Visual C++ Redistributables, downloads them to C:\Temp\VcRedist and imports each Redistributable into the target Intune tenant as separate application.
+### Non-interactive Authentication
+
+An Entra ID app registration can be used for non-interactive authentication. The app registration requires the **DeviceManagementApps.ReadWrite.All** application permission. Create an app registration, assign the permission and enable admin consent. Then use a client secret or client certificate to use with authentication.
+
+![Entra ID app registration for IntuneWin32App](assets/images/appregistration.jpeg)
+
+For a non-interactive sign-in that uses the app registration and a client secret, use this example:
 
 ```powershell
 Connect-MSIntuneGraph -TenantID contoso.onmicrosoft.com -ClientId "f99877d5-f757-438e-b12b-d905b00ea6f3" -ClientSecret <secret>
-Get-VcList | Save-VcRedist | Import-VcIntuneApplication
+```
+
+## Import the Redistributables
+
+The example listing below retrieves the list of Visual C++ Redistributables for the 2022 version, download the installers to `C:\Temp\VcRedist` and imports each Redistributable into the target Intune tenant as separate application.
+
+```powershell
+$VcList = Get-VcList -Release "2022" | Save-VcRedist -Path C:\Temp\VcRedist
+Import-VcIntuneApplication -VcList $VcList
 ```
 
 ![Microsoft Visual C++ Redistributables applications imported into Intune](assets/images/intuneapp.jpeg)
@@ -50,7 +61,7 @@ With the application packages imported, configure assignments with `Add-IntuneWi
 In the example below, the Redistributables imported into Intune will be assigned to all devices.
 
 ```powershell
-$Apps = Get-VcList | Save-VcRedist | Import-VcIntuneApplication
+$Apps = Get-VcList | Save-VcRedist -Path C:\Temp\VcRedist | Import-VcIntuneApplication
 foreach ($App in $Apps) {
     $params = @{
         Id                           = $App.Id