Merging latest updates to Live

gallery/psgallery/psgallery_items_tab.md

@@ -6,40 +6,50 @@ keywords:  gallery,powershell,cmdlet,psgallery
 title:  psgallery_items_tab
 ---
 
-Items Tab
-==========
+# Items Tab
 
-The Items Tab displays all available items in the PowerShell Gallery.
-
-To see only Modules in the PowerShell Gallery, click Modules in the Items Tab drop down.  Similarly, to see only Scripts in the PowerShell Gallery, click Scripts in the Items Tab drop down.  
+The [Items tab](https://www.powershellgallery.com/items) displays all available items in the PowerShell Gallery.
 
+There are several ways to filter, sort, and search the items.
 To see more details about a particular item, click the item.
 
-There are several ways to sort the items:
+## Filter By
+
+The drop-down under "Filter By" allows users to filter the results by:
+* Include Prerelease
+* Stable Only
+
+For information about "Prerelease" and "Stable", see [Prerelease Versioning Added to PowerShellGet and PowerShell Gallery](https://blogs.msdn.microsoft.com/powershell/2017/12/05/prerelease-versioning-added-to-powershellget-and-powershell-gallery/) in the PowerShell Team Blog.
+
+The checkboxes under the drop-down allow users to filter the results by:
+* Item Types
+  - Module
+  - Script
+* Categories
+  - Cmdlet
+  - DSC Resource
+  - Function
+  - Role Capability
+  - Workflow
 
-##Filter By##
-The Filter By section allows users to filter the results by:
-* Item Type:
-    * Modules
-    * Scripts
-* Category:
-    * Cmdlet
-    * DSC Resource
-    * Function
-    * Workflow
+To see only modules in the PowerShell Gallery, check Module in the Item Types.
+Similarly, to see only scripts in the PowerShell Gallery, check Script in the Item Types.
 
-Note: Filters are inclusive.  
-Example: An item containing both Cmdlets and Functions will appear if either Cmdlet or Function (or both) are checked.  If neither are selected, the item will not appear.  
-Similarly, if all categories are selected, only items containing one of those categories will appear. **Items that do not belong to any of those categories will not appear.**
+> [!NOTE]
+> Filters are inclusive.
+> Example: An item containing both cmdlets and functions will appear if either Cmdlet or Function (or both) are checked.
+> If neither are selected, the item will not appear.
+> Similarly, if all categories are selected, only items containing one of those categories will appear.
+> **Items that do not belong to any of those categories will not appear.**
 
-##Sort By## 
-The Sort By drop down allows users to sort the results by:
-* Popularity - Popularity is determined by Download Count.
-* A-Z - Alphabetically by item name.
-* Recent - Items appear in order of publish date.
+## Sort By
 
+The Sort By drop-down allows users to sort the results by:
+* Popularity - Popularity is determined by Download Count
+* A-Z - Alphabetically by item name
+* Recent - Items appear in order of publish date
 
-##Search Box##
-The Search Box allows users to search the items on keywords.  
-See [Search Syntax](./psgallery_search_syntax.md) for more details.
+## Search Box
 
+The Search Box allows users to search the items on keywords.
+For more information, see [Gallery Search Syntax](psgallery_search_syntax.md).

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

@@ -501,8 +501,8 @@ right operand determine how many bits of the left operand are shifted.
 |`21 -shr 31`            | 0          | 0000 0000 | 0x00       |
 |`21 -shr 32`            | 21         | 0001 0101 | 0x15       |
 |`21 -shr 64`            | 21         | 0001 0101 | 0x15       |
-|`21 -shr 65`            | 10         | 0000 1010 | 0x15       |
-|`21 -shr 66`            | 5          | 0000 0101 | 0x15       |
+|`21 -shr 65`            | 10         | 0000 1010 | 0x0A       |
+|`21 -shr 66`            | 5          | 0000 0101 | 0x05       |
 |`[int]::MaxValue -shr 1`| 1073741823 |           | 0x3FFFFFFF |
 |`[int]::MinValue -shr 1`| -1073741824|           | 0xC0000000 |
 |`-1 -shr 1`             | -1         |           | 0xFFFFFFFF |

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

@@ -617,8 +617,8 @@ $a[-1]
 ```
 
 ```output
-0
-0
+1
+1
 4
 4
 ```

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

@@ -1,5 +1,5 @@
 ---
-ms.date:  2017-12-01
+ms.date:  2017-12-20
 schema:  2.0.0
 locale:  en-us
 keywords:  powershell,cmdlet
@@ -35,11 +35,10 @@ The following diagram shows the syntax for the -split operator.
 The parameter names do not appear in the command. Include only the parameter
 values. The values must appear in the order specified in the syntax diagram.
 
-```powershell
+```
 -Split <String>
-
+-Split (<String[]>)
 <String> -Split <Delimiter>[,<Max-substrings>[,"<Options>"]]
-
 <String> -Split {<ScriptBlock>} [,<Max-substrings>]
 ```
 
@@ -51,14 +50,14 @@ are applied.
 
 ## PARAMETERS
 
-### \<String\>
+### \<String\> or \<String[]\>
 
 Specifies one or more strings to be split. If you submit multiple strings, all
 the strings are split using the same delimiter rules.
 
 Example:
 
-```powershell
+```
 -split "red yellow blue green"
 red
 yellow
@@ -73,7 +72,7 @@ whitespace, including spaces and non-printable characters, such as newline
 (\`n) and tab (\`t). When the strings are split, the delimiter is omitted from
 all the substrings. Example:
 
-```powershell
+```
 "Lastname:FirstName:Address" -split ":"
 Lastname
 FirstName
@@ -90,7 +89,7 @@ as a split.
 
 Examples:
 
-```powershell
+```
 "Lastname:FirstName:Address" -split "(:)"
 Lastname
 :
@@ -139,6 +138,9 @@ Example:
 ```powershell
 $c = "Mercury,Venus,Earth,Mars,Jupiter,Saturn,Uranus,Neptune"
 $c -split ",", 5
+```
+
+```Output
 Mercury
 Venus
 Earth
@@ -156,6 +158,9 @@ Example:
 ```powershell
 $c = "Mercury,Venus,Earth,Mars,Jupiter,Saturn,Uranus,Neptune"
 $c -split {$_ -eq "e" -or $_ -eq "p"}
+```
+
+```Output
 M
 rcury,V
 nus,
@@ -173,7 +178,7 @@ Enclose the option name in quotation marks. Options are valid only when the
 
 The syntax for the Options parameter is:
 
-```powershell
+```
 "SimpleMatch [,IgnoreCase]"
 
 "[RegexMatch] [,IgnoreCase] [,CultureInvariant]
@@ -214,13 +219,16 @@ The unary split operator (`-split <string>`) has higher precedence than a
 comma. As a result, if you submit a comma-separated list of strings to the
 unary split operator, only the first string (before the first comma) is split.
 
-To split more than one string, use the binary split operator (<string> -split
-<delimiter>). Enclose all the strings in parentheses, or store the strings in
-a variable, and then submit the variable to the split operator.
+Use one of the following patterns to split more than one string:
+
+- Use the binary split operator (\<string[]\> -split \<delimiter\>)
+- Enclose all the strings in parentheses
+- Store the strings in a variable then submit the variable to the split
+  operator
 
 Consider the following example:
 
-```powershell
+```
 PS > -split "1 2", "a b"
 1
 2
@@ -251,7 +259,11 @@ b
 The following statement splits the string at whitespace.
 
 ```powershell
-PS > -split "Windows PowerShell 2.0`nWindows PowerShell with remoting"
+-split "Windows PowerShell 2.0`nWindows PowerShell with remoting"
+```
+
+```Output
+
 Windows
 PowerShell
 2.0
@@ -264,7 +276,10 @@ remoting
 The following statement splits the string at any comma.
 
 ```powershell
-PS > "Mercury,Venus,Earth,Mars,Jupiter,Saturn,Uranus,Neptune" -split ','
+"Mercury,Venus,Earth,Mars,Jupiter,Saturn,Uranus,Neptune" -split ','
+```
+
+```Output
 Mercury
 Venus
 Earth
@@ -278,7 +293,10 @@ Neptune
 The following statement splits the string at the pattern "er".
 
 ```powershell
-PS > "Mercury,Venus,Earth,Mars,Jupiter,Saturn,Uranus,Neptune" -split 'er'
+"Mercury,Venus,Earth,Mars,Jupiter,Saturn,Uranus,Neptune" -split 'er'
+```
+
+```Output
 M
 cury,Venus,Earth,Mars,Jupit
 ,Saturn,Uranus,Neptune
@@ -287,15 +305,21 @@ cury,Venus,Earth,Mars,Jupit
 The following statement performs a case-sensitive split at the letter "N".
 
 ```powershell
-PS > "Mercury,Venus,Earth,Mars,Jupiter,Saturn,Uranus,Neptune" -cSplit 'N'
+"Mercury,Venus,Earth,Mars,Jupiter,Saturn,Uranus,Neptune" -cSplit 'N'
+```
+
+```Output
 Mercury,Venus,Earth,Mars,Jupiter,Saturn,Uranus,
 eptune
 ```
 
 The following statement splits the string at "e" and "t".
 
 ```powershell
-PS > "Mercury,Venus,Earth,Mars,Jupiter,Saturn,Uranus,Neptune" -split '[et]'
+"Mercury,Venus,Earth,Mars,Jupiter,Saturn,Uranus,Neptune" -split '[et]'
+```
+
+```Output
 M
 rcury,V
 nus,
@@ -312,8 +336,10 @@ The following statement splits the string at "e" and "r", but limits the
 resulting substrings to six substrings.
 
 ```powershell
-PS > "Mercury,Venus,Earth,Mars,Jupiter,Saturn,Uranus,Neptune" `
-  -split '[er]', 6
+"Mercury,Venus,Earth,Mars,Jupiter,Saturn,Uranus,Neptune" -split '[er]', 6
+```
+
+```Output
 M
 
 cu
@@ -325,7 +351,10 @@ arth,Mars,Jupiter,Saturn,Uranus,Neptune
 The following statement splits a string into three substrings.
 
 ```powershell
-PS > "a,b,c,d,e,f,g,h" -split ",", 3
+"a,b,c,d,e,f,g,h" -split ",", 3
+```
+
+```Output
 a
 b
 c,d,e,f,g,h
@@ -335,7 +364,10 @@ The following statement splits two strings into three substrings.
 (The limit is applied to each string independently.)
 
 ```powershell
-PS > "a,b,c,d", "e,f,g,h" -split ",", 3
+"a,b,c,d", "e,f,g,h" -split ",", 3
+```
+
+```Output
 a
 b
 c,d
@@ -353,13 +385,15 @@ can use options, such as Multiline, only when the Max-substrings value is
 specified.
 
 ```powershell
-PS > $a = @'
+$a = @'
 1The first line.
 2The second line.
 3The third of three lines.
 '@
+$a -split "^\d", 0, "multiline"
+```
 
-PS > $a -split "^\d", 0, "multiline"
+```Output
 
 The first line.
 
@@ -381,8 +415,10 @@ can use options, such as SimpleMatch, only when the Max-substrings value is
 specified.
 
 ```powershell
-PS > "This.is.a.test" -split ".", 0, "simplematch"
+"This.is.a.test" -split ".", 0, "simplematch"
+```
 
+```Output
 This
 is
 a
@@ -393,10 +429,12 @@ The following statement splits the string at one of two delimiters, depending
 on the value of a variable.
 
 ```powershell
-PS > $i = 1
-PS > $c = "LastName, FirstName; Address, City, State, Zip"
-PS > $c -split {if ($i -lt 1) {$-eq ","} else {$-eq ";"}}
+$i = 1
+$c = "LastName, FirstName; Address, City, State, Zip"
+$c -split {if ($i -lt 1) {$-eq ","} else {$-eq ";"}}
+```
 
+```Output
 LastName, FirstName
 Address, City, State, Zip
 ```

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

@@ -541,7 +541,7 @@ You can pipe a computer name (string), ConnectionURI (URI), or session (PSSessio
 ### System.Management.Automation.Runspaces.PSSession
 
 ## NOTES
-* This cmdlet uses the Windows PowerShell remoting infrastructure. To use this cmdlet, the local computer and any remote computers must be configured for Windows PowerShell remoting. For more information, see about_Remote_Requirements (http://go.microsoft.com/fwlink/?LinkID=135187).
+* This cmdlet uses the Windows PowerShell remoting infrastructure. To use this cmdlet, the local computer and any remote computers must be configured for Windows PowerShell remoting. For more information, see [about_Remote_Requirements](About/about_Remote_Requirements.md).
 * To create a PSSession on the local computer, start Windows PowerShell with the "Run as administrator" option.
 * When you are finished with the PSSession, use the Remove-PSSession cmdlet to delete the PSSession and release its resources.