Merge branch 'main' into patch-140

Author: tiburd

SECURITY.md

@@ -0,0 +1,41 @@
+<!-- BEGIN MICROSOFT SECURITY.MD V0.0.8 BLOCK -->
+
+## Security
+
+Microsoft takes the security of our software products and services seriously, which includes all source code repositories managed through our GitHub organizations, which include [Microsoft](https://github.com/microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet), [Xamarin](https://github.com/xamarin), and [our GitHub organizations](https://opensource.microsoft.com/).
+
+If you believe you have found a security vulnerability in any Microsoft-owned repository that meets [Microsoft's definition of a security vulnerability](https://aka.ms/opensource/security/definition), please report it to us as described below.
+
+## Reporting Security Issues
+
+**Please do not report security vulnerabilities through public GitHub issues.**
+
+Instead, please report them to the Microsoft Security Response Center (MSRC) at [https://msrc.microsoft.com/create-report](https://aka.ms/opensource/security/create-report).
+
+If you prefer to submit without logging in, send email to [[email protected]](mailto:[email protected]).  If possible, encrypt your message with our PGP key; please download it from the [Microsoft Security Response Center PGP Key page](https://aka.ms/opensource/security/pgpkey).
+
+You should receive a response within 24 hours. If for some reason you do not, please follow up via email to ensure we received your original message. Additional information can be found at [microsoft.com/msrc](https://aka.ms/opensource/security/msrc). 
+
+Please include the requested information listed below (as much as you can provide) to help us better understand the nature and scope of the possible issue:
+
+  * Type of issue (e.g. buffer overflow, SQL injection, cross-site scripting, etc.)
+  * Full paths of source file(s) related to the manifestation of the issue
+  * The location of the affected source code (tag/branch/commit or direct URL)
+  * Any special configuration required to reproduce the issue
+  * Step-by-step instructions to reproduce the issue
+  * Proof-of-concept or exploit code (if possible)
+  * Impact of the issue, including how an attacker might exploit the issue
+
+This information will help us triage your report more quickly.
+
+If you are reporting for a bug bounty, more complete reports can contribute to a higher bounty award. Please visit our [Microsoft Bug Bounty Program](https://aka.ms/opensource/security/bounty) page for more details about our active programs.
+
+## Preferred Languages
+
+We prefer all communications to be in English.
+
+## Policy
+
+Microsoft follows the principle of [Coordinated Vulnerability Disclosure](https://aka.ms/opensource/security/cvd).
+
+<!-- END MICROSOFT SECURITY.MD BLOCK -->

docset/winserver2012r2-ps/storage/New-StorageTier.md

@@ -45,7 +45,7 @@ The **New-StorageTier** cmdlet creates a storage tier in a storage pool.
 
 ### Example 1: Create a storage tier
 ```
-PS C:\> New-StorageTier -StoragePoolFriendlyName "TierPool01" -FriendlyName "Standard_HDD_Tier" -MediaType HDD
+PS C:\> New-StorageTier -StoragePoolFriendlyName "TierPool01" -FriendlyName "Tier11" -MediaType HDD
 ```
 
 This command creates a storage tier for hard disk drives named Tier11 in the storage pool named TierPool01.

docset/winserver2016-ps/storage/New-StorageTier.md

@@ -58,7 +58,7 @@ The **New-StorageTier** cmdlet creates a storage tier in a storage pool.
 
 ### Example 1: Create a storage tier
 ```
-PS C:\> New-StorageTier -StoragePoolFriendlyName "TierPool01" -FriendlyName "Standard_HDD_Tier" -MediaType HDD
+PS C:\> New-StorageTier -StoragePoolFriendlyName "TierPool01" -FriendlyName "Tier11" -MediaType HDD
 ```
 
 This command creates a storage tier for hard disk drives named Tier11 in the storage pool named TierPool01.

docset/winserver2019-ps/storage/New-StorageTier.md

@@ -58,7 +58,7 @@ The **New-StorageTier** cmdlet creates a storage tier in a storage pool.
 
 ### Example 1: Create a storage tier
 ```
-PS C:\> New-StorageTier -StoragePoolFriendlyName "TierPool01" -FriendlyName "Standard_HDD_Tier" -MediaType HDD
+PS C:\> New-StorageTier -StoragePoolFriendlyName "TierPool01" -FriendlyName "Tier11" -MediaType HDD
 ```
 
 This command creates a storage tier for hard disk drives named Tier11 in the storage pool named TierPool01.

docset/winserver2022-ps/failoverclusters/Add-ClusterCheckpoint.md

@@ -2,7 +2,7 @@
 description: Use this topic to help manage Windows and Windows Server technologies with Windows PowerShell.
 external help file: Microsoft.FailoverClusters.PowerShell.dll-Help.xml
 Module Name: FailoverClusters
-ms.date: 10/21/2022
+ms.date: 11/22/2022
 online version: https://learn.microsoft.com/powershell/module/failoverclusters/add-clustercheckpoint?view=windowsserver2022-ps&wt.mc_id=ps-gethelp
 schema: 2.0.0
 title: Add-ClusterCheckpoint
@@ -23,7 +23,7 @@ Add-ClusterCheckpoint [[-ResourceName] <String>] [-CryptoCheckpointName <String>
 
 ## DESCRIPTION
 
-The **Add-ClusterCheckpoint** cmdlet adds a cryptographic key checkpoint or registry checkpoint for
+The `Add-ClusterCheckpoint` cmdlet adds a cryptographic key checkpoint or registry checkpoint for
 a resource.
 
 Checkpoints help provide failover support for applications that store configuration information
@@ -36,26 +36,27 @@ local server.
 
 ### Example 1: Add registry checkpoint
 
-```
-PS C:\> Add-ClusterCheckpoint -ResourceName "Cluster Name" -RegistryCheckpoint "software\clusname"
-Resource                                                    Name 
---------                                                    ---- 
-Cluster Name                                                software\clusname
+```powershell
+Add-ClusterCheckpoint -ResourceName "Cluster Name" -RegistryCheckpoint "software\clusname"
 ```
 
-This example adds a registry checkpoint called software\clusname for the resource named cluster
+This example adds a registry checkpoint called `software\clusname` for the resource named cluster
 name.
 
 ### Example 2: Add cryptographic checkpoint
 
-```
-PS C:\> Get-ClusterResource -Name "Cluster Name" | Add-ClusterCheckpoint -CryptoCheckpointName "Microsoft Base Cryptographic Provider v1.0"  -CryptoCheckpointType 1 -CryptoCheckpointKey "Crypto"
-Resource                      Name                          Type                          Key 
---------                      ----                          ----                          --- 
-Cluster Name                  Microsoft Base Cryptograph... 1                             Crypto
+```powershell
+$parameters = @{
+    CryptoCheckpointName = 'Microsoft Base Cryptographic Provider v1.0'
+    CryptoCheckpointType = '1'
+    CryptoCheckpointKey = 'Crypto'
+}
+Get-ClusterResource -Name "Cluster Name" | Add-ClusterCheckpoint @parameters
 ```
 
-This example adds a cryptographic checkpoint for the resource named Cluster Name.
+This example adds a cryptographic checkpoint for the resource named Cluster Name. This example uses
+splatting to pass parameter values from the `$Parameters` variable to the command. Learn more about
+[Splatting](/powershell/module/microsoft.powershell.core/about/about_splatting).
 
 ## PARAMETERS
 

docset/winserver2022-ps/failoverclusters/Add-ClusterDisk.md

@@ -2,7 +2,7 @@
 description: Use this topic to help manage Windows and Windows Server technologies with Windows PowerShell.
 external help file: Microsoft.FailoverClusters.PowerShell.dll-Help.xml
 Module Name: FailoverClusters
-ms.date: 10/21/2022
+ms.date: 11/22/2022
 online version: https://learn.microsoft.com/powershell/module/failoverclusters/add-clusterdisk?view=windowsserver2022-ps&wt.mc_id=ps-gethelp
 schema: 2.0.0
 title: Add-ClusterDisk
@@ -21,53 +21,43 @@ Add-ClusterDisk [-InputObject] <PSObject[]> [-Cluster <String>] [<CommonParamete
 
 ## DESCRIPTION
 
-The **Add-ClusterDisk** cmdlet makes a new disk available for use in a failover cluster. The disk
-(LUN) must be exposed to all nodes in the failover cluster, and should not be exposed to any other
+The `Add-ClusterDisk` cmdlet makes a new disk available for use in a failover cluster. The disk
+(LUN) must be exposed to all nodes in the failover cluster, and shouldn't be exposed to any other
 servers.
 
 When adding a disk, make sure that the configuration of the storage allows the operating system to
 recognize and mount the disk as needed. The disk must be a basic disk, not a dynamic disk, and
-should not be exposed to servers outside the cluster. The **Get-ClusterAvailableDisk** cmdlet gets
+shouldn't be exposed to servers outside the cluster. The `Get-ClusterAvailableDisk` cmdlet gets
 information about disks that you can add to the cluster.
 
 ## EXAMPLES
 
 ### Example 1: Add available disks to the Available Storage group
 
-```
-PS C:\> Get-ClusterAvailableDisk | Add-ClusterDisk
-Name                State               Group               ResourceType 
-----                -----               -----               ------------ 
-Cluster Disk 7      OnlinePending       Available Storage   Physical Disk 
-Cluster Disk 8      OnlinePending       Available Storage   Physical Disk
+```powershell
+Get-ClusterAvailableDisk | Add-ClusterDisk
 ```
 
 This example identifies the disks that are ready to be added to the cluster, and then adds them to
 Available Storage cluster group.
 
 ### Example 2: Add a specific available disk to Available Storage
 
-```
-PS C:\> Get-ClusterAvailableDisk | Where-Object -FilterScript { $_.ScsiAddress -Eq 50331651 } | Add-ClusterDisk
-Name                State               Group               ResourceType 
-----                -----               -----               ------------ 
-Cluster Disk 4      OnlinePending       Available Storage   Physical Disk
+```powershell
+Get-ClusterAvailableDisk | Where-Object -FilterScript { $_.ScsiAddress -Eq 50331651 } | Add-ClusterDisk
 ```
 
 This example examines disks that are ready to be added to the cluster, finds the disk with a
 specific SCSI address, and adds it to Available Storage cluster group.
 
 ### Example 3: Cluster a physical disk
 
-```
-PS C:\> Get-Disk -Number 11 | Add-ClusterDisk
-Name                          State                         OwnerGroup                    ResourceType 
-----                          -----                         ----------                    ------------ 
-Cluster Disk 5                OnlinePending                 Available Storage             Physical Disk
+```powershell
+Get-Disk -Number 11 | Add-ClusterDisk
 ```
 
-This example clusters a physical disk. This cmdlet adds a physical disk to the **Available Storage**
-for the cluster.
+This example clusters a physical disk. This cmdlet adds a physical disk to the cluster 
+_Available Storage_.
 
 ## PARAMETERS
 
@@ -91,7 +81,7 @@ Accept wildcard characters: False
 ### -InputObject
 
 Specifies the list of shared disks to add to the cluster. The list of disks is generated with the
-**Get-ClusterAvailableDisk** cmdlet.
+`Get-ClusterAvailableDisk` cmdlet.
 
 ```yaml
 Type: PSObject[]
@@ -118,7 +108,7 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
 
 ### Microsoft.Management.Infrastructure.CimInstance
 
-This object is output from the Get-Disk and the **Get-VirtualDisk** cmdlets.
+This object is output from the `Get-Disk` and the `Get-VirtualDisk` cmdlets.
 
 ### Microsoft.Management.Infrastructure.CimInstance#ROOT/Microsoft/Windows/Storage/MSFT_Disk
 

docset/winserver2022-ps/failoverclusters/Add-ClusterFileServerRole.md

@@ -2,7 +2,7 @@
 description: Use this topic to help manage Windows and Windows Server technologies with Windows PowerShell.
 external help file: Microsoft.FailoverClusters.PowerShell.dll-Help.xml
 Module Name: FailoverClusters
-ms.date: 10/21/2022
+ms.date: 11/22/2022
 online version: https://learn.microsoft.com/powershell/module/failoverclusters/add-clusterfileserverrole?view=windowsserver2022-ps&wt.mc_id=ps-gethelp
 schema: 2.0.0
 title: Add-ClusterFileServerRole
@@ -23,52 +23,44 @@ Add-ClusterFileServerRole -Storage <StringCollection> [-StaticAddress <StringCol
 
 ## DESCRIPTION
 
-The **Add-ClusterFileServerRole** cmdlet creates a clustered file server resource group that
+The `Add-ClusterFileServerRole` cmdlet creates a clustered file server resource group that
 includes one or more disks, on which shared folders can be created for users.
 
 When adding a clustered file server, specify a name for the file server, any IP address information
-that is not automatically supplied by your DHCP settings, and the storage volume or volumes that the
+that isn't automatically supplied by your DHCP settings, and the storage volume or volumes that the
 clustered file server should use.
 
-Note: This cmdlet cannot be run remotely without Credential Security Service Provider (CredSSP)
-authentication on the server computer.
+> [!NOTE]
+> This cmdlet cannot be run remotely without Credential Security Service Provider (CredSSP)
+> authentication on the server computer.
 
 ## EXAMPLES
 
 ### Example 1: Create a clustered file server
 
-```
-PS C:\> Add-ClusterFileServerRole -Storage "Cluster Disk 8"
-Name                       OwnerNode                           State 
-----                       ---------                           ----- 
-cluster1FS                 node1                              Online
+```powershell
+Add-ClusterFileServerRole -Storage "Cluster Disk 8"
 ```
 
-This example creates a clustered file server using Cluster Disk 8, and assigns a default name.
+This example creates a clustered file server using `Cluster Disk 8`, and assigns a default name.
 
 ### Example 2: Create and name a clustered file server
 
-```
-PS C:\> Add-ClusterFileServerRole -Storage "Cluster Disk 6" -Name cluster1FS12
-Name                       OwnerNode                           State 
-----                       ---------                           ----- 
-cluster1FS12               node1                              Online
+```powershell
+Add-ClusterFileServerRole -Storage "Cluster Disk 6" -Name cluster1FS12
 ```
 
-This example creates a clustered file server using Cluster Disk 6, and assigns the name
-cluster1FS12.
+This example creates a clustered file server using `Cluster Disk 6`, and assigns the name
+`cluster1FS12`.
 
 ### Example 3: Create a clustered file server with no waiting for resources
 
-```
-PS C:\> Add-ClusterFileServerRole -Storage "Cluster Disk 8" -Wait 0
-Name                       OwnerNode                           State 
-----                       ---------                           ----- 
-cluster1FS                 node1                             Pending
+```powershell
+Add-ClusterFileServerRole -Storage "Cluster Disk 8" -Wait 0
 ```
 
-This example creates a clustered file server using Cluster Disk 8, and assigns a default name. The
-cmdlet completes without waiting for all resources to come online.
+This example creates a clustered file server using `Cluster Disk 8`, and assigns a default name.
+The cmdlet completes without waiting for all resources to come online.
 
 ## PARAMETERS
 
@@ -92,8 +84,8 @@ Accept wildcard characters: False
 ### -IgnoreNetwork
 
 Specifies one or more networks to ignore when running the cmdlet. Networks with DHCP enabled are
-always included, but other networks need a static address to be specified using the *StaticAddress*
-parameter or should be explicitly ignored with this *IgnoreNetwork* parameter.
+always included, but other networks need a static address to be specified using the
+**StaticAddress** parameter or should be explicitly ignored with this **IgnoreNetwork** parameter.
 
 ```yaml
 Type: StringCollection
@@ -143,7 +135,7 @@ Accept wildcard characters: False
 
 Specifies one or more static addresses to use when running the cmdlet. Networks with DHCP enabled
 are always included, but other networks need a static address to be specified using the
-*StaticAddress* parameter or should be explicitly ignored with this *IgnoreNetwork* parameter.
+**StaticAddress** parameter or should be explicitly ignored with this **IgnoreNetwork** parameter.
 
 ```yaml
 Type: StringCollection
@@ -175,9 +167,9 @@ Accept wildcard characters: False
 
 ### -Wait
 
-Specifies the time in seconds to wait for the cmdlet. If the *Wait* parameter is not specified, then
-the cmdlet waits for completion. If `-Wait 0` is specified, then the call is initiated and the
-cmdlet returns without waiting.
+Specifies the time in seconds to wait for the cmdlet. If the **Wait** parameter isn't specified,
+then the cmdlet waits for completion. If the value `0` is specified, then the call is initiated and
+the cmdlet returns without waiting.
 
 ```yaml
 Type: Int32