Skip to content

Commit

Permalink
Update docs
Browse files Browse the repository at this point in the history
  • Loading branch information
aaronparker committed Mar 15, 2024
1 parent 9fd5f7d commit 8b2ca9d
Show file tree
Hide file tree
Showing 6 changed files with 18 additions and 8 deletions.
10 changes: 8 additions & 2 deletions docs/get-vclist.md
Original file line number Diff line number Diff line change
Expand Up @@ -82,7 +82,13 @@ SilentUninstall : "%ProgramData%\Package Cache\{b7a2b241-3f54-4d7d-94d1-8ce0146e
UninstallKey : 32
```

Output from `Get-VcList` can be piped to `Save-VcRedist`, `Install-VcRedist`, `Import-VcMdtApplication`, `Update-VcMdtApplication`, `Import-VcConfigMgrApplication` and `Update-VcConfigMgrApplication`. Additionally, output from `Get-VcList` can be filtered using `Where-Object`. This approach is useful where you want to export the full list of Redistributables but filter for specific processor architectures.
Output from `Get-VcList` can be filtered using `Where-Object`. This approach is useful where you want to export the full list of Redistributables but filter for specific processor architectures.

```powershell
Get-VcList -Export All | Where-Object { $_.Architecture -eq "x64" }
```

To pass the list of redistributables to `Install-VcRedist`, `Import-VcMdtApplication`, `Update-VcMdtApplication`, `Import-VcConfigMgrApplication` and `Update-VcConfigMgrApplication`, it must first be passed through `Save-VcRedist`, which will then add a Path property to the object required by the other functions.

## Parameters

Expand All @@ -103,7 +109,7 @@ To return Redistributables from the list of unsupported Redistributables or the

## Filtering Output

The output from `Get-VcList` can be filtered before sending to other functions. `Get-VcList` has the `-Release` parameter for filtering on the `2012`, `2013`, `2015`, `2017`, `2019` and `2022` releases of the Redistributables. Additionally, the `-Architecture` parameter can filter on `x86` and `x64` processor architectures.
The output from `Get-VcList` can be filtered before sending to `Save-VcRedist`. `Get-VcList` has the `-Release` parameter for filtering on the `2012`, `2013`, `2015`, `2017`, `2019` and `2022` releases of the Redistributables. Additionally, the `-Architecture` parameter can filter on `x86` and `x64` processor architectures.

These parameters cannot be used with the `-Export` parameter. If you require filtering when exporting All, Supported or Unsupported Redistributables, pipe the output to the `Where-Object` function. This approach is required where you want to export a list of the unsupported Redistributables.

Expand Down
4 changes: 2 additions & 2 deletions docs/import-vcintuneapplication.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ Install-Module -Name VcRedist, IntuneWin32App

### Required parameters

* `VcList` - An array containing details of the Visual C++ Redistributables from `Save-VcRedist`
- `VcList` - An array containing details of the Visual C++ Redistributables from `Save-VcRedist`

## Examples

Expand Down Expand Up @@ -51,7 +51,7 @@ In the example below, the Redistributables imported into Intune will be assigned

```powershell
$Apps = Get-VcList | Save-VcRedist | Import-VcIntuneApplication
ForEach ($App in $Apps) {
foreach ($App in $Apps) {
$params = @{
Id = $App.Id
Intent = "required"
Expand Down
2 changes: 1 addition & 1 deletion docs/import-vcmdtapplication.md
Original file line number Diff line number Diff line change
Expand Up @@ -41,5 +41,5 @@ The install command line arguments used by default are passive. Fully silent ins

```powershell
$VcList = Get-VcList | Save-VcRedist -Path C:\Temp\VcRedist
Import-VcMdtApp -VcList $VcList -MdtPath \\server\deployment -Silent
Import-VcMdtApplication -VcList $VcList -MdtPath \\server\deployment -Silent
```
2 changes: 1 addition & 1 deletion docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ The Microsoft Visual C++ Redistributables are a core component of any Windows de

The module includes two manifests that list the supported Redistributables or all available Redistributables making it simple to download and deploy the Redistributes required for your environment.

It is important to understand that Microsoft no longer supports and provides security updates for certain Redistributables. The list of supported Redistributables is maintained here [Microsoft Visual C++ Redistributables](https://support.microsoft.com/en-au/help/2977003/the-latest-supported-visual-c-downloads). Deployment of unsupported Redistributables should be done at your own risk.
It is important to note that Microsoft no longer supports and provides security updates for certain Redistributables. The list of supported Redistributables is maintained here [Microsoft Visual C++ Redistributables](https://support.microsoft.com/en-au/help/2977003/the-latest-supported-visual-c-downloads). Deployment of unsupported Redistributables should be done at your own risk.

## Unsupported Redistributables

Expand Down
2 changes: 1 addition & 1 deletion docs/install-vcredist.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ After the Visual C++ Redistributables are installed, the list of installed Visua

## Examples

The following commands will install the default supported Visual C++ Redistributables downloaded locally with `Save-VcRedist` to C:\Temp\VcRedist.
The following commands will install the default supported Visual C++ Redistributables downloaded locally with `Save-VcRedist` to `C:\Temp\VcRedist`.

```powershell
$VcList = Get-VcList | Save-VcRedist -Path C:\Temp\VcRedist
Expand Down
6 changes: 5 additions & 1 deletion docs/save-vcredist.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,11 @@

To download the Visual C++ Redistributables to a local folder, use `Save-VcRedist`. This will read the array of Visual C++ Redistributables returned from `Get-VcList` and download each one to a local folder specified in `-Path`. Use the `-Release` or `-Architecture` parameters in `Get-VcList` to filter for specific Visual C++ Redistributables.

Save-VcRedist downloads the Redistributables and returns the array passed from Get-VcList to the pipeline so that it can be passed to other functions `Install-VcRedist`.
Save-VcRedist downloads the Redistributables and returns the array passed from Get-VcList to the pipeline so that it can be passed to `Install-VcRedist`, `Import-VcMdtApplication`, `Update-VcMdtApplication`, `Import-VcConfigMgrApplication` and `Update-VcConfigMgrApplication`.

!!! info

Save-VcRedist will download the Visual C++ Redistributables the first time it runs against a specified path. Subsequent runs using the same path will use the existing downloaded Redistributables - the installers will not be re-downloaded.

## Parameters

Expand Down

0 comments on commit 8b2ca9d

Please sign in to comment.