Merge pull request #26719 from MicrosoftDocs/main

padmagit77 · web-flow · commit 645b818f3d1b · 2024-10-10T11:09:03.000+05:30
Publish main to live, Thursday 11:00 PM IST, 10/10
diff --git a/microsoft-365/admin/add-users/about-admin-roles.md b/microsoft-365/admin/add-users/about-admin-roles.md
@@ -76,7 +76,7 @@ You'll probably only need to assign the following roles in your organization. By
 
 |Admin role     |Who should be assigned this role?  |
 |---------|---------|
-|Billing admin     |   Assign the Billing admin role to users who make purchases, manage subscriptions and service requests, and monitor service health. <br><br> Billing admins also can:<br> &bull; Manage all aspects of billing<br> &bull; Create and manage support tickets in the Azure portal <br/><br/> **Note:** Only Global admins can view and manage subscriptions purchased through a Partner.|
+|Billing admin     |   Assign the Billing admin role to users who make purchases, manage subscriptions and service requests, and monitor service health. Billing admins cannot assign licenses; If a Billing admin is also a License or User Administrator, visit [Licenses](https://go.microsoft.com/fwlink/p/?linkid=842264) to assign licenses.<br><br> Billing admins also can:<br> &bull; Manage all aspects of billing<br> &bull; Create and manage support tickets in the Azure portal <br/><br/> **Note:** Only Global admins can view and manage subscriptions purchased through a Partner.|
 |Exchange admin     |   Assign the Exchange admin role to users who need to view and manage your user's email mailboxes, Microsoft 365 groups, and Exchange Online. <br><br> Exchange admins can also:<br> &bull; Recover deleted items in a user's mailbox <br> &bull; Set up "Send As" and "Send on behalf" delegates <br>  |
 |Fabric admin |   Assign the Fabric admin role to users who need to do the following: <br> &bull; Manage all admin features for Microsoft Fabric and Power BI <br> &bull; Report on usage and performance <br> &bull; Review and manage auditing  |
 |Global admin     |   Giving too many users global access is a security risk and we recommend that you have as few global admins as possible. <br/><br/> Only global admins can:<br> &bull; Reset passwords for all users <br> &bull; Add and manage domains <br> &bull; Unblock another global admin <br/><br/> **Note:**   The person who signed up for Microsoft online services automatically becomes a Global admin. |
diff --git a/microsoft-365/commerce/subscriptions/allowselfservicepurchase-powershell.md b/microsoft-365/commerce/subscriptions/allowselfservicepurchase-powershell.md
@@ -23,7 +23,7 @@ search.appverid:
 - MET150
 description: "Learn how to use the AllowSelfServicePurchase PowerShell cmdlet to turn self-service purchase on or off."
 ROBOTS: NOINDEX, NOFOLLOW
-ms.date: 05/21/2024
+ms.date: 10/10/2024
 ---
 
 # Use AllowSelfServicePurchase for the MSCommerce PowerShell module
@@ -34,21 +34,25 @@ You can also manage **AllowSelfServicePurchase** settings in the Microsoft 365 a
 
 You can use the **MSCommerce** PowerShell module to:
 
-- View the default state of the **AllowSelfServicePurchase** parameter value&mdash;whether it's enabled, disabled, or allows trials without a payment method
-- View a list of applicable products and whether self-service purchase is enabled, disabled, or allows trials without a payment method
+- View the default state of the **AllowSelfServicePurchase** parameter value
+- View a list of applicable products and their **AllowSelfServicePurchase** parameter value
 - View or modify the current setting for a specific product to either enable or disable it
-- View or modify the setting for trials without payment methods
+- For Microsoft products only: view or modify the setting for trials without payment methods
 
 ## Requirements
 
 To use the **MSCommerce** PowerShell module, you need:
 
 - A Windows 10 or later operating system.
-- PowerShell 5 or below. Currently, PowerShell 6.x/7.x isn't supported with this module.
-- The Global or Billing admin role for your tenant to change the **MSCommerce** product policies.
+- The Global or Billing Administrator role for your tenant to change the **MSCommerce** product policies.
+    [!INCLUDE [ga-roles-limitation](../../includes/ga-roles-limitation.md)]
 - The Global reader role for your tenant to see a read-only list of **MSCommerce** product policies.
 
-## Install the MSCommerce PowerShell module
+## Get started with the MSCommerce PowerShell module
+
+To get started using the **MSCommerce** PowerShell module, you must install it, import it into a PowerShell session, and then connect to it with your credentials.
+
+### Install the MSCommerce PowerShell module
 
 You install the **MSCommerce** PowerShell module on your Windows 10 device once and then import it into each PowerShell session you start. Download the **MSCommerce** PowerShell module from the [PowerShell Gallery](https://aka.ms/allowselfservicepurchase-powershell-gallery).
 
@@ -58,15 +62,15 @@ To install the **MSCommerce** PowerShell module with **PowerShellGet**, run the
 Install-Module -Name MSCommerce
 ```
 
-## Import MSCommerce into the PowerShell session
+### Import MSCommerce into the PowerShell session
 
 After you install the module on your Windows 10 device, you then import it into each PowerShell session that you start. To import it into a PowerShell session, run the following command:
 
 ```powershell
 Import-Module -Name MSCommerce
 ```
 
-## Connect to MSCommerce with your credentials
+### Connect to MSCommerce with your credentials
 
 To connect to the PowerShell module with your credentials, run the following command.
 
@@ -84,15 +88,19 @@ To view a description of the **AllowSelfServicePurchase** parameter value and th
 Get-MSCommercePolicy -PolicyId AllowSelfServicePurchase
 ```
 
-## View a list of self-service purchase products and their status
+## Use AllowSelfServicePurchase with Microsoft products
+
+This section contains information about how to view a list of Microsoft products for self-service purchase, their current status, and how to set the status. For information about third-party offer types, see [Use AllowSelfServicePurchase with third-party offer types](#use-allowselfservicepurchase-with-third-party-offer-types).
+
+### View a list of self-service purchase Microsoft products and their status
 
-To view a list of all available self-service purchase products and the status of each, run the following command:
+To view a list of available self-service purchase Microsoft products and the status of each, run the following command:
 
 ```powershell
 Get-MSCommerceProductPolicies -PolicyId AllowSelfServicePurchase
 ```
 
-The following table lists the available products and their **ProductId**. It also indicates which products have a trial available and don't require a payment method. If applicable, all other trials require a payment method. For the products that have trial without payment method enabled, you can enable the trial, while keeping the ability to purchase the product disabled. For sample commands, see View or set the status for **AllowSelfServicePurchase**.
+The following table lists the available products and their **ProductId**. It also indicates which products have a trial available and don't require a payment method. If applicable, all other trials require a payment method. For the products that have trial without payment method enabled, you can enable the trial, while keeping the ability to purchase the product disabled. For sample commands, see [View or set the status for AllowSelfServicePurchase for Microsoft products](#view-or-set-the-status-for-allowselfservicepurchase-for-microsoft-products).
 
 | Product | ProductId | Is trial without payment method enabled? |
 |-----------------------------|--------------|--------------|
@@ -114,64 +122,83 @@ The following table lists the available products and their **ProductId**. It als
 | Visio Plan 2* | CFQ7TTC0HD32 | No |
 | Viva Goals (self-service trials only) | CFQ7TTC0PW0V | Yes |
 
-*These IDs have changed. If you previously blocked products using the old IDs, they're automatically blocked using the new IDs. No other work is required.
+*These items are updated IDs. If you previously blocked products using the old IDs, they're automatically blocked using the new IDs. No other work is required.
 
-## View a list of self-service purchase "third party offer types" and their status
+### View or set the status for AllowSelfServicePurchase for Microsoft products
 
-To view a list of all available self-service purchase third-party offer types and the status of each, run the following command:
-
-```powershell
-Get-MSCommerceProductPolicies -PolicyId AllowSelfServicePurchase -Scope OfferType
-```
-
-The following table lists the available third-party offer types. These offer types can be enabled or disabled for self-service purchase.
-
-| Offer Type| ID |
-|-----------------------------|--------------|
-| Software as a Service | SaaS |
-| Power BI Visuals | POWERBIVISUALS |
-| Dynamics 365 Dataverse Apps | DYNAMICSCE |
-| Dynamics 365 Business Central | DYNAMICSBC |
-
-## View or set the status for AllowSelfServicePurchase
-
-You can set the **Value** parameter for **AllowSelfServicePurchase** to allow or prevent users from making a self-service purchase. You can also use the **OnlyTrialsWithoutPaymentMethod** value to allow users to try products that have no payment required trials. Refer to the product list above to see which products have these trials enabled. Users can only buy the product after the trial is over if **AllowSelfServicePurchase** is enabled.
+You can set the **Value** parameter for **AllowSelfServicePurchase** to allow or prevent users from making a self-service purchase of a Microsoft product. You can also use the **OnlyTrialsWithoutPaymentMethod** value to allow users to try products that have no payment required trials. To see which products have these trials enabled, see the product list in [View a list of self-service purchase Microsoft products and their status](#view-a-list-of-self-service-purchase-microsoft-products-and-their-status). Users can only buy the product after the trial is over if **AllowSelfServicePurchase** is enabled.
 
 > [!NOTE]
 > Changing the value for **AllowSelfServicePurchase** or **OnlyTrialsWithoutPaymentMethod** only impacts trials or purchases made for the specified product from that point forward. Existing trials or purchases for the specified product aren't affected.
 
 The following table describes the settings for the **Value** parameter.
 
-| Setting | Impact |
+| Setting | Outcome |
 |---|---|
 | Enabled | Users can make self-service purchases and acquire trials for the product. |
 | OnlyTrialsWithoutPaymentMethod | Users can't make self-service purchases but can acquire free trials for products that don't require them to add a payment method. After the trial expires, a user can't buy the paid version of the product. |
 | Disabled | Users can't make self-service purchases or acquire trials for the product. |
 
+Use the following commands to get or set policy settings, where ```<ProductID>``` is the string associated with the product name.
+
 To get the policy setting for a specific product, run the following command:
 
 ```powershell
-Get-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -ProductId CFQ7TTC0KP0N
+Get-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -ProductId ```<ProductID>```
 ```
 
 To enable the policy setting for a specific product, run the following command:
 
 ```powershell
-Update-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -ProductId CFQ7TTC0KP0N -Value "Enabled"
+Update-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -ProductId <ProductID> -Value "Enabled"
 ```
 
 To disable the policy setting for a specific product, run the following command:
 
 ```powershell
-Update-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -ProductId CFQ7TTC0KP0N -Value "Disabled"
+Update-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -ProductId <ProductID> -Value "Disabled"
 ```
 
 To allow users to try a specific product without a payment method, run the following command:
 
 ```powershell
-Update-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -ProductId CFQ7TTC0KP0N -Value "OnlyTrialsWithoutPaymentMethod" 
+Update-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -ProductId <ProductID> -Value "OnlyTrialsWithoutPaymentMethod" 
+```
+
+## Use AllowSelfServicePurchase with third-party offer types
+
+This section contains information about how to view a list of self-service purchase for third-party offer types and their status, and how to set the status.
+
+### View a list of self-service purchase third-party offer types and their status
+
+To view a list of all available self-service purchase third-party offer types and the status of each, run the following command:
+
+```powershell
+Get-MSCommerceProductPolicies -PolicyId AllowSelfServicePurchase -Scope OfferType
 ```
 
+The following table lists the available third-party offer types. These offer types can be enabled or disabled for self-service purchase.
+
+| Offer Type| ID |
+|-----------------------------|--------------|
+| Software as a Service | SaaS |
+| Power BI Visuals | POWERBIVISUALS |
+| Dynamics 365 Dataverse Apps | DYNAMICSCE |
+| Dynamics 365 Business Central | DYNAMICSBC |
+
+### View or set the status for AllowSelfServicePurchase for third-party offer types
+
+You can set the **Value** parameter for **AllowSelfServicePurchase** to allow or prevent users from making a self-service purchase of a third-party offer type.
+
+The following table describes the settings for the **Value** parameter.
+
+| Setting | Outcome |
+|---|---|
+| Enabled | Users can make self-service purchases and acquire trials for the product. |
+| Disabled | Users can't make self-service purchases or acquire trials for the product. |
+
+Use the following commands to get or set policy settings, where `<ID>` is the string associated with the offer type.
+
 To get the policy setting for a specific third-party offer type, run the following command:
 
 ```powershell
@@ -204,24 +231,20 @@ Update-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -ProductId $pr
 If there are multiple values for the product, you can run the command individually for each value as shown in the following example:
 
 ```powershell
-Update-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -ProductId $product[0].ProductID -Value "Disabled"
+foreach ($id in $product.ProductID) {UpdateUpdate-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -ProductId $product[0].ProductID -Value "Disabled"
 Update-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -ProductId $product[1].ProductID -Value "Disabled"
-Update-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -OfferType SaaS -Value "Disabled"
+Update-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -OfferType SaaS -Value "Disabled"}
 ```
 
-## Troubleshooting
-
-### Problem
+## Troubleshoot HandleError: Failed to retrieve policy with PolicyId 'AllowSelfServicePurchase'
 
-You see the following error message:
+In some cases, you might see the following error message:
 
 > HandleError : Failed to retrieve policy with PolicyId 'AllowSelfServicePurchase', ErrorMessage - The underlying connection was closed: An unexpected error occurred on a send.
 
-This error might be due to an older version of Transport Layer Security (TLS). When you connect to this service, you must use TLS 1.2 or greater
-
-### Solution
+This error might be due to an older version of Transport Layer Security (TLS). When you connect to this service, you must use TLS 1.2 or greater.
 
-Upgrade to TLS 1.2. The following syntax updates the ServicePointManager Security Protocol to allow TLS1.2:
+To resolve this error, upgrade to TLS 1.2. The following syntax updates the ServicePointManager Security Protocol to allow TLS1.2:
 
 ```powershell
 [Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12
diff --git a/microsoft-365/commerce/subscriptions/manage-self-service-purchases-admins.md b/microsoft-365/commerce/subscriptions/manage-self-service-purchases-admins.md
@@ -121,7 +121,7 @@ You can use the Microsoft 365 admin center to manage self-service purchases and
 The **MSCommerce** PowerShell module includes a **PolicyID** parameter value for **AllowSelfServicePurchase**. This parameter lets you control whether users in your organization can make purchases or start trials, and for which products. The module lets you do the same tasks available in the Microsoft 365 admin center, only from the command line. In addition, the module lets you view the default state of the **AllowSelfServicePurchase** parameter value for each product.
 
 > [!IMPORTANT]
-> When you use the **AllowSelfServicePurchase** policy, it controls both purchases and trials. For a list of the products available, see [View a list of self-service purchase products and their status](allowselfservicepurchase-powershell.md#view-a-list-of-self-service-purchase-products-and-their-status).
+> When you use the **AllowSelfServicePurchase** policy, it controls both purchases and trials. For a list of the products available, see [View a list of self-service purchase Microsoft products and their status](allowselfservicepurchase-powershell.md#view-a-list-of-self-service-purchase-microsoft-products-and-their-status).
 
 For more information, see [Use AllowSelfServicePurchase for the MSCommerce PowerShell module](allowselfservicepurchase-powershell.md).
 
diff --git a/microsoft-365/syntex/syntex-licensing.md b/microsoft-365/syntex/syntex-licensing.md
@@ -54,7 +54,7 @@ More Syntex services will be added as they become available.
 
 ### Feature limited preview
 
-Pay-as-you-go licensing includes access to additional Syntex features for a limited time as a preview. The feature limited preview ends September 20, 2024. You won't be charged on a pay-as-you-go basis during the preview. These features include:
+Pay-as-you-go licensing includes access to additional Syntex features for a limited time as a preview. The feature limited preview ends December 31, 2024. You won't be charged on a pay-as-you-go basis during the preview. These features include:
 
 - Content query
 - Universal annotations
