Skip to content

Commit 84832a0

Browse files
committed
Update manifest and docs to 6.13.5
1 parent b007c62 commit 84832a0

14 files changed

+92
-92
lines changed

CHANGELOG.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,12 @@
1+
## 6.13.5
2+
- `Import-VcCertificate` updates:
3+
- Fix prompting for VenafiSession even when provided
4+
- Remove `-PKCS8` and `-PKCS12`, and soon `-Format`, in favor of autodetection
5+
- Add `-Recurse` to bring in certificates in subfolders when importing by path
6+
- Add ShouldProcess so `-WhatIf` can be used prior to importing
7+
- ThrottleLimit changed to 1 by default as 100 certs are submitted at a time
8+
- Add PKCS8 support to `Import-VdcCertificate`
9+
110
## 6.13.4
211
- Add `New-VdcCredential` to create a Password, Username Password, or Certificate Credential
312
- Add `Invoke-VcCertificateAction -Application` and `-IssuingTemplate` for use during renewal operations to override existing values from certificate request. The template is optional if only 1 is associated to the application.
@@ -957,5 +966,6 @@ This is a major release. Although every attempt has been made to be backwards c
957966

958967

959968

969+
960970

961971

VenafiPS/VenafiPS.psd1

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
#
44
# Generated by: Greg Brownstein
55
#
6-
# Generated on: 03/23/2026
6+
# Generated on: 03/24/2026
77
#
88

