Export (0) Print
Expand All

Get-SCXSSHCredential

Updated: November 1, 2013

Applies To: System Center 2012 - Operations Manager, System Center 2012 R2 Operations Manager, System Center 2012 SP1 - Operations Manager

Get-SCXSSHCredential

Creates a privileged credential, by using the Secure Shell (SSH) protocol, for management operations on UNIX and Linux computers.

Syntax

Parameter Set: Default
Get-SCXSSHCredential [-Username] <String> [-ElevationType <String> ] [-SSHKey <String> ] [ <CommonParameters>]




Detailed Description

The Get-SCXSSHCredential cmdlet creates a credential for use in privileged UNIX or Linux SSH agent management operations.

Parameters

-ElevationType<String>

Specifies the elevation method, either "su" or "sudo", that elevates the supplied credential to a privileged account on the UNIX or Linux computer. If left unspecified, the cmdlet treats the credential that is used to create the SSH connection as privileged. If ElevationType is "su", a root password must be provided for the SuPassword parameter.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-SSHKey<String>

Specifies the file name, including its path, of an SSH key. The SSH key file must be in PuTTY key format. This parameter is required unless a password is specified.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Username<String>

Specifies the user name for an SSH connection.


Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters.

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

  • Microsoft.Unix.SSHCredential

    This cmdlet returns the SSHCredential object as output.


Examples

-------------------------- EXAMPLE 1 --------------------------

Description

-----------

This command creates a privileged SSH credential with a user name and prompts for a password.


C:\PS>Get-SCXSSHCredential -UserName rootPassword:  *************

-------------------------- EXAMPLE 2 --------------------------

Description

-----------

This command creates a low-privileged credential with a user name and “su” elevation type. It then prompts for a password for the low-privileged account and the “su” password for the elevation.


C:\PS>Get-SCXSSHCredential -UserName joe -ElevationType suPassword:  *************Su Password: *************

-------------------------- EXAMPLE 3 --------------------------

Description

-----------

This command creates a credential with a low-privileged account with a user name and a “sudo” elevation type. It then prompts for a password for the low-privileged account.


C:\PS>Get-SCXSSHCredential -UserName joe -ElevationType sudoPassword: *************

-------------------------- EXAMPLE 4 --------------------------

Description

-----------

This command creates a privileged credential with a user name and an SSH key. It then prompts for a passphrase. If a passphrase was not configured with the SSH key, just press Enter.


C:\PS>Get-SCXSSHCredential -UserName root -SSHKey c:\keys\admin.ppkKey Passphrase: *************

-------------------------- EXAMPLE 5 --------------------------

Description

-----------

This command creates a low-privileged credential with a user name, an SSH key, and a “su” elevation type. It then prompts for the “su” password and a key passphrase.


C:\PS>Get-SCXSSHCredential -UserName joe -SSHKey c:\keys\userJoe.ppk -ElevationType suSu Password: *************Key Passphrase:

-------------------------- EXAMPLE 6 --------------------------

Description

-----------

This command creates a low-privileged credential with a user name, an SSH key, and a “sudo” elevation type. It then prompts for a key passphrase.


C:\PS>Get-SCXSSHCredential -UserName joe -SSHKey c:\keys\userJoe.ppk -ElevationType sudoKey Passphrase:
 
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2015 Microsoft