Skip to content

Commit 15ac74f

Browse files
authored
remove highbit chars v5 (#4103)
* remove highbit chars v5 * fix build errors
1 parent 18b68a5 commit 15ac74f

File tree

58 files changed

+1420
-1323
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

58 files changed

+1420
-1323
lines changed

reference/4.0/ISE/Import-IseSnippet.md

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -37,14 +37,14 @@ To view and use the imported snippets, from the Windows PowerShell ISEEdit menu,
3737
Imported snippets are available only in the current session.
3838
To import the snippets into all Windows PowerShell ISE sessions, add an **Import-IseSnippet** command to your Windows PowerShell profile or copy the snippet files to your local snippets directory ($home\Documents\WindowsPowershell\Snippets).
3939

40-
To be imported, the snippets must be properly formatted in the snippet XML for Windows PowerShell ISE snippets and saved in Snippet.ps1xml files.
40+
To import snippets, they must be properly formatted in the snippet XML for Windows PowerShell ISE snippets and saved in Snippet.ps1xml files.
4141
To create eligible snippets, use the New-IseSnippet cmdlet.
4242
New-IseSnippet creates a \<SnippetTitle\>.Snippets.ps1xml file in the $home\Documents\WindowsPowerShell\Snippets directory.
4343
You can move or copy the snippets to the Snippets directory of a Windows PowerShell module, or to any other directory.
4444

45-
NOTE: The Get-IseSnippet cmdlet, which gets user-created snippets in the local snippets directory, does not get imported snippets.
45+
The Get-IseSnippet cmdlet, which gets user-created snippets in the local snippets directory, does not get imported snippets.
4646

47-
This cmdlet is introduced in Windows PowerShell 3.0.
47+
This cmdlet was introduced in Windows PowerShell 3.0.
4848

4949
## EXAMPLES
5050

@@ -198,4 +198,6 @@ This cmdlet does not generate output.
198198
199199
[Get-IseSnippet](Get-IseSnippet.md)
200200
201-
[New-IseSnippet](New-IseSnippet.md)
201+
[New-IseSnippet](New-IseSnippet.md)
202+
203+
[about_Execution_Policies](../Microsoft.PowerShell.Core/About/about_Execution_Policies.md)

reference/4.0/ISE/New-IseSnippet.md

Lines changed: 16 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -34,17 +34,15 @@ To see snippets in Windows PowerShell ISE, from the **Edit** menu, select **Sta
3434
The **New-ISESnippet** cmdlet creates a \<Title\>.Snippets.ps1xml file in the $home\Documents\WindowsPowerShell\Snippets directory with the title that you specify.
3535
To include a snippet file in a module that you are authoring, add the snippet file to a Snippets subdirectory of your module directory.
3636

37-
Note: You cannot use user-created snippets in a session in which the execution policy is AllSigned or Restricted.
38-
For more information, see the Notes section.
37+
You cannot use user-created snippets in a session in which the execution policy is **Restricted** or **AllSigned**.
3938

40-
This cmdlet is introduced in Windows PowerShell 3.0.
39+
This cmdlet was introduced in Windows PowerShell 3.0.
4140

4241
## EXAMPLES
4342

44-
### Example 1
45-
46-
```powershell
47-
New-IseSnippet -Title Comment-BasedHelp -Description "A template for comment-based help." -Text "<#
43+
### Example 1: Create a Comment-BasedHelp snippet
44+
```
45+
PS C:\> New-IseSnippet -Title Comment-BasedHelp -Description "A template for comment-based help." -Text "<#
4846
.SYNOPSIS
4947
.DESCRIPTION
5048
.PARAMETER <Parameter-Name>
@@ -58,34 +56,33 @@ New-IseSnippet -Title Comment-BasedHelp -Description "A template for comment-bas
5856
This command creates a Comment-BasedHelp snippet for Windows PowerShell ISE.
5957
It creates a file named "Comment-BasedHelp.snippets.ps1xml" in the user's Snippets directory ($home\Documents\WindowsPowerShell\Snippets).
6058

61-
### Example 2
62-
63-
```powershell
64-
$m = @'
59+
### Example 2: Create a mandatory snippet
60+
```
61+
PS C:\> $M = @'
6562
Param
6663
(
6764
[parameter(Mandatory=$true)]
6865
[String[]]
6966
$<ParameterName>
7067
)
7168
'@
72-
New-IseSnippet -Text $m -Title Mandatory -Description "Adds a mandatory function parameter." -Author "Kim Akers, Fabrikam Corp." -Force
69+
70+
PS C:\> New-ISESnippet -Text $M -Title Mandatory -Description "Adds a mandatory function parameter." -Author "Patti Fuller, Fabrikam Corp." -Force
7371
```
7472

75-
These commands create a Mandatory snippet for Windows PowerShell ISE.
76-
The first command saves the snippet text in the $m variable.
73+
This example creates a Mandatory snippet for Windows PowerShell ISE.
74+
The first command saves the snippet text in the $M variable.
7775
The second command uses the **New-ISESnippet** cmdlet to create the snippet.
7876
The command uses the **Force** parameter to overwrite a previous snippet with the same name.
7977

80-
### Example 3
81-
82-
```powershell
83-
Copy-Item $home\Documents\WindowsPowerShell\Snippets\Mandatory.Snippets.ps1xml -Destination \\Server\Share
78+
### Example 3: Copy a mandatory snippet from a folder to a destination folder
79+
```
80+
PS C:\> Copy-Item "$Home\Documents\WindowsPowerShell\Snippets\Mandatory.Snippets.ps1xml" -Destination "\\Server\Share"
8481
```
8582

8683
This command uses the Copy-Item cmdlet to copy the Mandatory snippet from the folder where **New-ISESnippet** places it to the Server\Share file share.
8784

88-
Because the Snippets.ps1xml files that **New-ISESnippet** creates are text (XML) files, you can use the Item cmdlets to get, changes, move, rename, and copy them.
85+
Because the Snippets.ps1xml files that **New-ISESnippet** creates are text (XML) files, you can use the **Item** cmdlets to get, changes, move, rename, and copy them.
8986

9087
## PARAMETERS
9188

reference/4.0/Microsoft.PowerShell.Core/Enable-PSRemoting.md

Lines changed: 13 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -48,30 +48,32 @@ The **Enable-PSRemoting** cmdlet performs the following operations:
4848

4949
To run this cmdlet, start Windows PowerShell with the "Run as administrator" option.
5050

51-
CAUTION: On systems that have both Windows PowerShell 3.0 and the Windows PowerShell 2.0 engine, do not use Windows PowerShell 2.0 to run the **Enable-PSRemoting** and Disable-PSRemoting cmdlets.
52-
The commands might appear to succeed, but the remoting is not configured correctly.
53-
Remote commands, and later attempts to enable and disable remoting, are likely to fail.
51+
> [!CAUTION]
52+
> On systems that have both Windows PowerShell 3.0 and the Windows PowerShell 2.0 engine, do not use
53+
> Windows PowerShell 2.0 to run the **Enable-PSRemoting** and Disable-PSRemoting cmdlets. The commands
54+
> might appear to succeed, but the remoting is not configured correctly. Remote commands, and later
55+
> attempts to enable and disable remoting, are likely to fail.
5456
5557
## EXAMPLES
5658

57-
### Example 1
59+
### Example 1: Configure a computer to receive remote commands
5860

5961
```powershell
6062
Enable-PSRemoting
6163
```
6264

6365
This command configures the computer to receive remote commands.
6466

65-
### Example 2
67+
### Example 2: Configure a computer to receive remote commands without a confirmation prompt
6668

6769
```powershell
6870
Enable-PSRemoting -Force
6971
```
7072

7173
This command configures the computer to receive remote commands.
72-
It uses the Force parameter to suppress the user prompts.
74+
It uses the *Force* parameter to suppress the user prompts.
7375

74-
### Example 3
76+
### Example 3: Allow remote access on clients
7577

7678
```powershell
7779
Enable-PSRemoting -SkipNetworkProfileCheck -Force
@@ -90,7 +92,8 @@ The command uses the Force parameter to suppress confirmation messages.
9092
The **SkipNetworkProfileCheck** parameter has no effect on server version of Windows, which allow remote access from public networks in the same local subnet by default.
9193

9294
The second command eliminates the subnet restriction.
93-
The command uses the **Set-NetFirewallRule** cmdlet in the **NetSecurity** module to add a firewall rule that allows remote access from public networks from any remote location, including locations in different subnets.
95+
The command uses the **Set-NetFirewallRule** cmdlet in the **NetSecurity** module to add a firewall rule that allows remote access from public networks from any remote location.
96+
This includes locations in different subnets.
9497

9598
## PARAMETERS
9699

@@ -136,9 +139,8 @@ This parameter has no effect on server versions of Windows, which, by default, h
136139
If the local subnet firewall rule is disabled on a server version of Windows, **Enable-PSRemoting** re-enables it, regardless of the value of this parameter.
137140
138141
To remove the local subnet restriction and enable remote access from all locations on public networks, use the **Set-NetFirewallRule** cmdlet in the **NetSecurity** module.
139-
For more information, see Notes and Examples.
140142
141-
This parameter is introduced in Windows PowerShell 3.0.
143+
This parameter was introduced in Windows PowerShell 3.0.
142144
143145
```yaml
144146
Type: SwitchParameter
@@ -183,7 +185,7 @@ You cannot pipe input to this cmdlet.
183185
184186
### System.String
185187
186-
Enable-PSRemoting returns strings that describe its results.
188+
This cmdlet returns strings that describe its results.
187189
188190
## NOTES
189191

reference/4.0/Microsoft.PowerShell.Core/Get-Module.md

Lines changed: 24 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -213,7 +213,7 @@ Name ModuleType Path
213213
BitsTransfer Manifest C:\Windows\system32\WindowsPowerShell\v1.0\Modules\BitsTransfer\BitsTransfer.psd1
214214
```
215215

216-
This command gets all module files (imported and available) and groups them by module name.
216+
This command gets all module files, both imported and available, and then groups them by module name.
217217
This lets you see the module files that each script is exporting.
218218

219219
### Example 7: Display the contents of a module manifest
@@ -353,7 +353,7 @@ The default value is the namespace of the Module Discovery WMI provider.
353353
354354
Use this parameter to get CIM modules from computers and devices that are not running a Windows operating system.
355355
356-
This parameter is introduced in Windows PowerShell 3.0.
356+
This parameter was introduced in Windows PowerShell 3.0.
357357
358358
```yaml
359359
Type: String
@@ -372,9 +372,9 @@ Accept wildcard characters: False
372372
Specifies an alternate location for CIM modules.
373373
The default value is the resource URI of the Module Discovery WMI provider on the remote computer.
374374
375-
Use this parameter to get CIM modules from computers and devices that are not running a Windows operating system.
375+
Use this parameter to get CIM modules from computers and devices that are not running the Windows operating system.
376376
377-
This parameter is introduced in Windows PowerShell 3.0.
377+
This parameter was introduced in Windows PowerShell 3.0.
378378
379379
```yaml
380380
Type: Uri
@@ -394,9 +394,9 @@ Specifies a CIM session on the remote computer.
394394
Enter a variable that contains the CIM session or a command that gets the CIM session, such as a [Get-CimSession](https://docs.microsoft.com/powershell/module/cimcmdlets/get-cimsession) command.
395395
396396
`Get-Module` uses the CIM session connection to get modules from the remote computer.
397-
When you import the module (by using the `Import-Module` cmdlet) and use the commands from the imported module in the current session, the commands actually run on the remote computer.
397+
When you import the module by using the `Import-Module` cmdlet and use the commands from the imported module in the current session, the commands actually run on the remote computer.
398398

399-
You can use this parameter to get modules from computers and devices that are not running a Windows operating system, and Windows computers that have Windows PowerShell, but do not have Windows PowerShell remoting enabled.
399+
You can use this parameter to get modules from computers and devices that are not running the Windows operating system, and computers that have Windows PowerShell, but do not have Windows PowerShell remoting enabled.
400400

401401
The **CimSession** parameter gets all modules in the **CIMSession**.
402402
However, you can import only CIM-based and Cmdlet Definition XML (CDXML)-based modules.
@@ -415,15 +415,16 @@ Accept wildcard characters: False
415415

416416
### -FullyQualifiedName
417417

418-
Gets modules with names that are specified in the form of **ModuleSpecification** objects (described in the Remarks section of [ModuleSpecification Constructor (Hashtable)](https://msdn.microsoft.com/library/jj136290) in the MSDN library).
418+
Specifies names of modules in the form of **ModuleSpecification** objects.
419+
These objects are described in the Remarks section of [ModuleSpecification Constructor (Hashtable)](https://msdn.microsoft.com/library/jj136290) in the MSDN library.
419420
For example, the **FullyQualifiedName** parameter accepts a module name that is specified in the following formats:
420421

421422
- @{ModuleName = "modulename"; ModuleVersion = "version_number"}
422423
- @{ModuleName = "modulename"; ModuleVersion = "version_number"; Guid = "GUID"}
423424

424425
**ModuleName** and **ModuleVersion** are required, but **Guid** is optional.
425426

426-
You cannot specify the **FullyQualifiedName** parameter in the same command as a **Name** parameter; the two parameters are mutually exclusive.
427+
You cannot specify the **FullyQualifiedName** parameter in the same command as a **Name** parameter.
427428

428429
```yaml
429430
Type: ModuleSpecification[]
@@ -432,7 +433,7 @@ Aliases:
432433
433434
Required: False
434435
Position: Named
435-
Default value: All imported or available modules.
436+
Default value: None
436437
Accept pipeline input: True (ByPropertyName)
437438
Accept wildcard characters: False
438439
```
@@ -470,12 +471,13 @@ Accept wildcard characters: False
470471

471472
### -Name
472473

473-
Gets only modules with the specified names or name patterns.
474-
Wildcards are permitted.
474+
Specifies names or name patterns of modules that this cmdlet gets.
475+
Wildcard characters are permitted.
475476
You can also pipe the names to `Get-Module`.
476-
You cannot specify the **FullyQualifiedName** parameter in the same command as a **Name** parameter; the two parameters are mutually exclusive.
477+
You cannot specify the **FullyQualifiedName** parameter in the same command as a **Name** parameter.
477478

478-
The **Name** parameter cannot accept a module GUID as a value; to return modules by specifying a GUID, use the **FullyQualifiedName** parameter instead of the **Name** parameter.
479+
**Name** cannot accept a module GUID as a value.
480+
To return modules by specifying a GUID, use **FullyQualifiedName** instead.
479481

480482
```yaml
481483
Type: String[]
@@ -484,7 +486,7 @@ Aliases:
484486
485487
Required: False
486488
Position: 0
487-
Default value: All imported or available modules.
489+
Default value: None
488490
Accept pipeline input: True (ByValue)
489491
Accept wildcard characters: False
490492
```
@@ -498,7 +500,7 @@ When the session is connected to a remote computer, the **ListAvailable** parame
498500

499501
A `Get-Module` command with the **PSSession** parameter is equivalent to using the `Invoke-Command` cmdlet to run a `Get-Module -ListAvailable` command in a **PSSession**.
500502

501-
This parameter is introduced in Windows PowerShell 3.0.
503+
This parameter was introduced in Windows PowerShell 3.0.
502504

503505
```yaml
504506
Type: PSSession
@@ -522,7 +524,7 @@ This parameter is designed for development and testing scenarios in which the co
522524

523525
When the **Refresh** parameter is used in a command, the **ListAvailable** parameter is required.
524526

525-
This parameter is introduced in Windows PowerShell 3.0.
527+
This parameter was introduced in Windows PowerShell 3.0.
526528

527529
```yaml
528530
Type: SwitchParameter
@@ -544,14 +546,14 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
544546

545547
### System.String
546548

547-
You can pipe module names to `Get-Module`.
549+
You can pipe module names to this cmdlet.
548550

549551
## OUTPUTS
550552

551553
### System.Management.Automation.PSModuleInfo
552554

553-
`Get-Module` returns objects that represent modules.
554-
When you use the **ListAvailable** parameter, `Get-Module` returns a **ModuleInfoGrouping** object, which is a type of **PSModuleInfo** object that has the same properties and methods.
555+
This cmdlet returns objects that represent modules.
556+
When you specify the **ListAvailable** parameter, `Get-Module` returns a **ModuleInfoGrouping** object, which is a type of **PSModuleInfo** object that has the same properties and methods.
555557

556558
## NOTES
557559

@@ -568,9 +570,10 @@ When you use the **ListAvailable** parameter, `Get-Module` returns a **ModuleInf
568570

569571
- To use the CIM session feature, the remote computer must have WS-Management remoting and Windows Management Instrumentation (WMI), which is the Microsoft implementation of the Common Information Model (CIM) standard. The computer must also have the Module Discovery WMI provider or an alternate WMI provider that has the same basic features.
570572

571-
You can use the CIM session feature on computers that are not running a Windows operating system and on Windows computers that have Windows PowerShell, but do not have Windows PowerShell remoting enabled.
573+
You can use the CIM session feature on computers that are not running the Windows operating system and on Windows computers that have Windows PowerShell, but do not have Windows PowerShell remoting enabled.
572574

573-
You can also use the CIM parameters to get CIM modules from computers that have Windows PowerShell remoting enabled, including the local computer.
575+
You can also use the CIM parameters to get CIM modules from computers that have Windows PowerShell remoting enabled.
576+
This includes the local computer.
574577
When you create a CIM session on the local computer, Windows PowerShell uses DCOM, instead of WMI, to create the session.
575578

576579
## RELATED LINKS

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

Lines changed: 0 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -61,16 +61,6 @@ Invoke-Command [[-ComputerName] <String[]>] [-Credential <PSCredential>] [-Port
6161

6262
### Uri
6363

64-
```
65-
Invoke-Command [-Credential <PSCredential>] [-ConfigurationName <String>] [-ThrottleLimit <Int32>]
66-
[[-ConnectionUri] <Uri[]>] [-AsJob] [-InDisconnectedSession] [-HideComputerName] [-JobName <String>]
67-
[-ScriptBlock] <ScriptBlock> [-AllowRedirection] [-SessionOption <PSSessionOption>]
68-
[-Authentication <AuthenticationMechanism>] [-EnableNetworkAccess] [-InputObject <PSObject>]
69-
[-ArgumentList <Object[]>] [-CertificateThumbprint <String>] [<CommonParameters>]
70-
```
71-
72-
### Uri
73-
7464
```
7565
Invoke-Command [-Credential <PSCredential>] [-ConfigurationName <String>] [-ThrottleLimit <Int32>]
7666
[[-ConnectionUri] <Uri[]>] [-AsJob] [-InDisconnectedSession] [-HideComputerName] [-JobName <String>]

0 commit comments

Comments
 (0)