99
@{
@@ -12,7 +12,7 @@
1212
RootModule = 'VenafiPS.psm1'
1313

1414
# Version number of this module.
15-
ModuleVersion = '6.13.4'
15+
ModuleVersion = '6.13.5'
1616

1717
# Supported PSEditions
1818
# CompatiblePSEditions = @()

docs/changelog.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,12 @@
1+
## 6.13.5
2+
- `Import-VcCertificate` updates:
3+
- Fix prompting for VenafiSession even when provided
4+
- Remove `-PKCS8` and `-PKCS12`, and soon `-Format`, in favor of autodetection
5+
- Add `-Recurse` to bring in certificates in subfolders when importing by path
6+
- Add ShouldProcess so `-WhatIf` can be used prior to importing
7+
- ThrottleLimit changed to 1 by default as 100 certs are submitted at a time
8+
- Add PKCS8 support to `Import-VdcCertificate`
9+
110
## 6.13.4
211
- Add `New-VdcCredential` to create a Password, Username Password, or Certificate Credential
312
- Add `Invoke-VcCertificateAction -Application` and `-IssuingTemplate` for use during renewal operations to override existing values from certificate request. The template is optional if only 1 is associated to the application.
@@ -957,5 +966,6 @@ This is a major release. Although every attempt has been made to be backwards c
957966

958967

959968

969+
960970

961971

docs/functions/Import-VcCertificate.md

Lines changed: 58 additions & 78 deletions
Original file line numberDiff line numberDiff line change
@@ -7,31 +7,23 @@ Import one or more certificates
77

88
### ByFile (Default)
99
```
10-
Import-VcCertificate -Path <String> [-PrivateKeyPassword <PSObject>] [-ThrottleLimit <Int32>] [-Force]
11-
[-VenafiSession <PSObject>] [-ProgressAction <ActionPreference>] [<CommonParameters>]
10+
Import-VcCertificate -Path <String> [-PrivateKeyPassword <PSObject>] [-ThrottleLimit <Int32>] [-Recurse]
11+
[-Force] [-VenafiSession <PSObject>] [-ProgressAction <ActionPreference>] [-WhatIf] [-Confirm]
12+
[<CommonParameters>]
1213
```
1314

14-
### Format
15+
### ByData
1516
```
16-
Import-VcCertificate -Data <String> -Format <String> [-PrivateKeyPassword <PSObject>] [-ThrottleLimit <Int32>]
17-
[-Force] [-VenafiSession <PSObject>] [-ProgressAction <ActionPreference>] [<CommonParameters>]
18-
```
19-
20-
### PKCS8
21-
```
22-
Import-VcCertificate -Data <String> [-PKCS8] -PrivateKeyPassword <PSObject> [-ThrottleLimit <Int32>] [-Force]
23-
[-VenafiSession <PSObject>] [-ProgressAction <ActionPreference>] [<CommonParameters>]
24-
```
25-
26-
### PKCS12
27-
```
28-
Import-VcCertificate -Data <String> [-PKCS12] -PrivateKeyPassword <PSObject> [-ThrottleLimit <Int32>] [-Force]
29-
[-VenafiSession <PSObject>] [-ProgressAction <ActionPreference>] [<CommonParameters>]
17+
Import-VcCertificate -Data <String> [-Format <String>] [-PrivateKeyPassword <PSObject>]
18+
[-ThrottleLimit <Int32>] [-Force] [-VenafiSession <PSObject>] [-ProgressAction <ActionPreference>] [-WhatIf]
19+
[-Confirm] [<CommonParameters>]
3020
```
3121

3222
## DESCRIPTION
3323
Import one or more certificates and their private keys.
3424
PKCS8 (.pem), PKCS12 (.pfx or .p12), and X509 (.pem, .cer, or .crt) certificates are supported.
25+
Certificates/keys can be imported from a file or from data provided directly to the function, eg.
26+
exporting from Certificate Manager, Self-Hosted and importing into Certificate Manager, SaaS.
3527

3628
## EXAMPLES
3729

@@ -92,7 +84,7 @@ Provide either this or -Path.
9284
9385
```yaml
9486
Type: String
95-
Parameter Sets: Format, PKCS8, PKCS12
87+
Parameter Sets: ByData
9688
Aliases: certificateData
9789

9890
Required: True
@@ -102,138 +94,126 @@ Accept pipeline input: True (ByPropertyName)
10294
Accept wildcard characters: False
10395
```
10496
105-
### -PKCS8
106-
Provided -Data is in PKCS #8 format.
107-
This parameter will be deprecated in a future release.
108-
Use -Format PKCS8.
109-
110-
```yaml
111-
Type: SwitchParameter
112-
Parameter Sets: PKCS8
113-
Aliases:
114-
115-
Required: True
116-
Position: Named
117-
Default value: False
118-
Accept pipeline input: False
119-
Accept wildcard characters: False
120-
```
97+
### -Format
98+
Specify the format provided in -Data.
99+
PKCS12, PKCS8, and X509 are supported.
121100
122-
### -PKCS12
123-
Provided -Data is in PKCS #12 format
124-
This parameter will be deprecated in a future release.
125-
Use -Format PKCS12.
101+
The format is now automatically detected, so this parameter is not required or used.
126102
127103
```yaml
128-
Type: SwitchParameter
129-
Parameter Sets: PKCS12
104+
Type: String
105+
Parameter Sets: ByData
130106
Aliases:
131107

132-
Required: True
108+
Required: False
133109
Position: Named
134-
Default value: False
110+
Default value: None
135111
Accept pipeline input: False
136112
Accept wildcard characters: False
137113
```
138114
139-
### -Format
140-
Specify the format provided in -Data.
141-
PKCS12, PKCS8, and X509 are supported.
142-
This will replace -PKCS8 and -PKCS12 in a future release.
115+
### -PrivateKeyPassword
116+
Password the private key was encrypted with
143117
144118
```yaml
145-
Type: String
146-
Parameter Sets: Format
119+
Type: PSObject
120+
Parameter Sets: (All)
147121
Aliases:
148122

149-
Required: True
123+
Required: False
150124
Position: Named
151125
Default value: None
152126
Accept pipeline input: True (ByPropertyName)
153127
Accept wildcard characters: False
154128
```
155129
156-
### -PrivateKeyPassword
157-
Password the private key was encrypted with
130+
### -ThrottleLimit
131+
Limit the number of threads when running in parallel; the default is 1.
132+
100 keystores will be imported at a time so it's less important to have a very high throttle limit.
158133
159134
```yaml
160-
Type: PSObject
161-
Parameter Sets: ByFile
135+
Type: Int32
136+
Parameter Sets: (All)
162137
Aliases:
163138

164139
Required: False
165140
Position: Named
166-
Default value: None
141+
Default value: 1
167142
Accept pipeline input: False
168143
Accept wildcard characters: False
169144
```
170145
146+
### -Recurse
147+
When providing a folder path, include subfolders in the search for certificates to import.
148+
171149
```yaml
172-
Type: PSObject
173-
Parameter Sets: Format
150+
Type: SwitchParameter
151+
Parameter Sets: ByFile
174152
Aliases:
175153

176154
Required: False
177155
Position: Named
178-
Default value: None
156+
Default value: False
179157
Accept pipeline input: False
180158
Accept wildcard characters: False
181159
```
182160
161+
### -Force
162+
Force installation of PSSodium if not already installed.
163+
This is required for the import of keys.
164+
183165
```yaml
184-
Type: PSObject
185-
Parameter Sets: PKCS8, PKCS12
166+
Type: SwitchParameter
167+
Parameter Sets: (All)
186168
Aliases:
187169

188-
Required: True
170+
Required: False
189171
Position: Named
190-
Default value: None
172+
Default value: False
191173
Accept pipeline input: False
192174
Accept wildcard characters: False
193175
```
194176
195-
### -ThrottleLimit
196-
Limit the number of threads when running in parallel; the default is 10.
197-
Applicable to PS v7+ only.
198-
100 keystores will be imported at a time so it's less important to have a very high throttle limit.
177+
### -VenafiSession
178+
Authentication for the function.
179+
The value defaults to the script session object $VenafiSession created by New-VenafiSession.
180+
A Certificate Manager, SaaS key can also provided.
199181
200182
```yaml
201-
Type: Int32
183+
Type: PSObject
202184
Parameter Sets: (All)
203185
Aliases:
204186

205187
Required: False
206188
Position: Named
207-
Default value: 10
189+
Default value: (Get-VenafiSession)
208190
Accept pipeline input: False
209191
Accept wildcard characters: False
210192
```
211193
212-
### -Force
213-
Force installation of PSSodium if not already installed.
214-
This is required for the import of keys.
194+
### -WhatIf
195+
Shows what would happen if the cmdlet runs.
196+
The cmdlet is not run.
215197
216198
```yaml
217199
Type: SwitchParameter
218200
Parameter Sets: (All)
219-
Aliases:
201+
Aliases: wi
220202

221203
Required: False
222204
Position: Named
223-
Default value: False
205+
Default value: None
224206
Accept pipeline input: False
225207
Accept wildcard characters: False
226208
```
227209
228-
### -VenafiSession
229-
Authentication for the function.
230-
The value defaults to the script session object $VenafiSession created by New-VenafiSession.
231-
A Certificate Manager, SaaS key can also provided.
210+
### -Confirm
211+
Prompts you for confirmation before running the cmdlet.
232212
233213
```yaml
234-
Type: PSObject
214+
Type: SwitchParameter
235215
Parameter Sets: (All)
236-
Aliases:
216+
Aliases: cf
237217

238218
Required: False
239219
Position: Named

docs/functions/Import-VdcCertificate.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -89,7 +89,7 @@ Accept wildcard characters: False
8989
```
9090
9191
### -Data
92-
Contents of a certificate to import.
92+
Contents of a certificate or certificate/key to import in Base64.
9393
Provide either this or -Path.
9494
9595
```yaml
@@ -159,7 +159,7 @@ Accept wildcard characters: False
159159
### -PrivateKey
160160
Private key data; requires a value for PrivateKeyPassword.
161161
For a PEM certificate, the private key is in either the RSA or PKCS#8 format.
162-
Do not provide for a PKCS#12 certificate as the private key is already included.
162+
Do not provide when the value for -Data is PKCS12 or PKCS8 as the private key is already included.
163163
164164
```yaml
165165
Type: String
@@ -330,7 +330,7 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
330330
331331
## INPUTS
332332
333-
### Path, Data
333+
### Path, Data, PolicyPath, PrivateKeyPassword
334334
## OUTPUTS
335335
336336
### PSCustomObject, if PassThru provided

docs/functions/Invoke-VcWorkflow.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -121,7 +121,7 @@ Aliases:
121121

122122
Required: False
123123
Position: 4
124-
Default value: None
124+
Default value: (Get-VenafiSession)
125125
Accept pipeline input: False
126126
Accept wildcard characters: False
127127
```

docs/functions/New-VcMachine.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -340,7 +340,7 @@ Aliases:
340340

341341
Required: False
342342
Position: Named
343-
Default value: None
343+
Default value: (Get-VenafiSession)
344344
Accept pipeline input: False
345345
Accept wildcard characters: False
346346
```

docs/functions/Remove-VcApplication.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -74,7 +74,7 @@ Aliases:
7474

7575
Required: False
7676
Position: 3
77-
Default value: None
77+
Default value: (Get-VenafiSession)
7878
Accept pipeline input: False
7979
Accept wildcard characters: False
8080
```

docs/functions/Remove-VcIssuingTemplate.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -74,7 +74,7 @@ Aliases:
7474

7575
Required: False
7676
Position: 3
77-
Default value: None
77+
Default value: (Get-VenafiSession)
7878
Accept pipeline input: False
7979
Accept wildcard characters: False
8080
```

docs/functions/Remove-VcMachine.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -74,7 +74,7 @@ Aliases:
7474

7575
Required: False
7676
Position: 3
77-
Default value: None
77+
Default value: (Get-VenafiSession)
7878
Accept pipeline input: False
7979
Accept wildcard characters: False
8080
```

0 commit comments

Comments
 (0)