GroupPolicy module Formating updates

Author: pbossman

docset/winserver2022-ps/grouppolicy/Backup-GPO.md

@@ -80,12 +80,12 @@ This command backs up the GPO with the specified **GUID** in the `contoso.com` d
 the operation.
 
 If the domain of the user running the session (or, for startup and shutdown scripts, the computer)
-is different from the `contoso.com` domain, a trust must exist between the two domains or the command
-fails.
+is different from the `contoso.com` domain, a trust must exist between the two domains or the
+command fails.
 
 ### Example 3: Backup all GPOs in the domain of the user that is running the session
 
-```
+```powershell
 Backup-Gpo -All -Path "\\Server1\GpoBackups"
 ```
 
@@ -158,8 +158,8 @@ If you specify a domain that is different from the domain of the user that is ru
 session (or, for a startup or shutdown script, the computer), a trust must exist between that domain
 and the domain of the user (or the computer).
 
-You can also refer to Domain by its built-in alias, domain name.
-For more information, see [about_Aliases](????????).
+You can also refer to Domain by its built-in alias, domain name. For more information, see
+[about_Aliases](/powershell/module/microsoft.powershell.core/about/about_aliases)
 
 ```yaml
 Type: System.String
@@ -178,11 +178,11 @@ Accept wildcard characters: False
 Specifies the GPO to backup by its globally unique identifier (GUID).
 The `GUID` uniquely identifies the GPO.
 
-You can also refer to the **Guid** parameter by its built-in alias, **Id**.
-For more information, see [about_Aliases](????????????).
+You can also refer to the **Guid** parameter by its built-in alias, **Id**. For more information,
+see [about_Aliases](/powershell/module/microsoft.powershell.core/about/about_aliases).
 
 ```yaml
-Type: Guid ????????????
+Type: Guid 
 Parameter Sets: BackupOne(GUID)
 Aliases: Id
 
@@ -201,8 +201,8 @@ The display name is not guaranteed to be unique in the domain.
 If another GPO with the same display name exists in the domain an error occurs.
 You can use the **Guid** parameter to uniquely identify a GPO.
 
-You can also refer to the Name parameter by its built-in alias, **DisplayName**.
-For more information, see [about_Aliases](??????????????).
+You can also refer to the Name parameter by its built-in alias, **DisplayName**. For more
+information, see [about_Aliases](/powershell/module/microsoft.powershell.core/about/about_aliases).
 
 ```yaml
 Type: System.String

docset/winserver2022-ps/grouppolicy/Copy-GPO.md

@@ -92,31 +92,32 @@ that is running the session.a trust must exist between that domain and the domai
 ```powershell
 Get-GPO -All -Domain "sales1.contoso.com" | ForEach-Object {
     $params = @{
-        'TargetName' = $_.DisplayName
+        'TargetName'     = $_.DisplayName
+        'TargetDomain'   = "sales2.contoso.com"
+        'CopyACL'        = $true
+        'MigrationTable' = 'c:\tables\MigrationTable.migtable'
     }
-
-??????????????????????
-
-    $_ | Copy-GPO -TargetName ($_.DisplayName) -TargetDomain "sales2.contoso.com" -CopyAcl -MigrationTable 'c:\tables\MigrationTable.migtable' }
+    $_ | Copy-GPO @params  }
 ```
 
-This command copies all the GPOs in the sales1.contoso.com domain to the sales2.contoso.com domain.
+This command copies all the GPOs in the `sales1.contoso.com` domain to the `sales2.contoso.com`
+domain.
 
 All the GPOs in the source domain are retrieved by using the **Get-GPO** cmdlet using the **All**
 parameter. The output of **Get-GPO** is piped into the ForEach-Object command. When each GPO is
 evaluated, it is piped into **Copy-GPO** and its display name is specified for the **TargetName**
