Compare commits

..

No commits in common. "d4633d4b806b1a601bb7fbe7863426e87cc6e8e0" and "ae62cccfaac0d2a3c3d8b589efd7918c91dd45d4" have entirely different histories.

19 changed files with 2022 additions and 2057 deletions

View File

@ -1,195 +1,194 @@
--- ---
external help file: ModuleRoot-help.xml external help file: PSCredentialStore-help.xml
Module Name: PSCredentialStore Module Name: PSCredentialStore
online version: schema: 2.0.0
schema: 2.0.0 ---
---
# Connect-To
# Connect-To
## SYNOPSIS
## SYNOPSIS Connects to the given host using the stored CredentialStoreItem.
Connects to the given host using the stored CredentialStoreItem.
## SYNTAX
## SYNTAX
### Private (Default)
### Private (Default) ```
``` Connect-To -RemoteHost <String> [-Identifier <String>] -Type <String> [-Credentials <PSCredential>] [-PassThru]
Connect-To -RemoteHost <String> [-Identifier <String>] -Type <String> [-Credentials <PSCredential>] [-PassThru] [<CommonParameters>]
[<CommonParameters>] ```
```
### Shared
### Shared ```
``` Connect-To -RemoteHost <String> [-Identifier <String>] -Type <String> [-Credentials <PSCredential>] [-Shared]
Connect-To -RemoteHost <String> [-Identifier <String>] -Type <String> [-Credentials <PSCredential>] [-Shared] [-Path <String>] [-PassThru] [<CommonParameters>]
[-Path <String>] [-PassThru] [<CommonParameters>] ```
```
## DESCRIPTION
## DESCRIPTION Establish a connection to the selected host using a stored CredentialStoreItem.
Establish a connection to the selected host using a stored CredentialStoreItem.
## EXAMPLES
## EXAMPLES
### EXAMPLE 1
### EXAMPLE 1 ```
``` Connect-To -RemoteHost "ucs.myside.local" -Type CiscoUcs
Connect-To -RemoteHost "ucs.myside.local" -Type CiscoUcs ```
```
### EXAMPLE 2
### EXAMPLE 2 ```
``` Connect-To -RemoteHost "ftp.myside.local" -Type FTP
Connect-To -RemoteHost "ftp.myside.local" -Type FTP ```
```
### EXAMPLE 3
### EXAMPLE 3 ```
``` Connect-To -RemoteHost "fas.myside.local" -Type NetAppFAS
Connect-To -RemoteHost "fas.myside.local" -Type NetAppFAS ```
```
### EXAMPLE 4
### EXAMPLE 4 ```
``` Connect-To -RemoteHost "esx01.myside.local" -Type VMware
Connect-To -RemoteHost "esx01.myside.local" -Type VMware ```
```
### EXAMPLE 5
### EXAMPLE 5 ```
``` Connect-To -RemoteHost "vCenter.myside.local" -Type CisServer
Connect-To -RemoteHost "vCenter.myside.local" -Type CisServer ```
```
### EXAMPLE 6
### EXAMPLE 6 ```
``` Connect-To -RemoteHost "exchange01.myside.local" -Type ExchangeHTTP
Connect-To -RemoteHost "exchange01.myside.local" -Type ExchangeHTTP ```
```
### EXAMPLE 7
### EXAMPLE 7 ```
``` Connect-To -RemoteHost "exchange01.myside.local" -Type ExchangeHTTPS
Connect-To -RemoteHost "exchange01.myside.local" -Type ExchangeHTTPS ```
```
## PARAMETERS
## PARAMETERS
### -Credentials
### -Credentials Use this parameter to bypass the stored credentials.
Use this parameter to bypass the stored credentials. Without this parameter Connect-To tries to read the
Without this parameter Connect-To tries to read the needed credentials from the CredentialStore.
needed credentials from the CredentialStore. If you provide this parameter you skip this lookup behavior.
If you provide this parameter you skip this lookup behavior. So you can use it to enable credentials without preparing any user interaction.
So you can use it to enable credentials without preparing any user interaction.
```yaml
```yaml Type: PSCredential
Type: PSCredential Parameter Sets: (All)
Parameter Sets: (All) Aliases:
Aliases:
Required: False
Required: False Position: Named
Position: Named Default value: None
Default value: None Accept pipeline input: False
Accept pipeline input: False Accept wildcard characters: False
Accept wildcard characters: False ```
```
### -Identifier
### -Identifier Defaults to "".
Defaults to "". Specify a string, which separates two CredentialStoreItems for the
Specify a string, which separates two CredentialStoreItems for the same hostname.
same hostname.
```yaml
```yaml Type: String
Type: String Parameter Sets: (All)
Parameter Sets: (All) Aliases:
Aliases:
Required: False
Required: False Position: Named
Position: Named Default value: None
Default value: None Accept pipeline input: False
Accept pipeline input: False Accept wildcard characters: False
Accept wildcard characters: False ```
```
### -PassThru
### -PassThru Returns the value from the underlying connection type function.
Returns the value from the underlying connection type function.
```yaml
```yaml Type: SwitchParameter
Type: SwitchParameter Parameter Sets: (All)
Parameter Sets: (All) Aliases:
Aliases:
Required: False
Required: False Position: Named
Position: Named Default value: False
Default value: False Accept pipeline input: False
Accept pipeline input: False Accept wildcard characters: False
Accept wildcard characters: False ```
```
### -Path
### -Path Define a custom path to a shared CredentialStore.
Define a custom path to a shared CredentialStore.
```yaml
```yaml Type: String
Type: String Parameter Sets: Shared
Parameter Sets: Shared Aliases:
Aliases:
Required: False
Required: False Position: Named
Position: Named Default value: None
Default value: None Accept pipeline input: False
Accept pipeline input: False Accept wildcard characters: False
Accept wildcard characters: False ```
```
### -RemoteHost
### -RemoteHost Specify the host, for which you would like to change the credentials.
Specify the host, for which you would like to change the credentials.
```yaml
```yaml Type: String
Type: String Parameter Sets: (All)
Parameter Sets: (All) Aliases:
Aliases:
Required: True
Required: True Position: Named
Position: Named Default value: None
Default value: None Accept pipeline input: False
Accept pipeline input: False Accept wildcard characters: False
Accept wildcard characters: False ```
```
### -Shared
### -Shared Switch to shared mode with this param.
Switch to shared mode with this param. This enforces the command to work with a shared CredentialStore which
This enforces the command to work with a shared CredentialStore which can be decrypted across systems.
can be decrypted across systems.
```yaml
```yaml Type: SwitchParameter
Type: SwitchParameter Parameter Sets: Shared
Parameter Sets: Shared Aliases:
Aliases:
Required: True
Required: True Position: Named
Position: Named Default value: False
Default value: False Accept pipeline input: False
Accept pipeline input: False Accept wildcard characters: False
Accept wildcard characters: False ```
```
### -Type
### -Type Specify the host type of the target.
Specify the host type of the target. Currently implemented targets are: Possible connection values are:
Currently implemented targets are: Possible connection values are: CiscoUcs, FTP, NetAppFAS, VMware, CisServer, ExchangeHTTP, ExchangeHTTPS, SCP.
CiscoUcs, FTP, NetAppFAS, VMware, CisServer, ExchangeHTTP, ExchangeHTTPS, SCP.
```yaml
```yaml Type: String
Type: String Parameter Sets: (All)
Parameter Sets: (All) Aliases:
Aliases:
Required: True
Required: True Position: Named
Position: Named Default value: None
Default value: None Accept pipeline input: False
Accept pipeline input: False Accept wildcard characters: False
Accept wildcard characters: False ```
```
### CommonParameters
### CommonParameters This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
## INPUTS
## INPUTS
### [None]
### [None] ## OUTPUTS
## OUTPUTS
### [None]
### [None] ## NOTES
## NOTES
## RELATED LINKS
## RELATED LINKS

View File

@ -1,124 +1,123 @@
--- ---
external help file: ModuleRoot-help.xml external help file: PSCredentialStore-help.xml
Module Name: PSCredentialStore Module Name: PSCredentialStore
online version: schema: 2.0.0
schema: 2.0.0 ---
---
# Disconnect-From
# Disconnect-From
## SYNOPSIS
## SYNOPSIS Terminates a session established with Connect-To using a CredentialStoreItem.
Terminates a session established with Connect-To using a CredentialStoreItem.
## SYNTAX
## SYNTAX
```
``` Disconnect-From [-RemoteHost] <String> [-Type] <String> [-Force] [<CommonParameters>]
Disconnect-From [-RemoteHost] <String> [-Type] <String> [-Force] [<CommonParameters>] ```
```
## DESCRIPTION
## DESCRIPTION Terminates a session established with Connect-To using a CredentialStoreItem.
Terminates a session established with Connect-To using a CredentialStoreItem.
## EXAMPLES
## EXAMPLES
### EXAMPLE 1
### EXAMPLE 1 ```
``` Disconnect-From -RemoteHost "ucs.myside.local" -Type CiscoUcs
Disconnect-From -RemoteHost "ucs.myside.local" -Type CiscoUcs ```
```
### EXAMPLE 2
### EXAMPLE 2 ```
``` Disconnect-From -RemoteHost "ftp.myside.local" -Type FTP
Disconnect-From -RemoteHost "ftp.myside.local" -Type FTP ```
```
### EXAMPLE 3
### EXAMPLE 3 ```
``` Disconnect-From -RemoteHost "fas.myside.local" -Type NetAppFAS
Disconnect-From -RemoteHost "fas.myside.local" -Type NetAppFAS ```
```
### EXAMPLE 4
### EXAMPLE 4 ```
``` Disconnect-From -RemoteHost "esx01.myside.local" -Type VMware
Disconnect-From -RemoteHost "esx01.myside.local" -Type VMware ```
```
### EXAMPLE 5
### EXAMPLE 5 ```
``` Disconnect-From -RemoteHost "esx01.myside.local" -Type VMware -Force:$True
Disconnect-From -RemoteHost "esx01.myside.local" -Type VMware -Force:$True ```
```
### EXAMPLE 6
### EXAMPLE 6 ```
``` Disconnect-From -RemoteHost "vcenter.myside.local" -Type CisServer
Disconnect-From -RemoteHost "vcenter.myside.local" -Type CisServer ```
```
### EXAMPLE 7
### EXAMPLE 7 ```
``` Disconnect-From -RemoteHost "exchange01.myside.local" -Type ExchangeHTTP
Disconnect-From -RemoteHost "exchange01.myside.local" -Type ExchangeHTTP ```
```
### EXAMPLE 8
### EXAMPLE 8 ```
``` Disconnect-From -RemoteHost "exchange01.myside.local" -Type ExchangeHTTPS
Disconnect-From -RemoteHost "exchange01.myside.local" -Type ExchangeHTTPS ```
```
## PARAMETERS
## PARAMETERS
### -Force
### -Force Force the disconnect, even if the disconnect would fail.
Force the disconnect, even if the disconnect would fail.
```yaml
```yaml Type: SwitchParameter
Type: SwitchParameter Parameter Sets: (All)
Parameter Sets: (All) Aliases:
Aliases:
Required: False
Required: False Position: Named
Position: Named Default value: False
Default value: False Accept pipeline input: False
Accept pipeline input: False Accept wildcard characters: False
Accept wildcard characters: False ```
```
### -RemoteHost
### -RemoteHost Specify the remote endpoint, whose session you would like to terminate.
Specify the remote endpoint, whose session you would like to terminate.
```yaml
```yaml Type: String
Type: String Parameter Sets: (All)
Parameter Sets: (All) Aliases:
Aliases:
Required: True
Required: True Position: 1
Position: 1 Default value: None
Default value: None Accept pipeline input: False
Accept pipeline input: False Accept wildcard characters: False
Accept wildcard characters: False ```
```
### -Type
### -Type Specify the host type of the target.
Specify the host type of the target. Currently implemented targets are: CiscoUcs, FTP, NetAppFAS, VMware,
Currently implemented targets are: CiscoUcs, FTP, NetAppFAS, VMware, CisServer, ExchangeHTTP, ExchangeHTTPS, SCP.
CisServer, ExchangeHTTP, ExchangeHTTPS, SCP.
```yaml
```yaml Type: String
Type: String Parameter Sets: (All)
Parameter Sets: (All) Aliases:
Aliases:
Required: True
Required: True Position: 2
Position: 2 Default value: None
Default value: None Accept pipeline input: False
Accept pipeline input: False Accept wildcard characters: False
Accept wildcard characters: False ```
```
### CommonParameters
### CommonParameters This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
## INPUTS
## INPUTS
### [None]
### [None] ## OUTPUTS
## OUTPUTS
### [None]
### [None] ## NOTES
## NOTES
## RELATED LINKS
## RELATED LINKS

View File

@ -1,72 +1,71 @@
--- ---
external help file: ModuleRoot-help.xml external help file: PSCredentialStore-help.xml
Module Name: PSCredentialStore Module Name: PSCredentialStore
online version: schema: 2.0.0
schema: 2.0.0 ---
---
# Get-CSCertificate
# Get-CSCertificate
## SYNOPSIS
## SYNOPSIS Returns the current used valid PfX certificate.
Returns the current used valid PfX certificate.
## SYNTAX
## SYNTAX
```
``` Get-CSCertificate [-Type] <String> [-Thumbprint] <String> [<CommonParameters>]
Get-CSCertificate [-Type] <String> [-Thumbprint] <String> [<CommonParameters>] ```
```
## DESCRIPTION
## DESCRIPTION Use this function to get the available pfx certificate respecting the config hierarchy.
Use this function to get the available pfx certificate respecting the config hierarchy.
## EXAMPLES
## EXAMPLES
### EXAMPLE 1
### EXAMPLE 1 ```
``` Get-CSCertificate -Type 'Shared' -Thumbprint '12334456'
Get-CSCertificate -Type 'Shared' -Thumbprint '12334456' ```
```
## PARAMETERS
## PARAMETERS
### -Thumbprint
### -Thumbprint Provide the credentials thumbprint for the search.
Provide the credentials thumbprint for the search.
```yaml
```yaml Type: String
Type: String Parameter Sets: (All)
Parameter Sets: (All) Aliases:
Aliases:
Required: True
Required: True Position: 2
Position: 2 Default value: None
Default value: None Accept pipeline input: False
Accept pipeline input: False Accept wildcard characters: False
Accept wildcard characters: False ```
```
### -Type
### -Type Select the current credential store type.
Select the current credential store type.
```yaml
```yaml Type: String
Type: String Parameter Sets: (All)
Parameter Sets: (All) Aliases:
Aliases:
Required: True
Required: True Position: 1
Position: 1 Default value: None
Default value: None Accept pipeline input: False
Accept pipeline input: False Accept wildcard characters: False
Accept wildcard characters: False ```
```
### CommonParameters
### CommonParameters This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
## INPUTS
## INPUTS
### [None]
### [None] ## OUTPUTS
## OUTPUTS
### [System.Security.Cryptography.X509Certificates.X509Certificate2]
### [System.Security.Cryptography.X509Certificates.X509Certificate2] ## NOTES
## NOTES
## RELATED LINKS
## RELATED LINKS

View File

@ -1,84 +1,83 @@
--- ---
external help file: ModuleRoot-help.xml external help file: PSCredentialStore-help.xml
Module Name: PSCredentialStore Module Name: PSCredentialStore
online version: schema: 2.0.0
schema: 2.0.0 ---
---
# Get-CredentialStore
# Get-CredentialStore
## SYNOPSIS
## SYNOPSIS Reads the complete content of the credential store and returns it as a new object.
Reads the complete content of the credential store and returns it as a new object.
## SYNTAX
## SYNTAX
### Private (Default)
### Private (Default) ```
``` Get-CredentialStore [<CommonParameters>]
Get-CredentialStore [<CommonParameters>] ```
```
### Shared
### Shared ```
``` Get-CredentialStore [-Path <String>] [-Shared] [<CommonParameters>]
Get-CredentialStore [-Path <String>] [-Shared] [<CommonParameters>] ```
```
## DESCRIPTION
## DESCRIPTION The content is in a raw format.
The content is in a raw format. It means there is no transformation to the different credential types.
It means there is no transformation to the different credential types. You can not use the object properties to connect with remote host.
You can not use the object properties to connect with remote host. Therefore please use
Therefore please use Get-CredentialStoreItem.
Get-CredentialStoreItem.
## EXAMPLES
## EXAMPLES
### EXAMPLE 1
### EXAMPLE 1 ```
``` $CSContent = Get-CredentialStore -Path "C:\TMP\mystore.json"
$CSContent = Get-CredentialStore -Path "C:\TMP\mystore.json" ```
```
## PARAMETERS
## PARAMETERS
### -Path
### -Path Define a custom path to a shared CredentialStore.
Define a custom path to a shared CredentialStore.
```yaml
```yaml Type: String
Type: String Parameter Sets: Shared
Parameter Sets: Shared Aliases:
Aliases:
Required: False
Required: False Position: Named
Position: Named Default value: None
Default value: None Accept pipeline input: False
Accept pipeline input: False Accept wildcard characters: False
Accept wildcard characters: False ```
```
### -Shared
### -Shared Switch to shared mode with this param.
Switch to shared mode with this param. This enforces the command to work with a shared CredentialStore which
This enforces the command to work with a shared CredentialStore which can be decrypted across systems.
can be decrypted across systems.
```yaml
```yaml Type: SwitchParameter
Type: SwitchParameter Parameter Sets: Shared
Parameter Sets: Shared Aliases:
Aliases:
Required: True
Required: True Position: Named
Position: Named Default value: False
Default value: False Accept pipeline input: False
Accept pipeline input: False Accept wildcard characters: False
Accept wildcard characters: False ```
```
### CommonParameters
### CommonParameters This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
## INPUTS
## INPUTS
### [None]
### [None] ## OUTPUTS
## OUTPUTS
### [PSObject] Returns the credential store content as PSObject.
### [PSObject] Returns the credential store content as PSObject. ## NOTES
## NOTES
## RELATED LINKS
## RELATED LINKS

View File

@ -1,114 +1,113 @@
--- ---
external help file: ModuleRoot-help.xml external help file: PSCredentialStore-help.xml
Module Name: PSCredentialStore Module Name: PSCredentialStore
online version: schema: 2.0.0
schema: 2.0.0 ---
---
# Get-CredentialStoreItem
# Get-CredentialStoreItem
## SYNOPSIS
## SYNOPSIS Returns the Credential from a given remote host item.
Returns the Credential from a given remote host item.
## SYNTAX
## SYNTAX
### Private (Default)
### Private (Default) ```
``` Get-CredentialStoreItem -RemoteHost <String> [-Identifier <String>] [<CommonParameters>]
Get-CredentialStoreItem -RemoteHost <String> [-Identifier <String>] [<CommonParameters>] ```
```
### Shared
### Shared ```
``` Get-CredentialStoreItem -RemoteHost <String> [-Identifier <String>] [-Shared] [-Path <String>]
Get-CredentialStoreItem -RemoteHost <String> [-Identifier <String>] [-Shared] [-Path <String>] [<CommonParameters>]
[<CommonParameters>] ```
```
## DESCRIPTION
## DESCRIPTION Return the credential as PSCredential object.
Return the credential as PSCredential object.
## EXAMPLES
## EXAMPLES
### EXAMPLE 1
### EXAMPLE 1 ```
``` $myCreds = Get-CredentialStoreItem -Path "C:\TMP\mystore.json" -RemoteHost "esx01.myside.local"
$myCreds = Get-CredentialStoreItem -Path "C:\TMP\mystore.json" -RemoteHost "esx01.myside.local" ```
```
## PARAMETERS
## PARAMETERS
### -Identifier
### -Identifier Provide a custom identifier to the given remote host key.
Provide a custom identifier to the given remote host key. This enables you to store multiple credentials
This enables you to store multiple credentials for a single remote host entry.
for a single remote host entry. For example ad/sys1, ftp/sys1, mssql/sys1
For example ad/sys1, ftp/sys1, mssql/sys1
```yaml
```yaml Type: String
Type: String Parameter Sets: (All)
Parameter Sets: (All) Aliases:
Aliases:
Required: False
Required: False Position: Named
Position: Named Default value: None
Default value: None Accept pipeline input: False
Accept pipeline input: False Accept wildcard characters: False
Accept wildcard characters: False ```
```
### -Path
### -Path Define a custom path to a shared CredentialStore.
Define a custom path to a shared CredentialStore.
```yaml
```yaml Type: String
Type: String Parameter Sets: Shared
Parameter Sets: Shared Aliases:
Aliases:
Required: False
Required: False Position: Named
Position: Named Default value: None
Default value: None Accept pipeline input: False
Accept pipeline input: False Accept wildcard characters: False
Accept wildcard characters: False ```
```
### -RemoteHost
### -RemoteHost Specify the host, for which you would like to change the credentials.
Specify the host, for which you would like to change the credentials.
```yaml
```yaml Type: String
Type: String Parameter Sets: (All)
Parameter Sets: (All) Aliases:
Aliases:
Required: True
Required: True Position: Named
Position: Named Default value: None
Default value: None Accept pipeline input: False
Accept pipeline input: False Accept wildcard characters: False
Accept wildcard characters: False ```
```
### -Shared
### -Shared Switch to shared mode with this param.
Switch to shared mode with this param. This enforces the command to work with a shared CredentialStore which
This enforces the command to work with a shared CredentialStore which can be decrypted across systems.
can be decrypted across systems.
```yaml
```yaml Type: SwitchParameter
Type: SwitchParameter Parameter Sets: Shared
Parameter Sets: Shared Aliases:
Aliases:
Required: True
Required: True Position: Named
Position: Named Default value: False
Default value: False Accept pipeline input: False
Accept pipeline input: False Accept wildcard characters: False
Accept wildcard characters: False ```
```
### CommonParameters
### CommonParameters This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
## INPUTS
## INPUTS
### [None]
### [None] ## OUTPUTS
## OUTPUTS
### [System.Management.Automation.PSCredential]
### [System.Management.Automation.PSCredential] ## NOTES
## NOTES
## RELATED LINKS
## RELATED LINKS

View File

@ -1,73 +1,72 @@
--- ---
external help file: ModuleRoot-help.xml external help file: PSCredentialStore-help.xml
Module Name: PSCredentialStore Module Name: PSCredentialStore
online version: schema: 2.0.0
schema: 2.0.0 ---
---
# Import-CSCertificate
# Import-CSCertificate
## SYNOPSIS
## SYNOPSIS Imports a linked certificate to the valid store location.
Imports a linked certificate to the valid store location.
## SYNTAX
## SYNTAX
```
``` Import-CSCertificate [-Type] <String> [-Path] <FileInfo> [<CommonParameters>]
Import-CSCertificate [-Type] <String> [-Path] <FileInfo> [<CommonParameters>] ```
```
## DESCRIPTION
## DESCRIPTION Import-CSCertificate takes a pfx certificate file and imports it to the supposed certificate store for
Import-CSCertificate takes a pfx certificate file and imports it to the supposed certificate store for private and shared credential stores.
private and shared credential stores.
## EXAMPLES
## EXAMPLES
### EXAMPLE 1
### EXAMPLE 1 ```
``` Import-CSCertificate -Type 'Private' -Path (Join-Path -Path $Env:APPDATA -ChildItem 'PfxCertificate.pfx')
Import-CSCertificate -Type 'Private' -Path (Join-Path -Path $Env:APPDATA -ChildItem 'PfxCertificate.pfx') ```
```
## PARAMETERS
## PARAMETERS
### -Path
### -Path Provide a valid path to pfx certificate file.
Provide a valid path to pfx certificate file.
```yaml
```yaml Type: FileInfo
Type: FileInfo Parameter Sets: (All)
Parameter Sets: (All) Aliases:
Aliases:
Required: True
Required: True Position: 2
Position: 2 Default value: None
Default value: None Accept pipeline input: False
Accept pipeline input: False Accept wildcard characters: False
Accept wildcard characters: False ```
```
### -Type
### -Type Select between the a private and shared credential store.
Select between the a private and shared credential store.
```yaml
```yaml Type: String
Type: String Parameter Sets: (All)
Parameter Sets: (All) Aliases:
Aliases:
Required: True
Required: True Position: 1
Position: 1 Default value: None
Default value: None Accept pipeline input: False
Accept pipeline input: False Accept wildcard characters: False
Accept wildcard characters: False ```
```
### CommonParameters
### CommonParameters This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
## INPUTS
## INPUTS
### [None]
### [None] ## OUTPUTS
## OUTPUTS
### [None]
### [None] ## NOTES
## NOTES
## RELATED LINKS
## RELATED LINKS

View File

@ -1,156 +1,147 @@
--- ---
external help file: ModuleRoot-help.xml external help file: PSCredentialStore-help.xml
Module Name: PSCredentialStore Module Name: PSCredentialStore
online version: schema: 2.0.0
schema: 2.0.0 ---
---
# New-CSCertAttribute
# New-CSCertAttribute
## SYNOPSIS
## SYNOPSIS Creates required data for a certificate signing request.
Creates required data for a certificate signing request.
## SYNTAX
## SYNTAX
```
``` New-CSCertAttribute [-Country] <String> [-State] <String> [-City] <String> [-Organization] <String>
New-CSCertAttribute [-Country] <String> [-State] <String> [-City] <String> [-Organization] <String> [-OrganizationalUnitName] <String> [-CommonName] <String> [[-Days] <Int32>] [<CommonParameters>]
[-OrganizationalUnitName] <String> [-CommonName] <String> [[-Days] <Int32>] [<CommonParameters>] ```
```
## DESCRIPTION
## DESCRIPTION Defines the certificate related properties for an upcoming New-PfxCertificate execution.
Defines the certificate related properties for an upcoming New-PfxCertificate execution.
## EXAMPLES
## EXAMPLES
### EXAMPLE 1
### EXAMPLE 1 ```
``` New-CSCertAttribute -Country 'DE' -State 'BW' -City 'Karlsruhe' -Organization 'AwesomeIT' -OrganizationalUnitName '' -CommonName 'MyPrivateCert'
$AttribParams = @{ ```
Country = 'DE'
State = 'BW' ## PARAMETERS
City = 'Karlsruhe'
Organization ='AwesomeIT' ### -City
OrganizationalUnitName ='PSCredentialStore' Certificate city value.
CommonName ='MyPrivateCert'
} ```yaml
New-CSCertAttribute @AttribParams Type: String
``` Parameter Sets: (All)
Aliases:
## PARAMETERS
Required: True
### -City Position: 3
Certificate city value. Default value: None
Accept pipeline input: False
```yaml Accept wildcard characters: False
Type: String ```
Parameter Sets: (All)
Aliases: ### -CommonName
The certificate common name.
Required: True
Position: 3 ```yaml
Default value: None Type: String
Accept pipeline input: False Parameter Sets: (All)
Accept wildcard characters: False Aliases:
```
Required: True
### -CommonName Position: 6
The certificate common name. Default value: None
Accept pipeline input: False
```yaml Accept wildcard characters: False
Type: String ```
Parameter Sets: (All)
Aliases: ### -Country
County code like EN, DE, IT, FR...
Required: True
Position: 6 ```yaml
Default value: None Type: String
Accept pipeline input: False Parameter Sets: (All)
Accept wildcard characters: False Aliases:
```
Required: True
### -Country Position: 1
County code like EN, DE, IT, FR... Default value: None
Accept pipeline input: False
```yaml Accept wildcard characters: False
Type: String ```
Parameter Sets: (All)
Aliases: ### -Days
The validation time itself.
Required: True
Position: 1 ```yaml
Default value: None Type: Int32
Accept pipeline input: False Parameter Sets: (All)
Accept wildcard characters: False Aliases:
```
Required: False
### -Days Position: 7
The validation time itself. Default value: 365
Accept pipeline input: False
```yaml Accept wildcard characters: False
Type: Int32 ```
Parameter Sets: (All)
Aliases: ### -Organization
Certificate organization value.
Required: False
Position: 7 ```yaml
Default value: 365 Type: String
Accept pipeline input: False Parameter Sets: (All)
Accept wildcard characters: False Aliases:
```
Required: True
### -Organization Position: 4
Certificate organization value. Default value: None
Accept pipeline input: False
```yaml Accept wildcard characters: False
Type: String ```
Parameter Sets: (All)
Aliases: ### -OrganizationalUnitName
Certificate OrganizationalUnitName value.
Required: True
Position: 4 ```yaml
Default value: None Type: String
Accept pipeline input: False Parameter Sets: (All)
Accept wildcard characters: False Aliases:
```
Required: True
### -OrganizationalUnitName Position: 5
Certificate OrganizationalUnitName value. Default value: None
Accept pipeline input: False
```yaml Accept wildcard characters: False
Type: String ```
Parameter Sets: (All)
Aliases: ### -State
Certificate state value.
Required: True
Position: 5 ```yaml
Default value: None Type: String
Accept pipeline input: False Parameter Sets: (All)
Accept wildcard characters: False Aliases:
```
Required: True
### -State Position: 2
Certificate state value. Default value: None
Accept pipeline input: False
```yaml Accept wildcard characters: False
Type: String ```
Parameter Sets: (All)
Aliases: ### CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
Required: True
Position: 2 ## INPUTS
Default value: None
Accept pipeline input: False ### [None]
Accept wildcard characters: False ## OUTPUTS
```
### [PSCredentialStore.Certificate.CSRDetails]
### CommonParameters ## NOTES
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
## RELATED LINKS
## INPUTS
### [None]
## OUTPUTS
### [PSCredentialStore.Certificate.CSRDetails]
## NOTES
## RELATED LINKS

View File

@ -1,121 +1,120 @@
--- ---
external help file: ModuleRoot-help.xml external help file: PSCredentialStore-help.xml
Module Name: PSCredentialStore Module Name: PSCredentialStore
online version: schema: 2.0.0
schema: 2.0.0 ---
---
# New-CSCertificate
# New-CSCertificate
## SYNOPSIS
## SYNOPSIS Creates a new PFX certificate for the CredentialStore encryption.
Creates a new PFX certificate for the CredentialStore encryption.
## SYNTAX
## SYNTAX
```
``` New-CSCertificate [-CRTAttribute] <Object> [[-KeyName] <String>] [[-CertName] <String>] [-WhatIf] [-Confirm]
New-CSCertificate [-CRTAttribute] <Object> [[-KeyName] <String>] [[-CertName] <String>] [-WhatIf] [-Confirm] [<CommonParameters>]
[<CommonParameters>] ```
```
## DESCRIPTION
## DESCRIPTION Use this function to create a custom self signed certificate used by the PSCredentialStore module.
Use this function to create a custom self signed certificate used by the PSCredentialStore module.
## EXAMPLES
## EXAMPLES
### EXAMPLE 1
### EXAMPLE 1 ```
``` New-CSCertificate -CRTAttribute $CRTAttribute -KeyName './myprivate.key' -CertName './mycert.pfx'
New-CSCertificate -CRTAttribute $CRTAttribute -KeyName './myprivate.key' -CertName './mycert.pfx' ```
```
## PARAMETERS
## PARAMETERS
### -CertName
### -CertName Provide a custom full path and name for the PFX certificate file.
Provide a custom full path and name for the PFX certificate file. The file extension has to be \`*.pfx\`
The file extension has to be \`*.pfx\`
```yaml
```yaml Type: String
Type: String Parameter Sets: (All)
Parameter Sets: (All) Aliases:
Aliases:
Required: False
Required: False Position: 3
Position: 3 Default value: ./certificate.pfx
Default value: ./certificate.pfx Accept pipeline input: False
Accept pipeline input: False Accept wildcard characters: False
Accept wildcard characters: False ```
```
### -CRTAttribute
### -CRTAttribute Provide certificate related attributes provided by function New-CRTAttribute.
Provide certificate related attributes provided by function New-CRTAttribute.
```yaml
```yaml Type: Object
Type: Object Parameter Sets: (All)
Parameter Sets: (All) Aliases:
Aliases:
Required: True
Required: True Position: 1
Position: 1 Default value: None
Default value: None Accept pipeline input: True (ByValue)
Accept pipeline input: True (ByValue) Accept wildcard characters: False
Accept wildcard characters: False ```
```
### -KeyName
### -KeyName Provide a custom full path and name for the private key.
Provide a custom full path and name for the private key. The file extension has to be \`*.key\`.
The file extension has to be \`*.key\`.
```yaml
```yaml Type: String
Type: String Parameter Sets: (All)
Parameter Sets: (All) Aliases:
Aliases:
Required: False
Required: False Position: 2
Position: 2 Default value: ./private.key
Default value: ./private.key Accept pipeline input: False
Accept pipeline input: False Accept wildcard characters: False
Accept wildcard characters: False ```
```
### -Confirm
### -Confirm Prompts you for confirmation before running the cmdlet.
Prompts you for confirmation before running the cmdlet.
```yaml
```yaml Type: SwitchParameter
Type: SwitchParameter Parameter Sets: (All)
Parameter Sets: (All) Aliases: cf
Aliases: cf
Required: False
Required: False Position: Named
Position: Named Default value: None
Default value: None Accept pipeline input: False
Accept pipeline input: False Accept wildcard characters: False
Accept wildcard characters: False ```
```
### -WhatIf
### -WhatIf Shows what would happen if the cmdlet runs.
Shows what would happen if the cmdlet runs. The cmdlet is not run.
The cmdlet is not run.
```yaml
```yaml Type: SwitchParameter
Type: SwitchParameter Parameter Sets: (All)
Parameter Sets: (All) Aliases: wi
Aliases: wi
Required: False
Required: False Position: Named
Position: Named Default value: None
Default value: None Accept pipeline input: False
Accept pipeline input: False Accept wildcard characters: False
Accept wildcard characters: False ```
```
### CommonParameters
### CommonParameters This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
## INPUTS
## INPUTS
### [PSCredentialStore.Certificate.Attribute]
### [PSCredentialStore.Certificate.Attribute] ## OUTPUTS
## OUTPUTS
### [None]
### [None] ## NOTES
## NOTES
## RELATED LINKS
## RELATED LINKS

View File

@ -1,203 +1,202 @@
--- ---
external help file: ModuleRoot-help.xml external help file: PSCredentialStore-help.xml
Module Name: PSCredentialStore Module Name: PSCredentialStore
online version: schema: 2.0.0
schema: 2.0.0 ---
---
# New-CredentialStore
# New-CredentialStore
## SYNOPSIS
## SYNOPSIS Creates a new credential store File
Creates a new credential store File
## SYNTAX
## SYNTAX
### Private (Default)
### Private (Default) ```
``` New-CredentialStore [-Force] [-PassThru] [-SkipPFXCertCreation] [-UseCertStore] [-WhatIf] [-Confirm]
New-CredentialStore [-Force] [-PassThru] [-SkipPFXCertCreation] [-UseCertStore] [-WhatIf] [-Confirm] [<CommonParameters>]
[<CommonParameters>] ```
```
### Shared
### Shared ```
``` New-CredentialStore [-Shared] [-Path <FileInfo>] [-Force] [-PassThru] [-SkipPFXCertCreation] [-UseCertStore]
New-CredentialStore [-Shared] [-Path <FileInfo>] [-Force] [-PassThru] [-SkipPFXCertCreation] [-UseCertStore] [-WhatIf] [-Confirm] [<CommonParameters>]
[-WhatIf] [-Confirm] [<CommonParameters>] ```
```
## DESCRIPTION
## DESCRIPTION You need to run this script first to create a new credential store before you try to
You need to run this script first to create a new credential store before you try to save new credentials with New-CredentialStoreItem.
save new credentials with New-CredentialStoreItem.
## EXAMPLES
## EXAMPLES
### EXAMPLE 1
### EXAMPLE 1 ```
``` New-CredentialStore
New-CredentialStore # Creates a new private CredentialStore
# Creates a new private CredentialStore ```
```
### EXAMPLE 2
### EXAMPLE 2 ```
``` New-CredentialStore -Force
New-CredentialStore -Force # Resets an existing private CredentialStore
# Resets an existing private CredentialStore ```
```
### EXAMPLE 3
### EXAMPLE 3 ```
``` New-CredentialStore -Shared
New-CredentialStore -Shared # Creates a new shared CredentialStore
# Creates a new shared CredentialStore ```
```
### EXAMPLE 4
### EXAMPLE 4 ```
``` New-CredentialStore -Shared -Path "C:\TMP\CredentialStore.json"
New-CredentialStore -Shared -Path "C:\TMP\CredentialStore.json" # Creates a new shared CredentialStore in the given location.
# Creates a new shared CredentialStore in the given location. ```
```
## PARAMETERS
## PARAMETERS
### -Force
### -Force Use this switch to reset an existing store.
Use this switch to reset an existing store. The complete content will be wiped.
The complete content will be wiped.
```yaml
```yaml Type: SwitchParameter
Type: SwitchParameter Parameter Sets: (All)
Parameter Sets: (All) Aliases:
Aliases:
Required: False
Required: False Position: Named
Position: Named Default value: False
Default value: False Accept pipeline input: False
Accept pipeline input: False Accept wildcard characters: False
Accept wildcard characters: False ```
```
### -PassThru
### -PassThru {{ Fill PassThru Description }}
{{ Fill PassThru Description }}
```yaml
```yaml Type: SwitchParameter
Type: SwitchParameter Parameter Sets: (All)
Parameter Sets: (All) Aliases:
Aliases:
Required: False
Required: False Position: Named
Position: Named Default value: False
Default value: False Accept pipeline input: False
Accept pipeline input: False Accept wildcard characters: False
Accept wildcard characters: False ```
```
### -Path
### -Path Define a location for the new shared CredentialStore.
Define a location for the new shared CredentialStore. The default store will be created in
The default store will be created in $Env:ProgramData\PSCredentialStore dir.
$Env:ProgramData\PSCredentialStore dir.
```yaml
```yaml Type: FileInfo
Type: FileInfo Parameter Sets: Shared
Parameter Sets: Shared Aliases:
Aliases:
Required: False
Required: False Position: Named
Position: Named Default value: None
Default value: None Accept pipeline input: False
Accept pipeline input: False Accept wildcard characters: False
Accept wildcard characters: False ```
```
### -Shared
### -Shared Creates a CredentialStore in the Shared mode.
Creates a CredentialStore in the Shared mode. This enables you to read the CredentialStore Items on
This enables you to read the CredentialStore Items on different systems or profiles.
different systems or profiles. In addition you can optionally provide a custom path wit the -Path parameter.
In addition you can optionally provide a custom path wit the -Path parameter.
```yaml
```yaml Type: SwitchParameter
Type: SwitchParameter Parameter Sets: Shared
Parameter Sets: Shared Aliases:
Aliases:
Required: True
Required: True Position: Named
Position: Named Default value: False
Default value: False Accept pipeline input: False
Accept pipeline input: False Accept wildcard characters: False
Accept wildcard characters: False ```
```
### -SkipPFXCertCreation
### -SkipPFXCertCreation You can skip the pfx certificate creation process.
You can skip the pfx certificate creation process. This makes sense if you have a previously created cert or want to
This makes sense if you have a previously created cert import a cert in cross-platform environments.
or want to import a cert in cross-platform environments.
```yaml
```yaml Type: SwitchParameter
Type: SwitchParameter Parameter Sets: (All)
Parameter Sets: (All) Aliases:
Aliases:
Required: False
Required: False Position: Named
Position: Named Default value: False
Default value: False Accept pipeline input: False
Accept pipeline input: False Accept wildcard characters: False
Accept wildcard characters: False ```
```
### -UseCertStore
### -UseCertStore Instead of using a plain pfx file beside your CredentialStore file you can import it into the user or machine
Instead of using a plain pfx file beside your CredentialStore file you can import it into the user or certificate store.
machine certificate store. In this case the system itself secures the cert and you don't hat to set custom NTFS
In this case the system itself secures the cert and you don't hat to set custom permissions so secure your shared certificate.
NTFS permissions so secure your shared certificate.
```yaml
```yaml Type: SwitchParameter
Type: SwitchParameter Parameter Sets: (All)
Parameter Sets: (All) Aliases:
Aliases:
Required: False
Required: False Position: Named
Position: Named Default value: False
Default value: False Accept pipeline input: False
Accept pipeline input: False Accept wildcard characters: False
Accept wildcard characters: False ```
```
### -Confirm
### -Confirm Prompts you for confirmation before running the cmdlet.
Prompts you for confirmation before running the cmdlet.
```yaml
```yaml Type: SwitchParameter
Type: SwitchParameter Parameter Sets: (All)
Parameter Sets: (All) Aliases: cf
Aliases: cf
Required: False
Required: False Position: Named
Position: Named Default value: None
Default value: None Accept pipeline input: False
Accept pipeline input: False Accept wildcard characters: False
Accept wildcard characters: False ```
```
### -WhatIf
### -WhatIf Shows what would happen if the cmdlet runs.
Shows what would happen if the cmdlet runs. The cmdlet is not run.
The cmdlet is not run.
```yaml
```yaml Type: SwitchParameter
Type: SwitchParameter Parameter Sets: (All)
Parameter Sets: (All) Aliases: wi
Aliases: wi
Required: False
Required: False Position: Named
Position: Named Default value: None
Default value: None Accept pipeline input: False
Accept pipeline input: False Accept wildcard characters: False
Accept wildcard characters: False ```
```
### CommonParameters
### CommonParameters This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
## INPUTS
## INPUTS
### [None]
### [None] ## OUTPUTS
## OUTPUTS
### ['PSCredentialStore.Store'] Returns the recently created CredentialStore object if the -PassThru parameter
### ['PSCredentialStore.Store'] Returns the recently created CredentialStore object if the -PassThru parameter ### was given.
### was given. ## NOTES
## NOTES
## RELATED LINKS
## RELATED LINKS

View File

@ -1,134 +1,133 @@
--- ---
external help file: ModuleRoot-help.xml external help file: PSCredentialStore-help.xml
Module Name: PSCredentialStore Module Name: PSCredentialStore
online version: schema: 2.0.0
schema: 2.0.0 ---
---
# New-CredentialStoreItem
# New-CredentialStoreItem
## SYNOPSIS
## SYNOPSIS Adds a credential store item containing host, user and password to the given store.
Adds a credential store item containing host, user and password to the given store.
## SYNTAX
## SYNTAX
### Private (Default)
### Private (Default) ```
``` New-CredentialStoreItem -RemoteHost <String> [-Identifier <String>] [-Credential <PSCredential>]
New-CredentialStoreItem -RemoteHost <String> [-Identifier <String>] [-Credential <PSCredential>] [<CommonParameters>]
[<CommonParameters>] ```
```
### Shared
### Shared ```
``` New-CredentialStoreItem -RemoteHost <String> [-Identifier <String>] [-Credential <PSCredential>] [-Shared]
New-CredentialStoreItem -RemoteHost <String> [-Identifier <String>] [-Credential <PSCredential>] [-Shared] [-Path <String>] [<CommonParameters>]
[-Path <String>] [<CommonParameters>] ```
```
## DESCRIPTION
## DESCRIPTION The credentials are stored without any relations to it's further use.
The credentials are stored without any relations to it's further use. If you need to change an existing
If you need to change an existing item please use Set-CredentialStoreItem.
item please use Set-CredentialStoreItem. You need to decide afterwards, whether to use the credential for
You need to decide afterwards, whether to use the credential for a VIConnection, NetApp FAS or UCS Fabric Interconnect.
a VIConnection, NetApp FAS or UCS Fabric Interconnect.
## EXAMPLES
## EXAMPLES
### EXAMPLE 1
### EXAMPLE 1 ```
``` New-CredentialStoreItem -Path "C:\TMP\mystore.json" -RemoteHost "esx01.myside.local"
New-CredentialStoreItem -Path "C:\TMP\mystore.json" -RemoteHost "esx01.myside.local" ```
```
## PARAMETERS
## PARAMETERS
### -Credential
### -Credential You can provide credentials optionally as pre existing pscredential object.
You can provide credentials optionally as pre existing pscredential object.
```yaml
```yaml Type: PSCredential
Type: PSCredential Parameter Sets: (All)
Parameter Sets: (All) Aliases:
Aliases:
Required: False
Required: False Position: Named
Position: Named Default value: None
Default value: None Accept pipeline input: True (ByValue)
Accept pipeline input: True (ByValue) Accept wildcard characters: False
Accept wildcard characters: False ```
```
### -Identifier
### -Identifier Provide a custom identifier to the given remote host key.
Provide a custom identifier to the given remote host key. This enables you to store multiple credentials
This enables you to store multiple credentials for a single remote host entry.
for a single remote host entry. For example ad/sys1, ftp/sys1, mssql/sys1
For example ad/sys1, ftp/sys1, mssql/sys1
```yaml
```yaml Type: String
Type: String Parameter Sets: (All)
Parameter Sets: (All) Aliases:
Aliases:
Required: False
Required: False Position: Named
Position: Named Default value: None
Default value: None Accept pipeline input: False
Accept pipeline input: False Accept wildcard characters: False
Accept wildcard characters: False ```
```
### -Path
### -Path Define the store in which you would like to add a new item.
Define the store in which you would like to add a new item.
```yaml
```yaml Type: String
Type: String Parameter Sets: Shared
Parameter Sets: Shared Aliases:
Aliases:
Required: False
Required: False Position: Named
Position: Named Default value: None
Default value: None Accept pipeline input: False
Accept pipeline input: False Accept wildcard characters: False
Accept wildcard characters: False ```
```
### -RemoteHost
### -RemoteHost The identifier or rather name for the given credentials.
The identifier or rather name for the given credentials.
```yaml
```yaml Type: String
Type: String Parameter Sets: (All)
Parameter Sets: (All) Aliases:
Aliases:
Required: True
Required: True Position: Named
Position: Named Default value: None
Default value: None Accept pipeline input: False
Accept pipeline input: False Accept wildcard characters: False
Accept wildcard characters: False ```
```
### -Shared
### -Shared Define the CredentialStore where you want to add the new item.
Define the CredentialStore where you want to add the new item. Default is always personal but can be
Default is always personal but can be changed to shared, or even shared with custom path.
changed to shared, or even shared with custom path.
```yaml
```yaml Type: SwitchParameter
Type: SwitchParameter Parameter Sets: Shared
Parameter Sets: Shared Aliases:
Aliases:
Required: True
Required: True Position: Named
Position: Named Default value: False
Default value: False Accept pipeline input: False
Accept pipeline input: False Accept wildcard characters: False
Accept wildcard characters: False ```
```
### CommonParameters
### CommonParameters This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
## INPUTS
## INPUTS
### [None]
### [None] ## OUTPUTS
## OUTPUTS
### [None]
### [None] ## NOTES
## NOTES
## RELATED LINKS
## RELATED LINKS

View File

@ -1,64 +1,64 @@
--- ---
Module Name: PSCredentialStore Module Name: PSCredentialStore
Module Guid: 6800e192-9df8-4e30-b253-eb2c799bbe84 Module Guid: 6800e192-9df8-4e30-b253-eb2c799bbe84 6800e192-9df8-4e30-b253-eb2c799bbe84
Download Help Link: {{ Update Download Link }} Download Help Link: {{ Update Download Link }}
Help Version: {{ Update Help Version }} Help Version: {{ Please enter version of help manually (X.X.X.X) format }}
Locale: en-US Locale: en-US
--- ---
# PSCredentialStore Module # PSCredentialStore Module
## Description ## Description
See global Readme file for usage instructions. {{ Fill in the Description }}
## PSCredentialStore Cmdlets ## PSCredentialStore Cmdlets
### [Connect-To](Connect-To.md) ### [Connect-To](Connect-To.md)
Connects to the given host using the stored CredentialStoreItem. Connects to the given host using the stored CredentialStoreItem.
### [Disconnect-From](Disconnect-From.md) ### [Disconnect-From](Disconnect-From.md)
Terminates a session established with Connect-To using a CredentialStoreItem. Terminates a session established with Connect-To using a CredentialStoreItem.
### [Get-CredentialStore](Get-CredentialStore.md) ### [Get-CredentialStore](Get-CredentialStore.md)
Reads the complete content of the credential store and returns it as a new object. Reads the complete content of the credential store and returns it as a new object.
### [Get-CredentialStoreItem](Get-CredentialStoreItem.md) ### [Get-CredentialStoreItem](Get-CredentialStoreItem.md)
Returns the Credential from a given remote host item. Returns the Credential from a given remote host item.
### [Get-CSCertificate](Get-CSCertificate.md) ### [Get-CSCertificate](Get-CSCertificate.md)
Returns the current used valid PfX certificate. Returns the current used valid PfX certificate.
### [Import-CSCertificate](Import-CSCertificate.md) ### [Import-CSCertificate](Import-CSCertificate.md)
Imports a linked certificate to the valid store location. Imports a linked certificate to the valid store location.
### [New-CredentialStore](New-CredentialStore.md) ### [New-CredentialStore](New-CredentialStore.md)
Creates a new credential store File Creates a new credential store File
### [New-CredentialStoreItem](New-CredentialStoreItem.md) ### [New-CredentialStoreItem](New-CredentialStoreItem.md)
Adds a credential store item containing host, user and password to the given store. Adds a credential store item containing host, user and password to the given store.
### [New-CSCertAttribute](New-CSCertAttribute.md) ### [New-CSCertAttribute](New-CSCertAttribute.md)
Creates required data for a certificate signing request. Creates required data for a certificate signing request.
### [New-CSCertificate](New-CSCertificate.md) ### [New-CSCertificate](New-CSCertificate.md)
Creates a new PFX certificate for the CredentialStore encryption. Creates a new PFX certificate for the CredentialStore encryption.
### [Remove-CredentialStoreItem](Remove-CredentialStoreItem.md) ### [Remove-CredentialStoreItem](Remove-CredentialStoreItem.md)
Remove the given credentials from the credential store. Remove the given credentials from the credential store.
### [Set-CredentialStoreItem](Set-CredentialStoreItem.md) ### [Set-CredentialStoreItem](Set-CredentialStoreItem.md)
Changes the credentials for the given remote host in the store. Changes the credentials for the given remote host in the store.
### [Test-CredentialStore](Test-CredentialStore.md) ### [Test-CredentialStore](Test-CredentialStore.md)
Returns the credential store state. Returns the credential store state.
### [Test-CredentialStoreItem](Test-CredentialStoreItem.md) ### [Test-CredentialStoreItem](Test-CredentialStoreItem.md)
Checks if the given RemoteHost identifier combination exists in the credential store. Checks if the given RemoteHost identifier combination exists in the credential store.
### [Test-CSCertificate](Test-CSCertificate.md) ### [Test-CSCertificate](Test-CSCertificate.md)
Tests if the linked certificate is store ein the specified cert stores. Tests if the linked certificate is store ein the specified cert stores.
### [Test-CSConnection](Test-CSConnection.md) ### [Test-CSConnection](Test-CSConnection.md)
Returns the connection state of a given type to the remote host. Returns the connection state of a given type to the remote host.
### [Use-CSCertificate](Use-CSCertificate.md) ### [Use-CSCertificate](Use-CSCertificate.md)
Links an existing PFX Certificate to a CredentialStore. Links an existing PFX Certificate to a CredentialStore.

View File

@ -1,128 +1,127 @@
--- ---
external help file: ModuleRoot-help.xml external help file: PSCredentialStore-help.xml
Module Name: PSCredentialStore Module Name: PSCredentialStore
online version: schema: 2.0.0
schema: 2.0.0 ---
---
# Remove-CredentialStoreItem
# Remove-CredentialStoreItem
## SYNOPSIS
## SYNOPSIS Remove the given credentials from the credential store.
Remove the given credentials from the credential store.
## SYNTAX
## SYNTAX
### Private (Default)
### Private (Default) ```
``` Remove-CredentialStoreItem -RemoteHost <String> [-Identifier <String>] [<CommonParameters>]
Remove-CredentialStoreItem -RemoteHost <String> [-Identifier <String>] [<CommonParameters>] ```
```
### Shared
### Shared ```
``` Remove-CredentialStoreItem -RemoteHost <String> [-Identifier <String>] [-Shared] [-Path <String>]
Remove-CredentialStoreItem -RemoteHost <String> [-Identifier <String>] [-Shared] [-Path <String>] [<CommonParameters>]
[<CommonParameters>] ```
```
## DESCRIPTION
## DESCRIPTION Use this CMDLet to completely remove an credential store item.
Use this CMDLet to completely remove an credential store item.
## EXAMPLES
## EXAMPLES
### EXAMPLE 1
### EXAMPLE 1 ```
``` Remove-CredentialStoreItem -RemoteHost "esx01.myside.local"
Remove-CredentialStoreItem -RemoteHost "esx01.myside.local" ```
```
### EXAMPLE 2
### EXAMPLE 2 ```
``` Remove-CredentialStoreItem -Shared -RemoteHost "esx01.myside.local"
Remove-CredentialStoreItem -Shared -RemoteHost "esx01.myside.local" ```
```
### EXAMPLE 3
### EXAMPLE 3 ```
``` Remove-CredentialStoreItem -Shared -Path "C:\TMP\mystore.json" -RemoteHost "esx01.myside.local"
Remove-CredentialStoreItem -Shared -Path "C:\TMP\mystore.json" -RemoteHost "esx01.myside.local" ```
```
### EXAMPLE 4
### EXAMPLE 4 ```
``` Remove-CredentialStoreItem -RemoteHost "esx01.myside.local" -Identifier svc
Remove-CredentialStoreItem -RemoteHost "esx01.myside.local" -Identifier svc ```
```
## PARAMETERS
## PARAMETERS
### -Identifier
### -Identifier Defaults to "".
Defaults to "". Specify a string, which separates two CredentialStoreItems for the
Specify a string, which separates two CredentialStoreItems for the same hostname.
same hostname.
```yaml
```yaml Type: String
Type: String Parameter Sets: (All)
Parameter Sets: (All) Aliases:
Aliases:
Required: False
Required: False Position: Named
Position: Named Default value: None
Default value: None Accept pipeline input: False
Accept pipeline input: False Accept wildcard characters: False
Accept wildcard characters: False ```
```
### -Path
### -Path Define the store in which your given host entry already exists.
Define the store in which your given host entry already exists.
```yaml
```yaml Type: String
Type: String Parameter Sets: Shared
Parameter Sets: Shared Aliases:
Aliases:
Required: False
Required: False Position: Named
Position: Named Default value: None
Default value: None Accept pipeline input: False
Accept pipeline input: False Accept wildcard characters: False
Accept wildcard characters: False ```
```
### -RemoteHost
### -RemoteHost Specify the host you for which you would like to change the credentials.
Specify the host you for which you would like to change the credentials.
```yaml
```yaml Type: String
Type: String Parameter Sets: (All)
Parameter Sets: (All) Aliases:
Aliases:
Required: True
Required: True Position: Named
Position: Named Default value: None
Default value: None Accept pipeline input: False
Accept pipeline input: False Accept wildcard characters: False
Accept wildcard characters: False ```
```
### -Shared
### -Shared Switch to shared mode with this param.
Switch to shared mode with this param. This enforces the command to work with a shared CredentialStore which
This enforces the command to work with a shared CredentialStore which can be decrypted across systems.
can be decrypted across systems.
```yaml
```yaml Type: SwitchParameter
Type: SwitchParameter Parameter Sets: Shared
Parameter Sets: Shared Aliases:
Aliases:
Required: True
Required: True Position: Named
Position: Named Default value: False
Default value: False Accept pipeline input: False
Accept pipeline input: False Accept wildcard characters: False
Accept wildcard characters: False ```
```
### CommonParameters
### CommonParameters This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
## INPUTS
## INPUTS
### [None]
### [None] ## OUTPUTS
## OUTPUTS
### [None]
### [None] ## NOTES
## NOTES
## RELATED LINKS
## RELATED LINKS

View File

@ -1,134 +1,133 @@
--- ---
external help file: ModuleRoot-help.xml external help file: PSCredentialStore-help.xml
Module Name: PSCredentialStore Module Name: PSCredentialStore
online version: schema: 2.0.0
schema: 2.0.0 ---
---
# Set-CredentialStoreItem
# Set-CredentialStoreItem
## SYNOPSIS
## SYNOPSIS Changes the credentials for the given remote host in the store.
Changes the credentials for the given remote host in the store.
## SYNTAX
## SYNTAX
### Private (Default)
### Private (Default) ```
``` Set-CredentialStoreItem -RemoteHost <String> [-Identifier <String>] [-Credential <PSCredential>]
Set-CredentialStoreItem -RemoteHost <String> [-Identifier <String>] [-Credential <PSCredential>] [<CommonParameters>]
[<CommonParameters>] ```
```
### Shared
### Shared ```
``` Set-CredentialStoreItem -RemoteHost <String> [-Identifier <String>] [-Credential <PSCredential>] [-Shared]
Set-CredentialStoreItem -RemoteHost <String> [-Identifier <String>] [-Credential <PSCredential>] [-Shared] [-Path <String>] [<CommonParameters>]
[-Path <String>] [<CommonParameters>] ```
```
## DESCRIPTION
## DESCRIPTION Use this function to update your already stored RemoteHost items.
Use this function to update your already stored RemoteHost items.
## EXAMPLES
## EXAMPLES
### EXAMPLE 1
### EXAMPLE 1 ```
``` Set-CredentialStoreItem -Path "C:\TMP\mystore.json" -RemoteHost "esx01.myside.local"
Set-CredentialStoreItem -Path "C:\TMP\mystore.json" -RemoteHost "esx01.myside.local" ```
```
### EXAMPLE 2
### EXAMPLE 2 ```
``` Set-CredentialStoreItem -Path "C:\TMP\mystore.json" -RemoteHost "esx01.myside.local" -Identifier svc
Set-CredentialStoreItem -Path "C:\TMP\mystore.json" -RemoteHost "esx01.myside.local" -Identifier svc ```
```
## PARAMETERS
## PARAMETERS
### -Credential
### -Credential Provided the new credentials you want to update inside the RemoteHost item.
Provided the new credentials you want to update inside the RemoteHost item.
```yaml
```yaml Type: PSCredential
Type: PSCredential Parameter Sets: (All)
Parameter Sets: (All) Aliases:
Aliases:
Required: False
Required: False Position: Named
Position: Named Default value: None
Default value: None Accept pipeline input: True (ByValue)
Accept pipeline input: True (ByValue) Accept wildcard characters: False
Accept wildcard characters: False ```
```
### -Identifier
### -Identifier Defaults to "".
Defaults to "". Specify a string, which separates two CredentialStoreItems for the
Specify a string, which separates two CredentialStoreItems for the same hostname.
same hostname.
```yaml
```yaml Type: String
Type: String Parameter Sets: (All)
Parameter Sets: (All) Aliases:
Aliases:
Required: False
Required: False Position: Named
Position: Named Default value: None
Default value: None Accept pipeline input: False
Accept pipeline input: False Accept wildcard characters: False
Accept wildcard characters: False ```
```
### -Path
### -Path Define the store in which your given host entry already exists.
Define the store in which your given host entry already exists.
```yaml
```yaml Type: String
Type: String Parameter Sets: Shared
Parameter Sets: Shared Aliases:
Aliases:
Required: False
Required: False Position: Named
Position: Named Default value: None
Default value: None Accept pipeline input: False
Accept pipeline input: False Accept wildcard characters: False
Accept wildcard characters: False ```
```
### -RemoteHost
### -RemoteHost Specify the host you for which you would like to change the credentials.
Specify the host you for which you would like to change the credentials.
```yaml
```yaml Type: String
Type: String Parameter Sets: (All)
Parameter Sets: (All) Aliases:
Aliases:
Required: True
Required: True Position: Named
Position: Named Default value: None
Default value: None Accept pipeline input: False
Accept pipeline input: False Accept wildcard characters: False
Accept wildcard characters: False ```
```
### -Shared
### -Shared Switch to shared mode with this param.
Switch to shared mode with this param. This enforces the command to work with a shared CredentialStore which
This enforces the command to work with a shared CredentialStore which can be decrypted across systems.
can be decrypted across systems.
```yaml
```yaml Type: SwitchParameter
Type: SwitchParameter Parameter Sets: Shared
Parameter Sets: Shared Aliases:
Aliases:
Required: True
Required: True Position: Named
Position: Named Default value: False
Default value: False Accept pipeline input: False
Accept pipeline input: False Accept wildcard characters: False
Accept wildcard characters: False ```
```
### CommonParameters
### CommonParameters This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
## INPUTS
## INPUTS
### [None]
### [None] ## OUTPUTS
## OUTPUTS
### [None]
### [None] ## NOTES
## NOTES
## RELATED LINKS
## RELATED LINKS

View File

@ -1,57 +1,56 @@
--- ---
external help file: ModuleRoot-help.xml external help file: PSCredentialStore-help.xml
Module Name: PSCredentialStore Module Name: PSCredentialStore
online version: schema: 2.0.0
schema: 2.0.0 ---
---
# Test-CSCertificate
# Test-CSCertificate
## SYNOPSIS
## SYNOPSIS Tests if the linked certificate is store ein the specified cert stores.
Tests if the linked certificate is store ein the specified cert stores.
## SYNTAX
## SYNTAX
```
``` Test-CSCertificate [-Type] <String> [<CommonParameters>]
Test-CSCertificate [-Type] <String> [<CommonParameters>] ```
```
## DESCRIPTION
## DESCRIPTION Test-CSCertificate should be an easy high level test for the linked certificate.
Test-CSCertificate should be an easy high level test for the linked certificate.
## EXAMPLES
## EXAMPLES
### EXAMPLE 1
### EXAMPLE 1 ```
``` Test-CSCertificate -Type 'Shared'
Test-CSCertificate -Type 'Shared' ```
```
## PARAMETERS
## PARAMETERS
### -Type
### -Type Select between 'Private' or 'Shared'.
Select between 'Private' or 'Shared'.
```yaml
```yaml Type: String
Type: String Parameter Sets: (All)
Parameter Sets: (All) Aliases:
Aliases:
Required: True
Required: True Position: 1
Position: 1 Default value: None
Default value: None Accept pipeline input: False
Accept pipeline input: False Accept wildcard characters: False
Accept wildcard characters: False ```
```
### CommonParameters
### CommonParameters This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
## INPUTS
## INPUTS
### [None]
### [None] ## OUTPUTS
## OUTPUTS
### [bool]
### [bool] ## NOTES
## NOTES
## RELATED LINKS
## RELATED LINKS

View File

@ -1,74 +1,73 @@
--- ---
external help file: ModuleRoot-help.xml external help file: PSCredentialStore-help.xml
Module Name: PSCredentialStore Module Name: PSCredentialStore
online version: schema: 2.0.0
schema: 2.0.0 ---
---
# Test-CSConnection
# Test-CSConnection
## SYNOPSIS
## SYNOPSIS Returns the connection state of a given type to the remote host.
Returns the connection state of a given type to the remote host.
## SYNTAX
## SYNTAX
```
``` Test-CSConnection [-RemoteHost] <String> [-Type] <String> [<CommonParameters>]
Test-CSConnection [-RemoteHost] <String> [-Type] <String> [<CommonParameters>] ```
```
## DESCRIPTION
## DESCRIPTION Use this script to check a connection which was established with the \`Connect-To\` cmdlet.
Use this script to check a connection which was established with the \`Connect-To\` cmdlet.
## EXAMPLES
## EXAMPLES
### EXAMPLE 1
### EXAMPLE 1 ```
``` Test-CMConnection -RemoteHost "vcr01.internal.net" -Type VMware
Test-CMConnection -RemoteHost "vcr01.internal.net" -Type VMware ```
```
## PARAMETERS
## PARAMETERS
### -RemoteHost
### -RemoteHost Define the remote host you would like to check.
Define the remote host you would like to check.
```yaml
```yaml Type: String
Type: String Parameter Sets: (All)
Parameter Sets: (All) Aliases:
Aliases:
Required: True
Required: True Position: 1
Position: 1 Default value: None
Default value: None Accept pipeline input: False
Accept pipeline input: False Accept wildcard characters: False
Accept wildcard characters: False ```
```
### -Type
### -Type Define the connection type you would like to check.
Define the connection type you would like to check. See the \`Connect-To\` documentation
See the \`Connect-To\` documentation for valid type values.
for valid type values.
```yaml
```yaml Type: String
Type: String Parameter Sets: (All)
Parameter Sets: (All) Aliases:
Aliases:
Required: True
Required: True Position: 2
Position: 2 Default value: None
Default value: None Accept pipeline input: False
Accept pipeline input: False Accept wildcard characters: False
Accept wildcard characters: False ```
```
### CommonParameters
### CommonParameters This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
## INPUTS
## INPUTS
### [None]
### [None] ## OUTPUTS
## OUTPUTS
### [bool]
### [bool] ## NOTES
## NOTES
## RELATED LINKS
## RELATED LINKS

View File

@ -1,81 +1,80 @@
--- ---
external help file: ModuleRoot-help.xml external help file: PSCredentialStore-help.xml
Module Name: PSCredentialStore Module Name: PSCredentialStore
online version: schema: 2.0.0
schema: 2.0.0 ---
---
# Test-CredentialStore
# Test-CredentialStore
## SYNOPSIS
## SYNOPSIS Returns the credential store state.
Returns the credential store state.
## SYNTAX
## SYNTAX
### Private (Default)
### Private (Default) ```
``` Test-CredentialStore [<CommonParameters>]
Test-CredentialStore [<CommonParameters>] ```
```
### Shared
### Shared ```
``` Test-CredentialStore [-Path <String>] [-Shared] [<CommonParameters>]
Test-CredentialStore [-Path <String>] [-Shared] [<CommonParameters>] ```
```
## DESCRIPTION
## DESCRIPTION Use this script to test your credential store.
Use this script to test your credential store. For now it only checks if
For now it only checks if the file exists.
the file exists.
## EXAMPLES
## EXAMPLES
### EXAMPLE 1
### EXAMPLE 1 ```
``` Test-CredentialStore -eq $true
Test-CredentialStore -eq $true ```
```
## PARAMETERS
## PARAMETERS
### -Path
### -Path Define a custom path to a shared CredentialStore.
Define a custom path to a shared CredentialStore.
```yaml
```yaml Type: String
Type: String Parameter Sets: Shared
Parameter Sets: Shared Aliases:
Aliases:
Required: False
Required: False Position: Named
Position: Named Default value: None
Default value: None Accept pipeline input: False
Accept pipeline input: False Accept wildcard characters: False
Accept wildcard characters: False ```
```
### -Shared
### -Shared Switch to shared mode with this param.
Switch to shared mode with this param. This enforces the command to work with a shared CredentialStore which
This enforces the command to work with a shared CredentialStore which can be decrypted across systems.
can be decrypted across systems.
```yaml
```yaml Type: SwitchParameter
Type: SwitchParameter Parameter Sets: Shared
Parameter Sets: Shared Aliases:
Aliases:
Required: True
Required: True Position: Named
Position: Named Default value: False
Default value: False Accept pipeline input: False
Accept pipeline input: False Accept wildcard characters: False
Accept wildcard characters: False ```
```
### CommonParameters
### CommonParameters This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
## INPUTS
## INPUTS
## OUTPUTS
## OUTPUTS
### System.Boolean
### System.Boolean ## NOTES
## NOTES
## RELATED LINKS
## RELATED LINKS

View File

@ -1,128 +1,121 @@
--- ---
external help file: ModuleRoot-help.xml external help file: PSCredentialStore-help.xml
Module Name: PSCredentialStore Module Name: PSCredentialStore
online version: schema: 2.0.0
schema: 2.0.0 ---
---
# Test-CredentialStoreItem
# Test-CredentialStoreItem
## SYNOPSIS
## SYNOPSIS Checks if the given RemoteHost identifier combination exists in the credential store.
Checks if the given RemoteHost identifier combination exists in the credential store.
## SYNTAX
## SYNTAX
### Private (Default)
### Private (Default) ```
``` Test-CredentialStoreItem -RemoteHost <String> [-Identifier <String>] [<CommonParameters>]
Test-CredentialStoreItem -RemoteHost <String> [-Identifier <String>] [<CommonParameters>] ```
```
### Shared
### Shared ```
``` Test-CredentialStoreItem [-Path <String>] -RemoteHost <String> [-Identifier <String>] [-Shared]
Test-CredentialStoreItem [-Path <String>] -RemoteHost <String> [-Identifier <String>] [-Shared] [<CommonParameters>]
[<CommonParameters>] ```
```
## DESCRIPTION
## DESCRIPTION Use this cmdlet for basic checks with a single item.
Use this cmdlet for basic checks with a single item. Check the item first with this function before
Check the item first with this function before you try to interact with it.
you try to interact with it.
## EXAMPLES
> :bulb: Breaking Change for \`v1.1.0+\`:
> ### EXAMPLE 1
> Test-CredentialStoreItem will return \`$false\` even if the store doesn't exist. ```
> We removed the terminating if (Test-CredentialStoreItem -RemoteHost "Default") {
> error and replaced it with a warning message. Get-CredentialStoreItem -RemoteHost "Default"
}
## EXAMPLES else {
Write-Warning ("The given Remote Host {0} does not exist in the credential Store!" -f $RemoteHost)
### EXAMPLE 1 }
``` ```
if (Test-CredentialStoreItem -RemoteHost "Default") {
Get-CredentialStoreItem -RemoteHost "Default" ## PARAMETERS
}
else { ### -Identifier
Write-Warning ("The given Remote Host {0} does not exist in the credential Store!" -f $RemoteHost) Adds an optional identifier to the given RemoteHost.
} Makes it possible to store multiple credentials
``` for a single host.
## PARAMETERS ```yaml
Type: String
### -Identifier Parameter Sets: (All)
Adds an optional identifier to the given RemoteHost. Aliases:
Makes it possible to store multiple credentials
for a single host. Required: False
Position: Named
```yaml Default value: None
Type: String Accept pipeline input: False
Parameter Sets: (All) Accept wildcard characters: False
Aliases: ```
Required: False ### -Path
Position: Named Define a custom credential store you try to read from.
Default value: None Without the \`-Path\` parameter
Accept pipeline input: False \`Test-CredentialStoreItem\` tries to read from the default private store.
Accept wildcard characters: False
``` ```yaml
Type: String
### -Path Parameter Sets: Shared
Define a custom credential store you try to read from. Aliases:
Without the \`-Path\` parameter
\`Test-CredentialStoreItem\` tries to read from the default private store. Required: False
Position: Named
```yaml Default value: "{0}\PSCredentialStore\CredentialStore.json" -f $env:ProgramData
Type: String Accept pipeline input: False
Parameter Sets: Shared Accept wildcard characters: False
Aliases: ```
Required: False ### -RemoteHost
Position: Named Specify the host, for which you would like to change the credentials.
Default value: "{0}\PSCredentialStore\CredentialStore.json" -f $env:ProgramData
Accept pipeline input: False ```yaml
Accept wildcard characters: False Type: String
``` Parameter Sets: (All)
Aliases:
### -RemoteHost
Specify the host, for which you would like to change the credentials. Required: True
Position: Named
```yaml Default value: None
Type: String Accept pipeline input: False
Parameter Sets: (All) Accept wildcard characters: False
Aliases: ```
Required: True ### -Shared
Position: Named Switch to shared mode with this param.
Default value: None This enforces the command to work with a shared CredentialStore which
Accept pipeline input: False can be decrypted across systems.
Accept wildcard characters: False
``` ```yaml
Type: SwitchParameter
### -Shared Parameter Sets: Shared
Switch to shared mode with this param. Aliases:
This enforces the command to work with a shared CredentialStore which
can be decrypted across systems. Required: False
Position: Named
```yaml Default value: False
Type: SwitchParameter Accept pipeline input: False
Parameter Sets: Shared Accept wildcard characters: False
Aliases: ```
Required: False ### CommonParameters
Position: Named This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
Default value: False
Accept pipeline input: False ## INPUTS
Accept wildcard characters: False
``` ### [None]
## OUTPUTS
### CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). ### [None]
## NOTES
## INPUTS
## RELATED LINKS
### [None]
## OUTPUTS
### [None]
## NOTES
## RELATED LINKS

