diff --git a/.openpublishing.redirection.dsc.json b/.openpublishing.redirection.dsc.json index 47a7576c0569..f3fd4b4c43d8 100644 --- a/.openpublishing.redirection.dsc.json +++ b/.openpublishing.redirection.dsc.json @@ -1,10 +1,5 @@ { "redirections": [ - { - "redirect_document_id": false, - "redirect_url": "/powershell/module/psdesiredstateconfiguration/about/about_classes_and_dsc?view=dsc-1.1", - "source_path": "reference/5.1/psdesiredstateconfiguration/about/about_classes_and_dsc.md" - }, { "redirect_document_id": true, "redirect_url": "/powershell/module/psdesiredstateconfiguration/disable-dscdebug?view=dsc-1.1", @@ -90,11 +85,6 @@ "redirect_url": "/powershell/module/psdesiredstateconfiguration/update-dscconfiguration?view=dsc-1.1", "source_path": "reference/5.1/psdesiredstateconfiguration/update-dscconfiguration.md" }, - { - "redirect_document_id": false, - "redirect_url": "/powershell/module/psdesiredstateconfiguration/about_classes_and_dsc?view=dsc-2.0", - "source_path": "reference/7.2/psdesiredstateconfiguration/about/about_classes_and_dsc.md" - }, { "redirect_document_id": false, "redirect_url": "/powershell/module/psdesiredstateconfiguration/get-dscresource?view=dsc-2.0", diff --git a/reference/7.4/Microsoft.PowerShell.Utility/New-Guid.md b/reference/7.4/Microsoft.PowerShell.Utility/New-Guid.md index fd33dd95bdd9..7f31e0c8afb0 100644 --- a/reference/7.4/Microsoft.PowerShell.Utility/New-Guid.md +++ b/reference/7.4/Microsoft.PowerShell.Utility/New-Guid.md @@ -2,7 +2,7 @@ external help file: Microsoft.PowerShell.Commands.Utility.dll-Help.xml Locale: en-US Module Name: Microsoft.PowerShell.Utility -ms.date: 10/04/2021 +ms.date: 08/28/2023 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.utility/new-guid?view=powershell-7.4&WT.mc_id=ps-gethelp schema: 2.0.0 title: New-Guid @@ -14,10 +14,21 @@ Creates a GUID. ## SYNTAX +### Default (Default) ``` New-Guid [] ``` +### Empty +``` +New-Guid [-Empty] [] +``` + +### InputObject +``` +New-Guid [-InputObject ] [] +``` + ## DESCRIPTION The `New-Guid` cmdlet creates a random globally unique identifier (GUID). If you need a unique ID in @@ -25,7 +36,7 @@ a script, you can create a GUID, as needed. ## EXAMPLES -### Example 1: Create a GUID +### Example 1: Create a new GUID ```powershell New-Guid @@ -34,13 +45,93 @@ New-Guid This command creates a random GUID. Alternatively, you could store the output of this cmdlet in a variable to use elsewhere in a script. +### Example 2: Create an empty GUID + +```powershell +New-Guid -Empty +``` + +```Output +Guid +---- +00000000-0000-0000-0000-000000000000 +``` + +### Example 3: Create a GUID from a string + +This example converts a string that contains a GUID to a GUID object. + +```powershell +New-Guid -InputObject "d61bbeca-0186-48fa-90e1-ff7aa5d33e2d" +``` + +```Output +Guid +---- +d61bbeca-0186-48fa-90e1-ff7aa5d33e2d +``` + +### Example 4: Convert strings from the pipeline to GUIDs + +This examples converts strings from the pipeline to GUID objects. + +```powershell +$guidStrings = ( +'11c43ee8-b9d3-4e51-b73f-bd9dda66e29c', +'0f8fad5bd9cb469fa16570867728950e', +'{0x01234567, 0x89ab, 0xcdef,{0x01,0x23,0x45,0x67,0x89,0xab,0xcd,0xef}}' +) +$guidStrings | New-Guid +``` + +```Output +Guid +---- +11c43ee8-b9d3-4e51-b73f-bd9dda66e29c +0f8fad5b-d9cb-469f-a165-70867728950e +01234567-89ab-cdef-0123-456789abcdef +``` + ## PARAMETERS +### -Empty + +Indicates that this cmdlet creates an empty GUID. An empty GUID has all zeros in its string. + +```yaml +Type: System.Management.Automation.SwitchParameter +Parameter Sets: Empty +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -InputObject + +This parameter accepts a string representing a GUID and converts it to a GUID object. + +```yaml +Type: System.String +Parameter Sets: InputObject +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: True (ByValue) +Accept wildcard characters: False +``` + ### CommonParameters This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, --WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](../Microsoft.PowerShell.Core/About/about_CommonParameters.md). +-WarningAction, and -WarningVariable. For more information, see +[about_CommonParameters](../Microsoft.PowerShell.Core/About/about_CommonParameters.md). ## INPUTS @@ -52,4 +143,8 @@ This cmdlet returns a GUID. ## NOTES +The cmdlet passes string input to the constructor of the **System.Guid** class. The constructor +support strings in several formats. For more information, see +[System.Guid(String)](/dotnet/api/system.guid.-ctor?view=net-7.0#system-guid-ctor(system-string)). + ## RELATED LINKS diff --git a/reference/docs-conceptual/windows-powershell/wmf/overview.md b/reference/docs-conceptual/windows-powershell/wmf/overview.md index 8219b8ac8342..615c11c62d2a 100644 --- a/reference/docs-conceptual/windows-powershell/wmf/overview.md +++ b/reference/docs-conceptual/windows-powershell/wmf/overview.md @@ -1,6 +1,6 @@ --- description: WMF is a prerequisite for Windows PowerShell. This articles shows the history of WMF versions and provides information about how to find and install WMF. -ms.date: 10/25/2022 +ms.date: 08/26/2023 title: Windows Management Framework (WMF) --- @@ -27,46 +27,43 @@ WMF installation adds and/or updates the following features: To learn about various enhancements in PowerShell and other components of a given WMF, please refer to the links below to review the release notes: -- [WMF 5.1][09] -- [WMF 5.0][08] +- [WMF 5.1][08] +- [WMF 5.0][07] ## WMF availability across Windows operating systems -| OS Version | End of Support | [WMF 5.1][04] | WMF 5.0
_Out of support_ | WMF 4.0
_Out of support_ | WMF 3.0
_Out of support_ | WMF 2.0
_Out of support_ | -| -------------------------- | ---------------- | ------------- | --------------------------- | --------------------------- | --------------------------- | --------------------------- | -| Windows Server 2022 | | Ships in-box | | | | | -| Windows Server 2019 | | Ships in-box | | | | | -| Windows Server 2016 | Jan 12, 2027 | Ships in-box | | | | | -| Windows 11 | | Ships in-box | | | | | -| Windows 10 | | Ships in-box | Ships in-box | | | | -| Windows Server 2012 R2 | Oct 10, 2023 | Yes | Yes | Ships in-box | | | -| Windows 8.1 | Jan 10, 2023 | Yes | Yes | Ships in-box | | | -| Windows Server 2012 | Oct 10, 2023 | Yes | Yes | Yes | Ships in-box | | -| Windows 8 | _Out of support_ | | | | Ships in-box | | -| Windows Server 2008 R2 SP1 | _Out of support_ | Yes | Yes | Yes | Yes | Ships in-box | -| Windows 7 SP1 | _Out of support_ | Yes | Yes | Yes | Yes | Ships in-box | -| Windows Server 2008 SP2 | _Out of support_ | | | | Yes | Yes | -| Windows Vista | _Out of support_ | | | | | Yes | -| Windows Server 2003 | _Out of support_ | | | | | Yes | -| Windows XP | _Out of support_ | | | | Yes | Yes | +| OS Version | End of Support | WMF 5.1 | WMF 5.0
_Out of support_ | WMF 4.0
_Out of support_ | WMF 3.0
_Out of support_ | WMF 2.0
_Out of support_ | +| -------------------------- | ---------------------- | ------------ | --------------------------- | --------------------------- | --------------------------- | --------------------------- | +| Windows Server 2022 | [2031-10-14][04] | Ships in-box | | | | | +| Windows Server 2019 | [2029-01-09][04] | Ships in-box | | | | | +| Windows Server 2016 | [2027-01-11][04] | Ships in-box | | | | | +| Windows 11 | [2025-10-14][03] | Ships in-box | | | | | +| Windows 10 | [2025-10-14][03] | Ships in-box | Ships in-box | | | | +| Windows Server 2012 R2 | [2023-10-10][02] | [Yes][05] | Yes | Ships in-box | | | +| Windows 8.1 | [_Out of support_][02] | [Yes][05] | Yes | Ships in-box | | | +| Windows Server 2012 | [2023-10-10][02] | [Yes][05] | Yes | Yes | Ships in-box | | +| Windows 8 | [_Out of support_][01] | | | | Ships in-box | | +| Windows Server 2008 R2 SP1 | [_Out of support_][01] | [Yes][05] | Yes | Yes | Yes | Ships in-box | +| Windows 7 SP1 | [_Out of support_][01] | [Yes][05] | Yes | Yes | Yes | Ships in-box | +| Windows Server 2008 SP2 | [_Out of support_][01] | | | | Yes | Yes | +| Windows Vista | [_Out of support_][01] | | | | | Yes | +| Windows Server 2003 | [_Out of support_][01] | | | | | Yes | +| Windows XP | [_Out of support_][01] | | | | Yes | Yes | - **Ships in-box**: The features of the specified version of WMF were shipped in the indicated version of Windows client or Windows Server. - **Out of support**: These products are no longer supported by Microsoft. You must upgrade to a - supported version. For more information, see the [Microsoft Lifecycle Policy][07] page. + supported version. For more information, see the [Microsoft Lifecycle Policy][06] page. > [!NOTE] > The installer for WMF 4.0 is no longer available or supported. -[04]: https://aka.ms/wmf51download -[07]: https://support.microsoft.com/lifecycle -[08]: whats-new/release-notes.md#wmf-50-changes -[09]: whats-new/release-notes.md#wmf-51-changes - +[01]: /lifecycle/products/?products=windows +[02]: /windows/release-health/status-windows-8.1-and-windows-server-2012-r2 +[03]: /windows/release-health/supported-versions-windows-client +[04]: /windows/release-health/windows-server-release-info +[05]: https://aka.ms/wmf51download +[06]: https://support.microsoft.com/lifecycle +[07]: whats-new/release-notes.md#wmf-50-changes +[08]: whats-new/release-notes.md#wmf-51-changes