-parameter `-TargetName ($_.DisplayName)`. The **CopyACL** parameter is specified to copy the ACLs for
-each GPO to the destination domain. The **MigrationTable** parameter specifies a migration table to
-use to migrate Security principals and UNC paths to the destination domain. Both the **CopyACL** and
-the **MigrationTable** parameters are optional.
+parameter `-TargetName ($_.DisplayName)`. The **CopyACL** parameter is specified to copy the ACLs
+for each GPO to the destination domain. The **MigrationTable** parameter specifies a migration table
+to use to migrate Security principals and UNC paths to the destination domain. Both the **CopyACL**
+and the **MigrationTable** parameters are optional.
 
 If a GPO with the same display name as a source GPO already exists in the destination domain, an
 error occurs when this command attempts to copy the source GPO. Because this command copies all GPOs
 in the source domain, errors occur for default GPOs; for instance, the Default Domain Policy GPO and
 the Default Domain Controllers Policy GPO. These GPOs are not copied. You can suppress these error
 messages by supplying the **ErrorAction** parameter with a value of SilentlyContinue to
 **Copy-GPO**. For more information about the **ErrorAction** parameter, see
-[about_CommonParameters](?????????).
+[about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216).
 
 The destination GPOs that were successfully copied are returned by this command. By default, they
 are printed to the display, but you can add commands to the end of the pipeline to further configure
@@ -232,8 +233,8 @@ Accept wildcard characters: False
 
 ### -SourceGuid
 
-Specifies the source GPO by its globally unique identifier `GUID`. The `GUID` uniquely identifies the
-GPO.
+Specifies the source GPO by its globally unique identifier `GUID`. The `GUID` uniquely identifies
+the GPO.
 
 You can also refer to the **SourceGuid** parameter by its built-in alias, `Id`.
 

docset/winserver2022-ps/grouppolicy/Get-GPInheritance.md

@@ -91,13 +91,12 @@ InheritedGpoLinks     : {Default Domain Policy}
 This command gets Group Policy inheritance information for the `contoso.com` domain. The domain
 controller with the host name `DomainController1` is contacted to complete the operation.
 