View File

@ -1,108 +1,107 @@
--- ---
external help file: ModuleRoot-help.xml external help file: PSCredentialStore-help.xml
Module Name: PSCredentialStore Module Name: PSCredentialStore
online version: schema: 2.0.0
schema: 2.0.0 ---
---
# Use-CSCertificate
# Use-CSCertificate
## SYNOPSIS
## SYNOPSIS Links an existing PFX Certificate to a CredentialStore.
Links an existing PFX Certificate to a CredentialStore.
## SYNTAX
## SYNTAX
### Private (Default)
### Private (Default) ```
``` Use-CSCertificate -Path <String> [-UseCertStore] [<CommonParameters>]
Use-CSCertificate -Path <String> [-UseCertStore] [<CommonParameters>] ```
```
### Shared
### Shared ```
``` Use-CSCertificate -Path <String> [-CredentialStore <String>] [-Shared] [-UseCertStore] [<CommonParameters>]
Use-CSCertificate -Path <String> [-CredentialStore <String>] [-Shared] [-UseCertStore] [<CommonParameters>] ```
```
## DESCRIPTION
## DESCRIPTION Linking a certificate is needed if you plan to use the same CredentialStore in cross platform scenarios.
Linking a certificate is needed if you plan to use the same CredentialStore in cross platform scenarios.
## EXAMPLES
## EXAMPLES
### EXAMPLE 1
### EXAMPLE 1 ```
``` Use-CSCertificate -Path 'C:\cert.pfx'
Use-CSCertificate -Path 'C:\cert.pfx' ```
```
## PARAMETERS
## PARAMETERS
### -CredentialStore
### -CredentialStore Specify a custom path for a shared credential store.
Specify a custom path for a shared credential store.
```yaml
```yaml Type: String
Type: String Parameter Sets: Shared
Parameter Sets: Shared Aliases:
Aliases:
Required: False
Required: False Position: Named
Position: Named Default value: None
Default value: None Accept pipeline input: False
Accept pipeline input: False Accept wildcard characters: False
Accept wildcard characters: False ```
```
### -Path
### -Path Specify the path to the PFX Certificate you want to link for usage.
Specify the path to the PFX Certificate you want to link for usage.
```yaml
```yaml Type: String
Type: String Parameter Sets: (All)
Parameter Sets: (All) Aliases:
Aliases:
Required: True
Required: True Position: Named
Position: Named Default value: None
Default value: None Accept pipeline input: False
Accept pipeline input: False Accept wildcard characters: False
Accept wildcard characters: False ```
```
### -Shared
### -Shared Use the credential store in shared mode.
Use the credential store in shared mode.
```yaml
```yaml Type: SwitchParameter
Type: SwitchParameter Parameter Sets: Shared
Parameter Sets: Shared Aliases:
Aliases:
Required: True
Required: True Position: Named
Position: Named Default value: False
Default value: False Accept pipeline input: False
Accept pipeline input: False Accept wildcard characters: False
Accept wildcard characters: False ```
```
### -UseCertStore
### -UseCertStore Use the given certificate and import it into the corresponding certificate store.
Use the given certificate and import it into the corresponding certificate store.
```yaml
```yaml Type: SwitchParameter
Type: SwitchParameter Parameter Sets: (All)
Parameter Sets: (All) Aliases:
Aliases:
Required: False
Required: False Position: Named
Position: Named Default value: False
Default value: False Accept pipeline input: False
Accept pipeline input: False Accept wildcard characters: False
Accept wildcard characters: False ```
```
### CommonParameters
### CommonParameters This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
## INPUTS
## INPUTS
### [None]
### [None] ## OUTPUTS
## OUTPUTS
### [None]
### [None] ## NOTES
## NOTES
## RELATED LINKS
## RELATED LINKS

View File

@ -7,10 +7,6 @@ function Test-CredentialStoreItem {
Use this cmdlet for basic checks with a single item. Check the item first with this function before Use this cmdlet for basic checks with a single item. Check the item first with this function before
you try to interact with it. you try to interact with it.
Breaking Change for `v1.1.0+`:
Test-CredentialStoreItem will return `$false` even if the store doesn't exist. We removed the terminating
error and replaced it with a warning message.
.PARAMETER Path .PARAMETER Path
Define a custom credential store you try to read from. Without the `-Path` parameter Define a custom credential store you try to read from. Without the `-Path` parameter
`Test-CredentialStoreItem` tries to read from the default private store. `Test-CredentialStoreItem` tries to read from the default private store.
@ -92,10 +88,10 @@ function Test-CredentialStoreItem {
} }
else { else {
$MsgParams = @{ $MsgParams = @{
Message = "The given credential store ({0}) does not exist!" -f $Path ErrorAction = 'Stop'
Message = "The given credential store ({0}) does not exist!" -f $Path
} }
Write-Warning @MsgParams Write-Error @MsgParams
return $false
} }
} }