Skip to content

Commit e0f0486

Browse files
author
Sean Wheeler
authored
OPS Build config changes and minor article edits (#2051)
* clean up warnings from build log * clean up moniker mapping and add image types to config * removing unneeded index pages * fixing typos
1 parent a98db07 commit e0f0486

29 files changed

+841
-1221
lines changed

.openpublishing.redirection.json

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,21 @@
1515
"redirect_url": "/powershell/wmf/readme",
1616
"redirect_document_id": "False"
1717
},
18+
{
19+
"source_path": "reference/docs-conceptual/core-powershell/console-guide.md",
20+
"redirect_url": "/powershell/scripting/core-powershell/console/powershell.exe-command-line-help",
21+
"redirect_document_id": "False"
22+
},
23+
{
24+
"source_path": "reference/docs-conceptual/core-powershell/ise-guide.md",
25+
"redirect_url": "/powershell/scripting/core-powershell/ise/introducing-the-windows-powershell-ise",
26+
"redirect_document_id": "False"
27+
},
28+
{
29+
"source_path": "reference/docs-conceptual/getting-started/understanding-concepts-reference.md",
30+
"redirect_url": "/powershell/scripting/getting-started/fundamental/about-windows-powershell",
31+
"redirect_document_id": "False"
32+
},
1833
{
1934
"source_path": "reference/virtual-directory/index.md",
2035
"redirect_url": "/powershell/scripting/powershell-scripting",

dsc/DscForEngineers.md

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,5 @@
11
---
22
ms.date: 2017-10-13
3-
author: eslesar;mgreenegit
43
ms.topic: conceptual
54
keywords: dsc,powershell,configuration,setup
65
title: Desired State Configuration Overview for Decision Makers
@@ -112,15 +111,15 @@ Configuration Sample_Share
112111
# implement the logic of "how" to execute a task
113112
xSmbShare MySMBShare
114113
{
115-
Ensure = "Present"
114+
Ensure = "Present"
116115
Name = "MyShare"
117-
Path = "C:\Demo\Temp"
116+
Path = "C:\Demo\Temp"
118117
ReadAccess = "Alice"
119118
FullAccess = "Bob"
120119
Description = "This is an updated description for this share"
121120
}
122121
}
123-
}
122+
}
124123
#Run the function to compile the configuration
125124
Sample_Share
126125
#Pass the configuration to the nodes we defined and configure them

dsc/configDataCredentials.md

Lines changed: 13 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,10 @@ To suppress these error and warning messages use the DSC configuration data keyw
1818
* **PsDscAllowPlainTextPassword**
1919
* **PsDscAllowDomainUser**
2020