-The domain does not have to be explicitly specified using the **Domain** parameter in this example. If
-the domain of the user that is running the session (or, for startup and shutdown scripts, the
+The domain does not have to be explicitly specified using the **Domain** parameter in this example.
+If the domain of the user that is running the session (or, for startup and shutdown scripts, the
 computer) is the same as the target domain, or a trust exists between it and the target domain, you
 do not have to specify the **Domain** parameter.
 
-### Example 3: Get GPOs that are linked to a specific organizational unit by evaluating the SOM
- object
+### Example 3: Get GPOs that are linked to a specific organizational unit by evaluating the SOM object
 
 ```powershell
 (Get-GPInheritance -Target "ou=myou,dc=contoso,dc=com").GpoLinks | 
@@ -132,7 +131,7 @@ WmiFilter        :
 ```
 
 This command evaluates the SOM object `Microsoft.GroupPolicy.SOM` returned by **Get-GPInheritance**
-and returns the GPOs that are linked to the MyOU organizational unit. You can use this command to
+and returns the GPOs that are linked to the `MyOU` organizational unit. You can use this command to
 set properties of the GPOs by piping its output into other cmdlets. For instance, you can pipe the
 output to the **Set-GPPermissions** cmdlet to delegate permissions to administrators of the OU for
 each of the GPOs linked to the OU.
@@ -141,12 +140,14 @@ The **GpoLinks** property of the SOM object contains a list of all the GPO links
 Each object in this list is of type `Microsoft.GroupPolicy.GpoLink`.
 The following shows one such object:
 
+```Output
 GpoId       : d02126d4-82e8-4e87-b4a0-2d44b6891411
 DisplayName : TestGPO-3
 Enabled     : True
 Enforced    : False
 Target      : ou=myou,dc=contoso,dc=com
 Order       : 1
+```
 
 The collection is piped into a foreach-object command, which retrieves each GPO by using the
 DisplayName property of the GpoLink object.
@@ -171,7 +172,7 @@ session (or, for a startup or shutdown script, the computer), a trust must exist
 and the domain of the user or the computer.
 
 You can also refer to the **Domain** parameter by its built-in alias, `DomainName`. For more
-information, see [about_Aliases](???????).
+information, see [about_Aliases](/powershell/module/microsoft.powershell.core/about/about_aliases).
 
 ```yaml
 Type: System.String

docset/winserver2022-ps/grouppolicy/Get-GPO.md

@@ -40,8 +40,9 @@ The **Get-GPO** cmdlet gets one Group Policy Object (GPO) or all the GPOs in a d
 specify a GPO by its display name or by its globally unique identifier (GUID) to get a single GPO,
 or you can get all the GPOs in the domain through the **All** parameter.
 
-This cmdlet returns one or more objects that represent the requested GPOs.
-By default, properties of the requested GPOs are printed to the display; however, you can also pipe the output of the **Get-GPO** cmdlet to other Group Policy cmdlets.
+This cmdlet returns one or more objects that represent the requested GPOs. By default, properties of
+the requested GPOs are printed to the display; however, you can also pipe the output of the
+**Get-GPO** cmdlet to other Group Policy cmdlets.
 
 ## EXAMPLES
 
@@ -65,9 +66,9 @@ ComputerVersion  : AD Version: 0, SysVol Version: 0
 WmiFilter        :
 ```
 
-This command gets the GPO named `Group Policy Test`. The GPO must exist in the domain of the user that
-is running the session (or, for startup and shutdown scripts, the computer). The command gets the
-GPO information by contacting the primary domain controller (PDC).
+This command gets the GPO named `Group Policy Test`. The GPO must exist in the domain of the user
+that is running the session (or, for startup and shutdown scripts, the computer). The command gets
+the GPO information by contacting the primary domain controller (PDC).
 
 ### Example 2: Get a single GPO by GUID
 
@@ -90,9 +91,9 @@ WmiFilter        :
 ```
 
 This command gets the GPO that has the ID (GUID) `331a09564-cd4a-4520-98fa-446a2af23b4b` in the
-`sales.contoso.com` domain. If the domain of the user that is running the session (or, for startup and
-shutdown scripts, the computer) is different that `sales.contoso.com`, a trust must exist between the
-two domains. The command retrieves the GPO information by contacting the PDC (in the
+`sales.contoso.com` domain. If the domain of the user that is running the session (or, for startup
+and shutdown scripts, the computer) is different that `sales.contoso.com`, a trust must exist
+between the two domains. The command retrieves the GPO information by contacting the PDC (in the
 `sales.contoso.com` domain).
 
 ### Example 3: Get all GPOs from a domain
@@ -132,10 +133,12 @@ If you do not specify the **Domain** parameter, the domain of the user that is r
 session is used. If the cmdlet is being run from a computer startup or shutdown script, the domain
 of the computer is used. For more information, see the Notes section in the full Help.
 
-If you specify a domain that is different from the domain of the user that is running the current session (or, for a startup or shutdown script, the computer), a trust must exist between that domain and the domain of the user or the computer.
+If you specify a domain that is different from the domain of the user that is running the current
+session (or, for a startup or shutdown script, the computer), a trust must exist between that domain
+and the domain of the user or the computer.
 
-You can also refer to the **Domain** parameter by its built-in alias, **DomainName**.
-For more information, see [about_Aliases](????????????).
+You can also refer to the **Domain** parameter by its built-in alias, **DomainName**. For more
+information, see [about_Aliases](/powershell/module/microsoft.powershell.core/about/about_aliases).
 
 ```yaml
 Type: System.String
@@ -237,19 +240,23 @@ This cmdlet returns an object that represents the requested GPO.
 
 * You can use the **Domain** parameter to explicitly specify the domain for this cmdlet.
 
-  If you do not explicitly specify the domain, the cmdlet uses a default domain.
-The default domain is the domain that is used to access network resources by the security context under which the current session is running.
-This domain is typically the domain of the user that is running the session.
-For example, the domain of the user who started the session by opening Windows PowerShell from the Program Files menu, or the domain of a user that is specified in a runas command.
-However, computer startup and shutdown scripts run under the context of the LocalSystem account.
-The LocalSystem account is a built-in local account, and it accesses network resources under the context of the computer account.
-Therefore, when this cmdlet is run from a startup or shutdown script, the default domain is the domain to which the computer is joined.
-
-  Only one domain can be used by an instance of this cmdlet.
-If you pipe a collection of GPO (Microsoft.GroupPolicy.Gpo) objects to this cmdlet, the DomainName property of the first GPO object in the collection specifies the domain for the cmdlet.
-This is because domainname is a built-in alias for the **Domain** parameter, and the **Domain** parameter can take its value by property name from the pipeline.
-A non-terminating error occurs for any GPOs in the collection that are not in this domain.
-If this domain is different from the domain of the user account (for startup or shutdown scripts, the computer account), a trust must exist between the two domains.
+  If you do not explicitly specify the domain, the cmdlet uses a default domain. The default domain
+  is the domain that is used to access network resources by the security context under which the
+  current session is running. This domain is typically the domain of the user that is running the
+  session. For example, the domain of the user who started the session by opening Windows PowerShell
+  from the Program Files menu, or the domain of a user that is specified in a runas command.
+  However, computer startup and shutdown scripts run under the context of the LocalSystem account.
+  The LocalSystem account is a built-in local account, and it accesses network resources under the
+  context of the computer account. Therefore, when this cmdlet is run from a startup or shutdown
+  script, the default domain is the domain to which the computer is joined.
+
+  Only one domain can be used by an instance of this cmdlet. If you pipe a collection of GPO
+  (Microsoft.GroupPolicy.Gpo) objects to this cmdlet, the DomainName property of the first GPO
+  object in the collection specifies the domain for the cmdlet. This is because domainname is a
+  built-in alias for the **Domain** parameter, and the **Domain** parameter can take its value by
+  property name from the pipeline. A non-terminating error occurs for any GPOs in the collection
+  that are not in this domain. If this domain is different from the domain of the user account (for
+  startup or shutdown scripts, the computer account), a trust must exist between the two domains.
 
 ## RELATED LINKS
 

docset/winserver2022-ps/grouppolicy/Get-GPOReport.md

@@ -63,7 +63,14 @@ This command generates a report in HTML format for the GPO `TestGPO1` and writes
 ### Example 2: Generate an XML report for each GPO in the specified domain
 
 ```powershell
-Get-GPOReport -All -Domain "sales.contoso.com" -Server "DC1" -ReportType XML -Path "C:\GPOReports\GPOReportsAll.xml"
+$params = @{
+    All         = $true
+    Domain      = 'sales.contoso.com'
+    Server      = 'DC1'
+    ReportType  = 'XML' 
+    Path        = 'C:\GPOReports\GPOReportsAll.xml'
+}
+Get-GPOReport @params
 ```
 
 This command generates a report in XML format for each GPO in the `sales.contoso.com` domain and
@@ -120,7 +127,7 @@ session or, (for a startup or shutdown script, the computer), a trust must exist
 and the domain of the user or the computer.
 
 You can also refer to Domain by its built-in alias, **DomainName**. For more information, see
-[about_Aliases](????????????).
+[about_Aliases](/powershell/module/microsoft.powershell.core/about/about_aliases).
 
 ```yaml
 Type: System.String
@@ -139,8 +146,8 @@ Accept wildcard characters: False
 Specifies the GPO for which to generate the report by its globally unique identifier (GUID). The
 GUID uniquely identifies the GPO.
 
-You can also refer to the **Guid** parameter by its built-in alias, **Id**.
-For more information, see [about_Aliases](????????).
+You can also refer to the **Guid** parameter by its built-in alias, **Id**. For more information,
+see [about_Aliases](/powershell/module/microsoft.powershell.core/about/about_aliases)
 
 ```yaml
 Type: Guid
@@ -162,8 +169,8 @@ The display name is not guaranteed to be unique in the domain. If another GPO wi
 name exists in the domain an error occurs. You can use the **Guid** parameter to uniquely identify a
 GPO.
 
-You can also refer to the **Name** parameter by its built-in alias, **DisplayName**.
-For more information, see [about_Aliases](????????).
+You can also refer to the **Name** parameter by its built-in alias, **DisplayName**. For more
+information, see [about_Aliases](/powershell/module/microsoft.powershell.core/about/about_aliases).
 
 ```yaml
 Type: System.String
@@ -224,7 +231,7 @@ If you do not specify the name by using the **Server** parameter, the primary do
 (PDC) emulator is contacted.
 
 You can refer to this parameter by its built-in alias, **DC**. For more information, see
-[about_Aliases](????????).
+[about_Aliases](/powershell/module/microsoft.powershell.core/about/about_aliases).
 
 ```yaml
 Type: System.String
@@ -281,4 +288,3 @@ This cmdlet does not generate any output.
   startup or shutdown scripts, the computer account, a trust must exist between the two domains.
 
 ## RELATED LINKS
-