Merging latest into Live

reference/3.0/Microsoft.PowerShell.Core/About/about_Automatic_Variables.md

@@ -1,5 +1,5 @@
 ---
-ms.date:  2017-11-27
+ms.date:  2017-12-21
 schema:  2.0.0
 locale:  en-us
 keywords:  powershell,cmdlet
@@ -15,6 +15,9 @@ variables are created and maintained by PowerShell.
 
 ## LONG DESCRIPTION
 
+Conceptually, these variables are considered to be read-only.
+Even though they **can** be written to, for backward compatibility they **should not** be written to.
+
 Here is a list of the automatic variables in  PowerShell:
 
 ### $$
@@ -270,50 +273,6 @@ Appointment on Tuesday: Meeting
 Appointment on Friday: Team lunch
 ```
 
-### $OFS
-
-$OFS is a special variable that stores a string that you want to use as an
-output field separator. Use this variable when you are converting an array
-to a string. By default, the value of $OFS is " ", but you can change the
-value of $OFS in your session, by typing `$OFS="<value>"`. If you are
-expecting the default value of " " in your script, module, or configuration
-output, be careful that the $OFS default value has not been changed
-elsewhere in your code.
-
-For example:
-
-```powershell
-$a="1","2","3","4"
-$a
-[string]$a
-$OFS=""
-[string]$a
-$OFS=","
-[string]$a
-$OFS="--PowerShellRocks--";
-[string]$a
-$OFS="`n`n";
-[string]$a
-```
-
-```output
-1
-2
-3
-4
-1 2 3 4
-1234
-1,2,3,4
-1--PowerShellRocks--2--PowerShellRocks--3--PowerShellRocks--4
-1
-
-2
-
-3
-
-4
-```
-
 ### $PID
 
 Contains the process identifier (PID) of the process that is hosting the

reference/3.0/Microsoft.PowerShell.Core/About/about_History.md

@@ -71,7 +71,7 @@ about profiles, see
 [about_Profiles](http://go.microsoft.com/fwlink/?LinkID=113729).
 
 For more information about the $MaximumHistoryCount preference variable, see
-[about_Preference_Variables](http://go.microsoft.com/fwlink/?LinkID=113248).
+[about_Preference_Variables](about_Preference_Variables.md).
 
 NOTE: In Windows PowerShell 2.0, the default value of the
 `$MaximumHistoryCount` preference variable is 64.

reference/3.0/Microsoft.PowerShell.Core/About/about_Preference_Variables.md

@@ -1,5 +1,5 @@
 ---
-ms.date:  2017-12-05
+ms.date:  2017-12-21
 schema:  2.0.0
 locale:  en-us
 keywords:  powershell,cmdlet
@@ -835,7 +835,45 @@ Valid values: Any string.
 Default: Space
 
 By default, the \$OFS variable does not exist and the output file separator is
-a space, but you can add this variable and set it to any string.
+a space, but you can add this variable and set it to any string. You can change
+the value of $OFS in your session, by typing `$OFS="<value>"`. If you are
+expecting the default value of " " in your script, module, or configuration
+output, be careful that the $OFS default value has not been changed elsewhere
+in your code.
+
+For example:
+
+```powershell
+$a="1","2","3","4"
+$a
+[string]$a
+$OFS=""
+[string]$a
+$OFS=","
+[string]$a
+$OFS="--PowerShellRocks--";
+[string]$a
+$OFS="`n`n";
+[string]$a
+```
+
+```output
+1
+2
+3
+4
+1 2 3 4
+1234
+1,2,3,4
+1--PowerShellRocks--2--PowerShellRocks--3--PowerShellRocks--4
+1
+
+2
+
+3
+
+4
+```
 
 ##### EXAMPLES
 

reference/3.0/Microsoft.PowerShell.Core/Connect-PSSession.md

@@ -392,7 +392,7 @@ The session option values take precedence over default values for sessions set i
 However, they do not take precedence over maximum values, quotas or limits set in the session configuration.
 
 For a description of the session options, including the default values, see New-PSSessionOption.
-For information about the **$PSSessionOption** preference variable, see about_Preference_Variables (http://go.microsoft.com/fwlink/?LinkID=113248).
+For information about the **$PSSessionOption** preference variable, see [about_Preference_Variables](About/about_Preference_Variables.md).
 For more information about session configurations, see about_Session_Configurations (http://go.microsoft.com/fwlink/?LinkID=145152).
 
 ```yaml