21-
>**Notes:** <p>Storing/transmitting plaintext passwords unencrypted is generally not secure. Securing credentials by using the techniques covered later in this topic is recommended.</p> <p>The Azure Automation DSC service allows you to centrally manage credentials to be compiled in configurations and stored securely. For information, see: [Compiling DSC Configurations / Credential Assets](https://docs.microsoft.com/en-in/azure/automation/automation-dsc-compile#credential-assets)</p>
21+
> [!NOTE]
22+
> Storing/transmitting plaintext passwords unencrypted is generally not secure. Securing credentials by using the techniques covered later in this topic is recommended.
23+
> The Azure Automation DSC service allows you to centrally manage credentials to be compiled in configurations and stored securely.
24+
> For information, see: [Compiling DSC Configurations / Credential Assets](/azure/automation/automation-dsc-compile#credential-assets)
2225
2326
The following is an example of passing plain text credentials:
2427

@@ -133,7 +136,8 @@ see [Running DSC with user credentials](runAsUser.md).
133136
Newer resources and custom resources can use this automatic property
134137
instead of creating their own property for credentials.
135138

136-
>**Note:** the design of some resources are to use multiple credentials for a specific reason, and they will have their own credential properties.
139+
> [!NOTE]
140+
> The design of some resources are to use multiple credentials for a specific reason, and they will have their own credential properties.
137141
138142
To find the available credential properties on a resource
139143
use either `Get-DscResource -Name ResourceName -Syntax`
@@ -228,8 +232,8 @@ for node 'localhost'.
228232
```
229233

230234
This example has two issues:
231-
1. An error explains that plain text passwords are not recommended
232-
2. A warning advises against using a domain credential
235+
1. An error explains that plain text passwords are not recommended
236+
2. A warning advises against using a domain credential
233237

234238
## PsDscAllowPlainTextPassword
235239

@@ -276,10 +280,11 @@ $cred = Get-Credential -UserName contoso\genericuser -Message "Password please"
276280
DomainCredentialExample -DomainCredential $cred -ConfigurationData $cd
277281
```
278282

279-
>**Note:** `NodeName` cannot equal asterisk, a specific node name is mandatory.
283+
> [!NOTE]
284+
> `NodeName` cannot equal asterisk, a specific node name is mandatory.
285+
286+
**Microsoft advises to avoid plain text passwords due to the significant security risk.**
280287

281-
**Microsoft advises to avoid plain text passwords
282-
due to the significant security risk.**
283288
An exception would be when using the Azure Automation DSC service,
284289
only because the data is always stored encrypted
285290
(in transit, at rest in the service, and at rest on the node).
@@ -291,8 +296,7 @@ still generates the warning that using a domain account for a credential is not
291296
Using a local account eliminates potential exposure of domain credentials
292297
that could be used on other servers.
293298

294-
**When using credentials with DSC resources,
295-
prefer a local account over a domain account when possible.**
299+
**When using credentials with DSC resources, prefer a local account over a domain account when possible.**
296300

297301
If there is a '\' or '@' in the `Username` property of the credential,
298302
then DSC will treat it as a domain account.

dsc/docfx.json

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,6 @@
1313
"breadcrumb_path":"bread/toc.json",
1414
"uhfHeaderId": "MSDocsHeader-Powershell",
1515
"layout": "conceptual",
16-
"ms.locale": "en-us",
1716
"ROBOTS": "INDEX, FOLLOW",
1817
"ms.prod": "powershell",
1918
"ms.technology": "dsc",

dsc/enactingConfigurations.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,5 @@
11
---
22
ms.date: 2017-10-16
3-
author: eslesar;mgreenegit
43
ms.topic: conceptual
54
keywords: dsc,powershell,configuration,setup
65
title: Enacting configurations
@@ -27,7 +26,7 @@ For example, if the configuration MOF is located at `C:\DSC\Configurations\local
2726
you would apply it to the local machine with the following command:
2827
`Start-DscConfiguration -Path 'C:\DSC\Configurations'`
2928

30-
> __Note__: By default, DSC runs a configuration as a background job. To run the configuration interactively, call the
29+
> __Note__: By default, DSC runs a configuration as a background job. To run the configuration interactively, call the
3130
>[Start-DscConfiguration](https://technet.microsoft.com/library/dn521623.aspx) with the __-Wait__ parameter.
3231
3332
## Pull mode

dsc/metaConfig.md

Lines changed: 5 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,5 @@
11
---
22
ms.date: 2017-10-11
3-
author: eslesar;mgreenegit
43
ms.topic: conceptual
54
keywords: dsc,powershell,configuration,setup
65
title: Configuring the Local Configuration Manager
@@ -46,7 +45,7 @@ configuration LCMConfig
4645
RefreshMode = 'Push'
4746
}
4847
}
49-
}
48+
}
5049
```
5150

5251
The process of applying settings to LCM is similar to applying a DSC configuration.
@@ -144,7 +143,7 @@ you create a **ConfigurationRepositoryWeb** block.
144143
A **ConfigurationRepositoryWeb** defines the following properties.
145144

146145
|Property|Type|Description|
147-
|---|---|---|
146+
|---|---|---|
148147
|AllowUnsecureConnection|bool|Set to **$TRUE** to allow connections from the node to the server without authentication. Set to **$FALSE** to require authentication.|
149148
|CertificateID|string|The thumbprint of a certificate used to authenticate to the server.|
150149
|ConfigurationNames|String[]|An array of names of configurations to be pulled by the target node. These are used only if the node is registered with the pull service by using a **RegistrationKey**. For more information, see [Setting up a pull client with configuration names](pullClientConfigNames.md).|
@@ -211,7 +210,7 @@ see [DSC Partial configurations](partialConfigs.md).
211210
**PartialConfiguration** defines the following properties.
212211

213212
|Property|Type|Description|
214-
|---|---|---|
213+
|---|---|---|
215214
|ConfigurationSource|string[]|An array of names of configuration servers, previously defined in **ConfigurationRepositoryWeb** and **ConfigurationRepositoryShare** blocks, where the partial configuration is pulled from.|
216215
|DependsOn|string{}|A list of names of other configurations that must be completed before this partial configuration is applied.|
217216
|Description|string|Text used to describe the partial configuration.|
@@ -221,11 +220,11 @@ see [DSC Partial configurations](partialConfigs.md).
221220

222221
__Note:__ partial configurations are supported with Azure Automation DSC, but only one configuration can be pulled from each automation account per node.
223222

224-
## See Also
223+
## See Also
225224

226225
### Concepts
227226
[Desired State Configuration Overview](overview.md)
228-
227+
229228
[Getting started with Azure Automation DSC](https://docs.microsoft.com/en-us/azure/automation/automation-dsc-getting-started)
230229

231230
### Other Resources

dsc/metaConfig4.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,5 @@
11
---
22
ms.date: 2017-10-12
3-
author: eslesar;mgreenegit
43
ms.topic: conceptual
54
keywords: dsc,powershell,configuration,setup
65
title: Windows PowerShell 4.0 Desired State Configuration Local Configuration Manager (LCM)

gallery/index.md

Lines changed: 0 additions & 3 deletions
This file was deleted.

jea/index.md

Lines changed: 0 additions & 3 deletions
This file was deleted.

reference/3.0/Microsoft.PowerShell.Core/About/about_WS-Management_Cmdlets.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -185,8 +185,6 @@ http://go.microsoft.com/fwlink/?LinkId=142329
185185

186186
[Set-WSManQuickConfig](../../Microsoft.WSMan.Management/Set-WSManQuickConfig.md)
187187

188-
[Set-WSManSessionOption](../../Microsoft.WSMan.Management/Set-WSManSessionOption.md)
189-
190188
[Test-WSMan](../../Microsoft.WSMan.Management/Test-WSMan.md)
191189

192190
# KEYWORDS

reference/4.0/Microsoft.PowerShell.Core/About/about_WS-Management_Cmdlets.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -185,8 +185,6 @@ http://go.microsoft.com/fwlink/?LinkId=142329
185185

186186
[Set-WSManQuickConfig](../../Microsoft.WSMan.Management/Set-WSManQuickConfig.md)
187187

188-
[Set-WSManSessionOption](../../Microsoft.WSMan.Management/Set-WSManSessionOption.md)
189-
190188
[Test-WSMan](../../Microsoft.WSMan.Management/Test-WSMan.md)
191189

192190
# KEYWORDS

reference/4.0/Microsoft.PowerShell.Core/About/about_desiredstateconfiguration.md

Lines changed: 0 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -30,13 +30,6 @@ For detailed information about DSC, see
3030
[PowerShell Desired State Configuration Overview](http://go.microsoft.com/fwlink/?LinkId=311940)
3131
in the TechNet Library.
3232

33-
## DEVELOPING DSC RESOURCES WITH CLASSES
34-
35-
Starting in PowerShell 5.0, you can develop DSC resources by using classes.
36-
For more information, see [about_Classes](about_Classes.md), and
37-
[Writing a custom DSC resource with PowerShell classes](http://technet.microsoft.com/library/dn948461.aspx)
38-
on Microsoft TechNet.
39-
4033
## USING DSC
4134

4235
To use DSC to configure your environment, first define a PowerShell

reference/5.0/Microsoft.PowerShell.Core/About/about_WS-Management_Cmdlets.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -185,8 +185,6 @@ http://go.microsoft.com/fwlink/?LinkId=142329
185185

186186
[Set-WSManQuickConfig](../../Microsoft.WSMan.Management/Set-WSManQuickConfig.md)
187187

188-
[Set-WSManSessionOption](../../Microsoft.WSMan.Management/Set-WSManSessionOption.md)
189-
190188
[Test-WSMan](../../Microsoft.WSMan.Management/Test-WSMan.md)
191189

192190
# KEYWORDS

reference/5.1/Microsoft.PowerShell.Core/About/about_WS-Management_Cmdlets.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -185,8 +185,6 @@ http://go.microsoft.com/fwlink/?LinkId=142329
185185

186186
[Set-WSManQuickConfig](../../Microsoft.WSMan.Management/Set-WSManQuickConfig.md)
187187

188-
[Set-WSManSessionOption](../../Microsoft.WSMan.Management/Set-WSManSessionOption.md)
189-
190188
[Test-WSMan](../../Microsoft.WSMan.Management/Test-WSMan.md)
191189

192190
# KEYWORDS

reference/6/Microsoft.PowerShell.Core/About/about_Language_Modes.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -251,4 +251,3 @@ NoLanguage session, PowerShell returns the ScriptsNotAllowed error message.
251251

252252
- [about_Session_Configuration_Files](about_Session_Configuration_Files.md)
253253
- [about_Session_Configurations](about_Session_Configurations.md)
254-
- [about_Windows_RT](about_Windows_RT.md)

0 commit comments

Comments
 (0)