diff --git a/reference/5.1/Microsoft.PowerShell.Core/Connect-PSSession.md b/reference/5.1/Microsoft.PowerShell.Core/Connect-PSSession.md index 311d9eac3ac4..21b0ff6be5f9 100644 --- a/reference/5.1/Microsoft.PowerShell.Core/Connect-PSSession.md +++ b/reference/5.1/Microsoft.PowerShell.Core/Connect-PSSession.md @@ -90,7 +90,7 @@ started by using the Enter-PSSession cmdlet. Also you cannot connect sessions to sessions started by other users, unless you can provide the credentials of the user who created the session. -For more information about the Disconnected Sessions feature, see +For more information about the Disconnected Sessions feature, see [about_Remote_Disconnected_Sessions](About/about_Remote_Disconnected_Sessions.md). This cmdlet was introduced in Windows PowerShell 3.0. @@ -425,9 +425,16 @@ Accept wildcard characters: False Specifies a user account that has permission to connect to the disconnected session. The default is the current user. -Type a user name, such as User01 or Domain01\User01. -Or, enter a **PSCredential** object, such as one generated by the Get-Credential cmdlet. -If you type a user name, this cmdlet prompts you for a password. +Type a user name, such as **User01** or **Domain01\User01**, or enter a **PSCredential** object +generated by the `Get-Credential` cmdlet. If you type a user name, you're prompted to enter the +password. + +Credentials are stored in a [PSCredential](/dotnet/api/system.management.automation.pscredential) +object and the password is stored as a [SecureString](/dotnet/api/system.security.securestring). + +> [!NOTE] +> For more information about **SecureString** data protection, see +> [How secure is SecureString?](/dotnet/api/system.security.securestring#how-secure-is-securestring). ```yaml Type: PSCredential @@ -436,7 +443,7 @@ Aliases: Required: False Position: Named -Default value: None +Default value: Current user Accept pipeline input: False Accept wildcard characters: False ``` @@ -493,7 +500,7 @@ Accept wildcard characters: False Parameter Sets: Name, ComputerName, ConnectionUri Required: True (Name), False (ComputerName, ConnectionUri) Default value: None -Aliases: +Aliases: Type: String[] ``` @@ -694,10 +701,10 @@ session, use the **Availability** property. A value of Busy indicates that you cannot connect to the **PSSession** because it is connected to another session. - For more information about the values of the **State** property of sessions, see + For more information about the values of the **State** property of sessions, see [RunspaceState Enumeration](https://msdn.microsoft.com/library/system.management.automation.runspaces.runspacestate) in the MSDN library. - For more information about the values of the **Availability** property of sessions, see + For more information about the values of the **Availability** property of sessions, see [RunspaceAvailability Enumeration](https://msdn.microsoft.com/library/system.management.automation.runspaces.runspaceavailability) in the MSDN library. * You cannot change the idle time-out value of a **PSSession** when you connect to the diff --git a/reference/5.1/Microsoft.PowerShell.Core/Enter-PSSession.md b/reference/5.1/Microsoft.PowerShell.Core/Enter-PSSession.md index 58ab548e2193..37ef1c66be60 100644 --- a/reference/5.1/Microsoft.PowerShell.Core/Enter-PSSession.md +++ b/reference/5.1/Microsoft.PowerShell.Core/Enter-PSSession.md @@ -403,22 +403,28 @@ Accept wildcard characters: False ### -Credential -Specifies a user account that has permission to perform this action. -The default is the current user. +Specifies a user account that has permission to perform this action. The default is the current +user. -Type a user name, such as `User01`, `Domain01\User01`, or `User@Domain.com`, or enter a -**PSCredential** object, such as one returned by the Get-Credential cmdlet. +Type a user name, such as **User01** or **Domain01\User01**, or enter a **PSCredential** object +generated by the `Get-Credential` cmdlet. If you type a user name, you're prompted to enter the +password. -When you type a user name, this cmdlet prompts you for a password. +Credentials are stored in a [PSCredential](/dotnet/api/system.management.automation.pscredential) +object and the password is stored as a [SecureString](/dotnet/api/system.security.securestring). + +> [!NOTE] +> For more information about **SecureString** data protection, see +> [How secure is SecureString?](/dotnet/api/system.security.securestring#how-secure-is-securestring). ```yaml Accept pipeline input: True (ByPropertyName) -Position: Named +Position: 1 Accept wildcard characters: False Parameter Sets: ComputerName, Uri, VMId, VMName Required: True (VMId, VMName), False (ComputerName, Uri) -Default value: None -Aliases: +Default value: Current user +Aliases: Type: PSCredential ``` diff --git a/reference/5.1/Microsoft.PowerShell.Core/Get-PSSession.md b/reference/5.1/Microsoft.PowerShell.Core/Get-PSSession.md index ab82e37ffeea..f5004e7167e0 100644 --- a/reference/5.1/Microsoft.PowerShell.Core/Get-PSSession.md +++ b/reference/5.1/Microsoft.PowerShell.Core/Get-PSSession.md @@ -520,16 +520,23 @@ Accept wildcard characters: False ### -Credential -Specifies a user credential. -This cmdlet runs the command with the permissions of the specified user. -Specify a user account that has permission to connect to the remote computer and run a -**Get-PSSession** command. The default is the current user. -Type a user name, such as `User01`, `Domain01\User01`, or `User@Domain.com`, or enter a -**PSCredential** object, such as one returned by the Get-Credential cmdlet. -When you type a user name, this cmdlet prompts you for a password. +Specifies a user credential. This cmdlet runs the command with the permissions of the specified +user. Specify a user account that has permission to connect to the remote computer and run a +`Get-PSSession` command. The default is the current user. -This parameter configures to the temporary connection that is created to run a **Get-PSSession** -command with the *ComputerName* or *ConnectionUri* parameter. +Type a user name, such as **User01** or **Domain01\User01**, or enter a **PSCredential** object +generated by the `Get-Credential` cmdlet. If you type a user name, you're prompted to enter the +password. + +Credentials are stored in a [PSCredential](/dotnet/api/system.management.automation.pscredential) +object and the password is stored as a [SecureString](/dotnet/api/system.security.securestring). + +> [!NOTE] +> For more information about **SecureString** data protection, see +> [How secure is SecureString?](/dotnet/api/system.security.securestring#how-secure-is-securestring). + +This parameter configures to the temporary connection that is created to run a `Get-PSSession` +command with the **ComputerName** or **ConnectionUri** parameter. This parameter was introduced in Windows PowerShell 3.0. @@ -604,7 +611,7 @@ Accept wildcard characters: True Parameter Sets: Name, ComputerName, ConnectionUri, ContainerId, VMId, VMName Required: False Default value: All sessions -Aliases: +Aliases: Type: String[] ``` diff --git a/reference/5.1/Microsoft.PowerShell.Core/New-PSSession.md b/reference/5.1/Microsoft.PowerShell.Core/New-PSSession.md index 8c7c01e3244c..0fa9375bcf32 100644 --- a/reference/5.1/Microsoft.PowerShell.Core/New-PSSession.md +++ b/reference/5.1/Microsoft.PowerShell.Core/New-PSSession.md @@ -478,13 +478,18 @@ Accept wildcard characters: False ### -Credential -Specifies a user account that has permission to perform this action. -The default is the current user. +Specifies a user account that has permission to do this action. The default is the current user. -Type a user name, such as User01, Domain01\User01, or User@Domain.com, or enter a **PSCredential** -object, such as one returned by the Get-Credential cmdlet. +Type a user name, such as **User01** or **Domain01\User01**, or enter a **PSCredential** object +generated by the `Get-Credential` cmdlet. If you type a user name, you're prompted to enter the +password. -When you type a user name, this cmdlet prompts you for a password. +Credentials are stored in a [PSCredential](/dotnet/api/system.management.automation.pscredential) +object and the password is stored as a [SecureString](/dotnet/api/system.security.securestring). + +> [!NOTE] +> For more information about **SecureString** data protection, see +> [How secure is SecureString?](/dotnet/api/system.security.securestring#how-secure-is-securestring). ```yaml Accept pipeline input: True (ByPropertyName) @@ -492,8 +497,8 @@ Position: Named Accept wildcard characters: False Parameter Sets: ComputerName, Uri, VMId, VMName Required: True (VMId, VMName), False (ComputerName, Uri) -Default value: None -Aliases: +Default value: Current user +Aliases: Type: PSCredential ``` diff --git a/reference/5.1/Microsoft.PowerShell.Core/Receive-PSSession.md b/reference/5.1/Microsoft.PowerShell.Core/Receive-PSSession.md index 9594fe9934bc..b01ca472856f 100644 --- a/reference/5.1/Microsoft.PowerShell.Core/Receive-PSSession.md +++ b/reference/5.1/Microsoft.PowerShell.Core/Receive-PSSession.md @@ -465,10 +465,17 @@ Accept wildcard characters: False Specifies a user account that has permission to connect to the disconnected session. The default is the current user. -Type a user name, such as User01 or Domain01\User01. Or, enter a **PSCredential** object, such as -one generated by the Get-Credential cmdlet. If you type a user name, this cmdlet prompts you for a +Type a user name, such as **User01** or **Domain01\User01**, or enter a **PSCredential** object +generated by the `Get-Credential` cmdlet. If you type a user name, you're prompted to enter the password. +Credentials are stored in a [PSCredential](/dotnet/api/system.management.automation.pscredential) +object and the password is stored as a [SecureString](/dotnet/api/system.security.securestring). + +> [!NOTE] +> For more information about **SecureString** data protection, see +> [How secure is SecureString?](/dotnet/api/system.security.securestring#how-secure-is-securestring). + ```yaml Type: PSCredential Parameter Sets: ComputerSessionName, ComputerInstanceId, ConnectionUriSessionName, ConnectionUriInstanceId @@ -476,7 +483,7 @@ Aliases: Required: False Position: Named -Default value: None +Default value: Current user Accept pipeline input: False Accept wildcard characters: False ``` diff --git a/reference/6/Microsoft.PowerShell.Core/Connect-PSSession.md b/reference/6/Microsoft.PowerShell.Core/Connect-PSSession.md index b4ddcbf5f701..427870f707b1 100644 --- a/reference/6/Microsoft.PowerShell.Core/Connect-PSSession.md +++ b/reference/6/Microsoft.PowerShell.Core/Connect-PSSession.md @@ -424,9 +424,16 @@ Accept wildcard characters: False Specifies a user account that has permission to connect to the disconnected session. The default is the current user. -Type a user name, such as User01 or Domain01\User01. -Or, enter a **PSCredential** object, such as one generated by the Get-Credential cmdlet. -If you type a user name, this cmdlet prompts you for a password. +Type a user name, such as **User01** or **Domain01\User01**, or enter a **PSCredential** object +generated by the `Get-Credential` cmdlet. If you type a user name, you're prompted to enter the +password. + +Credentials are stored in a [PSCredential](/dotnet/api/system.management.automation.pscredential) +object and the password is stored as a [SecureString](/dotnet/api/system.security.securestring). + +> [!NOTE] +> For more information about **SecureString** data protection, see +> [How secure is SecureString?](/dotnet/api/system.security.securestring#how-secure-is-securestring). ```yaml Type: PSCredential @@ -435,7 +442,7 @@ Aliases: Required: False Position: Named -Default value: None +Default value: Current user Accept pipeline input: False Accept wildcard characters: False ``` diff --git a/reference/6/Microsoft.PowerShell.Core/Enter-PSSession.md b/reference/6/Microsoft.PowerShell.Core/Enter-PSSession.md index 9c7d619107fe..68f4d2f934e0 100644 --- a/reference/6/Microsoft.PowerShell.Core/Enter-PSSession.md +++ b/reference/6/Microsoft.PowerShell.Core/Enter-PSSession.md @@ -439,13 +439,19 @@ Accept wildcard characters: False ### -Credential -Specifies a user account that has permission to perform this action. -The default is the current user. +Specifies a user account that has permission to perform this action. The default is the current +user. -Type a user name, such as `User01`, `Domain01\User01`, or `User@Domain.com`, or enter a -**PSCredential** object, such as one returned by the Get-Credential cmdlet. +Type a user name, such as **User01** or **Domain01\User01**, or enter a **PSCredential** object +generated by the `Get-Credential` cmdlet. If you type a user name, you're prompted to enter the +password. + +Credentials are stored in a [PSCredential](/dotnet/api/system.management.automation.pscredential) +object and the password is stored as a [SecureString](/dotnet/api/system.security.securestring). -When you type a user name, this cmdlet prompts you for a password. +> [!NOTE] +> For more information about **SecureString** data protection, see +> [How secure is SecureString?](/dotnet/api/system.security.securestring#how-secure-is-securestring). ```yaml Accept pipeline input: True (ByPropertyName) @@ -453,7 +459,7 @@ Position: 1 Accept wildcard characters: False Parameter Sets: ComputerName, Uri, VMId, VMName Required: True (VMId, VMName), False (ComputerName, Uri) -Default value: None +Default value: Current user Aliases: Type: PSCredential ``` diff --git a/reference/6/Microsoft.PowerShell.Core/Get-PSSession.md b/reference/6/Microsoft.PowerShell.Core/Get-PSSession.md index f4ac8c352dce..4cc390f5fd2d 100644 --- a/reference/6/Microsoft.PowerShell.Core/Get-PSSession.md +++ b/reference/6/Microsoft.PowerShell.Core/Get-PSSession.md @@ -520,16 +520,23 @@ Accept wildcard characters: False ### -Credential -Specifies a user credential. -This cmdlet runs the command with the permissions of the specified user. -Specify a user account that has permission to connect to the remote computer and run a -**Get-PSSession** command. The default is the current user. -Type a user name, such as `User01`, `Domain01\User01`, or `User@Domain.com`, or enter a -**PSCredential** object, such as one returned by the Get-Credential cmdlet. -When you type a user name, this cmdlet prompts you for a password. +Specifies a user credential. This cmdlet runs the command with the permissions of the specified +user. Specify a user account that has permission to connect to the remote computer and run a +`Get-PSSession` command. The default is the current user. -This parameter configures to the temporary connection that is created to run a **Get-PSSession** -command with the *ComputerName* or *ConnectionUri* parameter. +Type a user name, such as **User01** or **Domain01\User01**, or enter a **PSCredential** object +generated by the `Get-Credential` cmdlet. If you type a user name, you're prompted to enter the +password. + +Credentials are stored in a [PSCredential](/dotnet/api/system.management.automation.pscredential) +object and the password is stored as a [SecureString](/dotnet/api/system.security.securestring). + +> [!NOTE] +> For more information about **SecureString** data protection, see +> [How secure is SecureString?](/dotnet/api/system.security.securestring#how-secure-is-securestring). + +This parameter configures to the temporary connection that is created to run a `Get-PSSession` +command with the **ComputerName** or **ConnectionUri** parameter. This parameter was introduced in Windows PowerShell 3.0. @@ -540,7 +547,7 @@ Aliases: Required: False Position: Named -Default value: None +Default value: Current user Accept pipeline input: False Accept wildcard characters: False ``` diff --git a/reference/6/Microsoft.PowerShell.Core/New-PSSession.md b/reference/6/Microsoft.PowerShell.Core/New-PSSession.md index 207dffe531f7..bbd1af425bda 100644 --- a/reference/6/Microsoft.PowerShell.Core/New-PSSession.md +++ b/reference/6/Microsoft.PowerShell.Core/New-PSSession.md @@ -540,13 +540,18 @@ Accept wildcard characters: False ### -Credential -Specifies a user account that has permission to perform this action. -The default is the current user. +Specifies a user account that has permission to do this action. The default is the current user. -Type a user name, such as User01, Domain01\User01, or User@Domain.com, or enter a **PSCredential** -object, such as one returned by the Get-Credential cmdlet. +Type a user name, such as **User01** or **Domain01\User01**, or enter a **PSCredential** object +generated by the `Get-Credential` cmdlet. If you type a user name, you're prompted to enter the +password. + +Credentials are stored in a [PSCredential](/dotnet/api/system.management.automation.pscredential) +object and the password is stored as a [SecureString](/dotnet/api/system.security.securestring). -When you type a user name, this cmdlet prompts you for a password. +> [!NOTE] +> For more information about **SecureString** data protection, see +> [How secure is SecureString?](/dotnet/api/system.security.securestring#how-secure-is-securestring). ```yaml Accept pipeline input: True (ByPropertyName) @@ -554,7 +559,7 @@ Position: Named Accept wildcard characters: False Parameter Sets: ComputerName, Uri, VMName, VMId Required: True (VMName, VMId), False (ComputerName, Uri) -Default value: None +Default value: Current user Aliases: Type: PSCredential ``` diff --git a/reference/6/Microsoft.PowerShell.Core/Receive-PSSession.md b/reference/6/Microsoft.PowerShell.Core/Receive-PSSession.md index e69910e81bee..f6d433d16a2e 100644 --- a/reference/6/Microsoft.PowerShell.Core/Receive-PSSession.md +++ b/reference/6/Microsoft.PowerShell.Core/Receive-PSSession.md @@ -495,12 +495,19 @@ Accept wildcard characters: False ### -Credential -Specifies a user account that has permission to connect to the disconnected session. -The default is the current user. +Specifies a user account that has permission to connect to the disconnected session. The default is +the current user. -Type a user name, such as User01 or Domain01\User01. -Or, enter a **PSCredential** object, such as one generated by the Get-Credential cmdlet. -If you type a user name, this cmdlet prompts you for a password. +Type a user name, such as **User01** or **Domain01\User01**, or enter a **PSCredential** object +generated by the `Get-Credential` cmdlet. If you type a user name, you're prompted to enter the +password. + +Credentials are stored in a [PSCredential](/dotnet/api/system.management.automation.pscredential) +object and the password is stored as a [SecureString](/dotnet/api/system.security.securestring). + +> [!NOTE] +> For more information about **SecureString** data protection, see +> [How secure is SecureString?](/dotnet/api/system.security.securestring#how-secure-is-securestring). ```yaml Type: PSCredential @@ -509,7 +516,7 @@ Aliases: Required: False Position: Named -Default value: None +Default value: Current user Accept pipeline input: False Accept wildcard characters: False ``` diff --git a/reference/7/Microsoft.PowerShell.Core/Connect-PSSession.md b/reference/7/Microsoft.PowerShell.Core/Connect-PSSession.md index acb9340664d3..9dc1d5c3ef9b 100644 --- a/reference/7/Microsoft.PowerShell.Core/Connect-PSSession.md +++ b/reference/7/Microsoft.PowerShell.Core/Connect-PSSession.md @@ -424,9 +424,16 @@ Accept wildcard characters: False Specifies a user account that has permission to connect to the disconnected session. The default is the current user. -Type a user name, such as User01 or Domain01\User01. -Or, enter a **PSCredential** object, such as one generated by the Get-Credential cmdlet. -If you type a user name, this cmdlet prompts you for a password. +Type a user name, such as **User01** or **Domain01\User01**, or enter a **PSCredential** object +generated by the `Get-Credential` cmdlet. If you type a user name, you're prompted to enter the +password. + +Credentials are stored in a [PSCredential](/dotnet/api/system.management.automation.pscredential) +object and the password is stored as a [SecureString](/dotnet/api/system.security.securestring). + +> [!NOTE] +> For more information about **SecureString** data protection, see +> [How secure is SecureString?](/dotnet/api/system.security.securestring#how-secure-is-securestring). ```yaml Type: PSCredential @@ -435,7 +442,7 @@ Aliases: Required: False Position: Named -Default value: None +Default value: Current user Accept pipeline input: False Accept wildcard characters: False ``` diff --git a/reference/7/Microsoft.PowerShell.Core/Enter-PSSession.md b/reference/7/Microsoft.PowerShell.Core/Enter-PSSession.md index a2c06b616820..10f9a435deef 100644 --- a/reference/7/Microsoft.PowerShell.Core/Enter-PSSession.md +++ b/reference/7/Microsoft.PowerShell.Core/Enter-PSSession.md @@ -439,13 +439,19 @@ Accept wildcard characters: False ### -Credential -Specifies a user account that has permission to perform this action. -The default is the current user. +Specifies a user account that has permission to perform this action. The default is the current +user. -Type a user name, such as `User01`, `Domain01\User01`, or `User@Domain.com`, or enter a -**PSCredential** object, such as one returned by the Get-Credential cmdlet. +Type a user name, such as **User01** or **Domain01\User01**, or enter a **PSCredential** object +generated by the `Get-Credential` cmdlet. If you type a user name, you're prompted to enter the +password. + +Credentials are stored in a [PSCredential](/dotnet/api/system.management.automation.pscredential) +object and the password is stored as a [SecureString](/dotnet/api/system.security.securestring). -When you type a user name, this cmdlet prompts you for a password. +> [!NOTE] +> For more information about **SecureString** data protection, see +> [How secure is SecureString?](/dotnet/api/system.security.securestring#how-secure-is-securestring). ```yaml Accept pipeline input: True (ByPropertyName) @@ -453,7 +459,7 @@ Position: 1 Accept wildcard characters: False Parameter Sets: ComputerName, Uri, VMId, VMName Required: True (VMId, VMName), False (ComputerName, Uri) -Default value: None +Default value: Current user Aliases: Type: PSCredential ``` diff --git a/reference/7/Microsoft.PowerShell.Core/Get-PSSession.md b/reference/7/Microsoft.PowerShell.Core/Get-PSSession.md index f45a533ff548..72e273042df5 100644 --- a/reference/7/Microsoft.PowerShell.Core/Get-PSSession.md +++ b/reference/7/Microsoft.PowerShell.Core/Get-PSSession.md @@ -520,16 +520,23 @@ Accept wildcard characters: False ### -Credential -Specifies a user credential. -This cmdlet runs the command with the permissions of the specified user. -Specify a user account that has permission to connect to the remote computer and run a -**Get-PSSession** command. The default is the current user. -Type a user name, such as `User01`, `Domain01\User01`, or `User@Domain.com`, or enter a -**PSCredential** object, such as one returned by the Get-Credential cmdlet. -When you type a user name, this cmdlet prompts you for a password. +Specifies a user credential. This cmdlet runs the command with the permissions of the specified +user. Specify a user account that has permission to connect to the remote computer and run a +`Get-PSSession` command. The default is the current user. -This parameter configures to the temporary connection that is created to run a **Get-PSSession** -command with the *ComputerName* or *ConnectionUri* parameter. +Type a user name, such as **User01** or **Domain01\User01**, or enter a **PSCredential** object +generated by the `Get-Credential` cmdlet. If you type a user name, you're prompted to enter the +password. + +Credentials are stored in a [PSCredential](/dotnet/api/system.management.automation.pscredential) +object and the password is stored as a [SecureString](/dotnet/api/system.security.securestring). + +> [!NOTE] +> For more information about **SecureString** data protection, see +> [How secure is SecureString?](/dotnet/api/system.security.securestring#how-secure-is-securestring). + +This parameter configures to the temporary connection that is created to run a `Get-PSSession` +command with the **ComputerName** or **ConnectionUri** parameter. This parameter was introduced in Windows PowerShell 3.0. @@ -540,7 +547,7 @@ Aliases: Required: False Position: Named -Default value: None +Default value: Current user Accept pipeline input: False Accept wildcard characters: False ``` diff --git a/reference/7/Microsoft.PowerShell.Core/New-PSSession.md b/reference/7/Microsoft.PowerShell.Core/New-PSSession.md index 812dd137c7a6..f833b9d2e286 100644 --- a/reference/7/Microsoft.PowerShell.Core/New-PSSession.md +++ b/reference/7/Microsoft.PowerShell.Core/New-PSSession.md @@ -540,13 +540,18 @@ Accept wildcard characters: False ### -Credential -Specifies a user account that has permission to perform this action. -The default is the current user. +Specifies a user account that has permission to do this action. The default is the current user. -Type a user name, such as User01, Domain01\User01, or User@Domain.com, or enter a **PSCredential** -object, such as one returned by the Get-Credential cmdlet. +Type a user name, such as **User01** or **Domain01\User01**, or enter a **PSCredential** object +generated by the `Get-Credential` cmdlet. If you type a user name, you're prompted to enter the +password. + +Credentials are stored in a [PSCredential](/dotnet/api/system.management.automation.pscredential) +object and the password is stored as a [SecureString](/dotnet/api/system.security.securestring). -When you type a user name, this cmdlet prompts you for a password. +> [!NOTE] +> For more information about **SecureString** data protection, see +> [How secure is SecureString?](/dotnet/api/system.security.securestring#how-secure-is-securestring). ```yaml Accept pipeline input: True (ByPropertyName) @@ -554,7 +559,7 @@ Position: Named Accept wildcard characters: False Parameter Sets: ComputerName, Uri, VMName, VMId Required: True (VMName, VMId), False (ComputerName, Uri) -Default value: None +Default value: Current user Aliases: Type: PSCredential ``` diff --git a/reference/7/Microsoft.PowerShell.Core/Receive-PSSession.md b/reference/7/Microsoft.PowerShell.Core/Receive-PSSession.md index 3c47c02eace7..ac96155ec0c1 100644 --- a/reference/7/Microsoft.PowerShell.Core/Receive-PSSession.md +++ b/reference/7/Microsoft.PowerShell.Core/Receive-PSSession.md @@ -495,12 +495,19 @@ Accept wildcard characters: False ### -Credential -Specifies a user account that has permission to connect to the disconnected session. -The default is the current user. +Specifies a user account that has permission to connect to the disconnected session. The default is +the current user. -Type a user name, such as User01 or Domain01\User01. -Or, enter a **PSCredential** object, such as one generated by the Get-Credential cmdlet. -If you type a user name, this cmdlet prompts you for a password. +Type a user name, such as **User01** or **Domain01\User01**, or enter a **PSCredential** object +generated by the `Get-Credential` cmdlet. If you type a user name, you're prompted to enter the +password. + +Credentials are stored in a [PSCredential](/dotnet/api/system.management.automation.pscredential) +object and the password is stored as a [SecureString](/dotnet/api/system.security.securestring). + +> [!NOTE] +> For more information about **SecureString** data protection, see +> [How secure is SecureString?](/dotnet/api/system.security.securestring#how-secure-is-securestring). ```yaml Type: PSCredential @@ -509,7 +516,7 @@ Aliases: Required: False Position: Named -Default value: None +Default value: Current user Accept pipeline input: False Accept wildcard characters: False ```