reference/3.0/Microsoft.PowerShell.Core/Enter-PSSession.md

@@ -471,7 +471,7 @@ The session option values take precedence over default values for sessions set i
 However, they do not take precedence over maximum values, quotas or limits set in the session configuration.
 
 For a description of the session options, including the default values, see New-PSSessionOption.
-For information about the **$PSSessionOption** preference variable, see about_Preference_Variables (http://go.microsoft.com/fwlink/?LinkID=113248).
+For information about the **$PSSessionOption** preference variable, see [about_Preference_Variables](About/about_Preference_Variables.md).
 For more information about session configurations, see about_Session_Configurations (http://go.microsoft.com/fwlink/?LinkID=145152).
 
 ```yaml

reference/3.0/Microsoft.PowerShell.Core/Get-Command.md

@@ -37,7 +37,7 @@ A "`Get-Command *`" command gets all types of commands, including all of the non
 
 A **Get-Command** command that uses the exact name of the command (without wildcard characters) automatically imports the module that contains the command so you can use the command immediately.
 To enable, disable, and configure automatic importing of modules, use the **$PSModuleAutoLoadingPreference** preference variable.
-For more information, see about_Preference_Variables (http://go.microsoft.com/fwlink/?LinkID=113248).
+For more information, see [about_Preference_Variables](About/about_Preference_Variables.md).
 
 **Get-Command** gets its data directly from the command code, unlike Get-Help, which gets its information from help topics.
 
@@ -82,7 +82,7 @@ It also imports the **AppLocker** module, which adds all of the commands in the
 When a module is imported automatically, the effect is the same as using the Import-Module cmdlet.
 The module can add commands, types and formatting files, and run scripts in the session.
 To enable, disable, and configuration automatic importing of modules, use the **$PSModuleAutoLoadingPreference** preference variable.
-For more information, see about_Preference_Variables (http://go.microsoft.com/fwlink/?LinkID=113248).
+For more information, see [about_Preference_Variables](About/about_Preference_Variables.md).
 ### Example 6
 ```
 PS C:\> Get-Command Get-Childitem -Args Cert: -Syntax
@@ -471,7 +471,7 @@ Represents functions and filters
 
 ## NOTES
 * When more than one command with the same name is available to the session, **Get-Command** returns the command that runs when you type the command name. To get commands with the same name (listed in execution order), use the **All** parameter. For more information, see about_Command_Precedence.
-* When a module is imported automatically, the effect is the same as using the Import-Module cmdlet. The module can add commands, types and formatting files, and run scripts in the session. To enable, disable, and configuration automatic importing of modules, use the **$PSModuleAutoLoadingPreference** preference variable. For more information, see about_Preference_Variables (http://go.microsoft.com/fwlink/?LinkID=113248).
+* When a module is imported automatically, the effect is the same as using the Import-Module cmdlet. The module can add commands, types and formatting files, and run scripts in the session. To enable, disable, and configuration automatic importing of modules, use the **$PSModuleAutoLoadingPreference** preference variable. For more information, see [about_Preference_Variables](About/about_Preference_Variables.md).
 ## RELATED LINKS
 
 [Export-PSSession](../Microsoft.PowerShell.Utility/Export-PSSession.md)

reference/3.0/Microsoft.PowerShell.Core/Get-History.md

@@ -119,7 +119,7 @@ You can pipe a history ID to Get-History.
 Get-History returns a history object for each history item that it gets.
 ## NOTES
 * The session history is a list of the commands entered during the session. The session history represents the order of execution, the status, and the start and end times of the command. As you enter each command, Windows PowerShell adds it to the history so that you can reuse it. For more information about the command history, see about_History (http://go.microsoft.com/fwlink/?LinkID=113233).
-* Beginning in Windows PowerShell 3.0, the default value of the **$MaximumHistoryCount** preference variable is 4096. In Windows PowerShell 2.0, the default value is 64. For more information about the **$MaximumHistoryCount** variable, see about_Preference_Variables (http://go.microsoft.com/fwlink/?LinkID=113248).
+* Beginning in Windows PowerShell 3.0, the default value of the **$MaximumHistoryCount** preference variable is 4096. In Windows PowerShell 2.0, the default value is 64. For more information about the **$MaximumHistoryCount** variable, see [about_Preference_Variables](About/about_Preference_Variables.md).
 ## RELATED LINKS
 
 [Add-History](Add-History.md)

reference/3.0/Microsoft.PowerShell.Core/Get-PSSession.md

@@ -563,7 +563,7 @@ The session option values take precedence over default values for sessions set i
 However, they do not take precedence over maximum values, quotas or limits set in the session configuration.
 
 For a description of the session options, including the default values, see New-PSSessionOption.
-For information about the **$PSSessionOption** preference variable, see about_Preference_Variables (http://go.microsoft.com/fwlink/?LinkID=113248).
+For information about the **$PSSessionOption** preference variable, see [about_Preference_Variables](About/about_Preference_Variables.md).
 For more information about session configurations, see about_Session_Configurations (http://go.microsoft.com/fwlink/?LinkID=145152).
 
 ```yaml

reference/3.0/Microsoft.PowerShell.Core/Get-PSSessionConfiguration.md

@@ -316,7 +316,7 @@ This command is useful when setting the value of the $PSSessionConfigurationName
 
 The $PSSessionConfiguationName variable specifies the default configuration that is used when you create a session.
 This variable is set on the local computer, but it specifies a configuration on the remote computer.
-For more information about the $PSSessionConfiguration variable, see about_Preference_Variables (http://go.microsoft.com/fwlink/?LinkID=113248).
+For more information about the $PSSessionConfiguration variable, see [about_Preference_Variables](About/about_Preference_Variables.md).
 ## PARAMETERS
 
 ### -Name

reference/3.0/Microsoft.PowerShell.Core/Import-Module.md

@@ -58,7 +58,7 @@ The modules that you import must be installed on the local computer or a remote
 Beginning in Windows PowerShell 3.0, installed modules are automatically imported to the session when you use any commands or providers in the module.
 However, you can still use the **Import-Module** command to import a module and you can enable and disable automatic module importing by using the **$PSModuleAutoloadingPreference** preference variable.
 For more information about modules, see about_Modules (http://go.microsoft.com/fwlink/?LinkID=144311).
-For more information about the **$PSModuleAutoloadingPreference** variable, see about_Preference_Variables (http://go.microsoft.com/fwlink/?LinkID=113248).
+For more information about the **$PSModuleAutoloadingPreference** variable, see [about_Preference_Variables](About/about_Preference_Variables.md).
 
 A module is a package that contains members (such as cmdlets, providers, scripts, functions, variables, and other tools and files) that can be used in Windows PowerShell.
 After a module is imported, you can use the module members in your session.

reference/3.0/Microsoft.PowerShell.Core/Invoke-Command.md

@@ -430,7 +430,7 @@ Use this parameter to specify the application name when you are not using the **
 The default value is the value of the **$PSSessionApplicationName** preference variable on the local computer.
 If this preference variable is not defined, the default value is WSMAN.
 This value is appropriate for most uses.
-For more information, see about_Preference_Variables (http://go.microsoft.com/fwlink/?LinkID=113248).
+For more information, see [about_Preference_Variables](About/about_Preference_Variables.md).
 
 The WinRM service uses the application name to select a listener to service the connection request.
 The value of this parameter should match the value of the **URLPrefix** property of a listener on the remote computer.
@@ -880,7 +880,7 @@ The session option values take precedence over default values for sessions set i
 However, they do not take precedence over maximum values, quotas or limits set in the session configuration.
 
 For a description of the session options, including the default values, see New-PSSessionOption.
-For information about the **$PSSessionOption** preference variable, see about_Preference_Variables (http://go.microsoft.com/fwlink/?LinkID=113248).
+For information about the **$PSSessionOption** preference variable, see [about_Preference_Variables](About/about_Preference_Variables.md).
 For more information about session configurations, see about_Session_Configurations (http://go.microsoft.com/fwlink/?LinkID=145152).
 
 ```yaml

reference/3.0/Microsoft.PowerShell.Core/New-PSSession.md

@@ -199,7 +199,7 @@ Use this parameter to specify the application name when you are not using the **
 The default value is the value of the **$PSSessionApplicationName** preference variable on the local computer.
 If this preference variable is not defined, the default value is "WSMAN".
 This value is appropriate for most uses.
-For more information, see about_Preference_Variables (http://go.microsoft.com/fwlink/?LinkID=113248).
+For more information, see [about_Preference_Variables](About/about_Preference_Variables.md).
 
 The WinRM service uses the application name to select a listener to service the connection request.
 The value of this parameter should match the value of the **URLPrefix** property of a listener on the remote computer.
@@ -299,7 +299,7 @@ If the specified session configuration does not exist on the remote computer, th
 
 The default value is the value of the **$PSSessionConfigurationName** preference variable on the local computer.
 If this preference variable is not set, the default is Microsoft.PowerShell.
-For more information, see about_Preference_Variables (http://go.microsoft.com/fwlink/?LinkID=113248).
+For more information, see [about_Preference_Variables](About/about_Preference_Variables.md).
 
 ```yaml
 Type: String
@@ -476,7 +476,7 @@ The session option values take precedence over default values for sessions set i
 However, they do not take precedence over maximum values, quotas or limits set in the session configuration.
 
 For a description of the session options, including the default values, see New-PSSessionOption.
-For information about the **$PSSessionOption** preference variable, see about_Preference_Variables (http://go.microsoft.com/fwlink/?LinkID=113248).
+For information about the **$PSSessionOption** preference variable, see [about_Preference_Variables](About/about_Preference_Variables.md).
 For more information about session configurations, see about_Session_Configurations (http://go.microsoft.com/fwlink/?LinkID=145152).
 
 ```yaml

reference/3.0/Microsoft.PowerShell.Core/New-PSSessionOption.md

@@ -33,7 +33,7 @@ Because all of the properties can be edited, you can use the resulting object as
 You can also save a session option object in the **$PSSessionOption** preference variable.
 The values of this variable establish new default values for the session options.
 They effective when no session options are set for the session and they take precedence over options set in the session configuration, but you can override them by specifying session options or a session option object in a cmdlet that creates a session.
-For more information about the **$PSSessionOption** preference variable, see **about_Preference_Variables** (http://go.microsoft.com/fwlink/?LinkID=113248).
+For more information about the **$PSSessionOption** preference variable, see [about_Preference_Variables](About/about_Preference_Variables.md).
 
 When you use a session option object in a cmdlet that creates a session, the session option values take precedence over default values for sessions set in the **$PSSessionOption** preference variable and in the session configuration.
 However, they do not take precedence over maximum values, quotas or limits set in the session configuration.
@@ -155,7 +155,7 @@ When the **$PSSessionOption** preference variable exists in the session, it esta
 
 To make the **$PSSessionOption** variable available in all sessions, add it to your Windows PowerShell session and to your Windows PowerShell profile.
 
-For more information about the **$PSSessionOption** preference variable, see about_Preference_Variables (http://go.microsoft.com/fwlink/?LinkID=113248).
+For more information about the **$PSSessionOption** preference variable, see [about_Preference_Variables](About/about_Preference_Variables.md).
 For more information about profiles, see about_Profiles (http://go.microsoft.com/fwlink/?LinkID=113729).
 ### Example 6
 ```
@@ -660,7 +660,7 @@ You cannot pipe input to this cmdlet.
 ### System.Management.Automation.Remoting.PSSessionOption
 
 ## NOTES
-* If the **SessionOption** parameter is not used in a command to create a PSSession, the session options are determined by the property values of the **$PSSessionOption** preference variable, if it is set. For more information about the $PSSessionOption variable, see about_Preference_Variables (http://go.microsoft.com/fwlink/?LinkID=113248).
+* If the **SessionOption** parameter is not used in a command to create a PSSession, the session options are determined by the property values of the **$PSSessionOption** preference variable, if it is set. For more information about the $PSSessionOption variable, see [about_Preference_Variables](About/about_Preference_Variables.md).
 * The properties of a session configuration object vary with the options set for the session configuration and the values of those options. Also, session configurations that use a session configuration file have additional properties.
 ## RELATED LINKS
 

reference/3.0/Microsoft.PowerShell.Core/Receive-PSSession.md

@@ -631,7 +631,7 @@ The session option values take precedence over default values for sessions set i
 However, they do not take precedence over maximum values, quotas or limits set in the session configuration.
 
 For a description of the session options, including the default values, see New-PSSessionOption.
-For information about the **$PSSessionOption** preference variable, see about_Preference_Variables (http://go.microsoft.com/fwlink/?LinkID=113248).
+For information about the **$PSSessionOption** preference variable, see [about_Preference_Variables](About/about_Preference_Variables.md).
 For more information about session configurations, see about_Session_Configurations (http://go.microsoft.com/fwlink/?LinkID=145152).
 
 ```yaml

reference/3.0/Microsoft.PowerShell.Diagnostics/Import-Counter.md

@@ -41,11 +41,12 @@ Along with Get-Counter and Export-Counter, this feature lets you collect, export
 ## EXAMPLES
 
 ### Example 1
+```powershell
+$Data = Import-Counter -Path ProcessorData.csv
 ```
-PS C:\> $Data = Import-Counter -Path ProcessorData.csv
-```
 
-This command imports all of the counter data from the ProcessorData.csv file into the $Data variable.
+This command imports all counter data from the ProcessorData.csv file into the $Data variable.
+
 ### Example 2
 ```
 PS C:\> $i = Import-Counter -Path ProcessorData.blg -Counter "\\SERVER01\Processor(_Total)\Interrupts/sec"

reference/3.0/Microsoft.PowerShell.Utility/Write-Verbose.md

@@ -77,7 +77,7 @@ You can pipe a string that contains the message to **Write-Verbose**.
 **Write-Verbose** writes only to the verbose message stream.
 ## NOTES
 * Verbose messages are returned only when the command uses the **Verbose** common parameter. For more information, see about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).
-* In Windows PowerShell background jobs and remote commands, the **$VerbosePreference** variable in the job session and remote session determine whether the verbose message is displayed by default. For more information about the **$VerbosePreference** variable, see about_Preference_Variables (http://go.microsoft.com/fwlink/?LinkID=113248).
+* In Windows PowerShell background jobs and remote commands, the **$VerbosePreference** variable in the job session and remote session determine whether the verbose message is displayed by default. For more information about the **$VerbosePreference** variable, see [about_Preference_Variables](../Microsoft.PowerShell.Core/About/about_Preference_Variables.md).
 ## RELATED LINKS
 
 [Write-Error](Write-Error.md)