Merge pull request #275587 from JnHs/jh-cob-pbu

scenario updates

Author: ShannonLeavitt

articles/copilot/TOC.yml

@@ -36,7 +36,7 @@
     href: troubleshoot-app-service.md
   - name: Generate Azure CLI scripts
     href: generate-cli-scripts.md
-  - name: Generate Azure PowerShell scripts
+  - name: Generate PowerShell scripts
     href: generate-powershell-scripts.md
   - name: Author API Management policies
     href: author-api-management-policies.md

articles/copilot/capabilities.md

@@ -38,7 +38,7 @@ Use Microsoft Copilot for Azure to perform many basic tasks in the Azure portal
   - [Improve Azure SQL Database-driven applications](/azure/azure-sql/copilot/copilot-azure-sql-overview#microsoft-copilot-for-azure-enhanced-scenarios)
 - Write and optimize code:
   - [Generate Azure CLI scripts](generate-cli-scripts.md)
-  - [Generate Azure PowerShell scripts](generate-powershell-scripts.md)
+  - [Generate PowerShell scripts](generate-powershell-scripts.md)
   - [Discover performance recommendations with Code Optimizations](optimize-code-application-insights.md)
   - [Author API Management policies](author-api-management-policies.md)
   - [Create Kubernetes YAML files](generate-kubernetes-yaml.md)

articles/copilot/generate-powershell-scripts.md

@@ -1,6 +1,6 @@
 ---
-title: Generate Azure PowerShell scripts using Microsoft Copilot for Azure
-description: Learn about scenarios where Microsoft Copilot for Azure can generate Azure PowerShell scripts for you to customize and use.
+title: Generate PowerShell scripts using Microsoft Copilot for Azure
+description: Learn about scenarios where Microsoft Copilot for Azure can generate PowerShell scripts for you to customize and use.
 ms.date: 05/21/2024
 ms.topic: conceptual
 ms.service: copilot-for-azure
@@ -10,24 +10,24 @@ ms.author: jenhayes
 author: JnHs
 ---
 
-# Generate Azure PowerShell scripts using Microsoft Copilot for Azure
+# Generate PowerShell scripts using Microsoft Copilot for Azure
 
-Microsoft Copilot for Azure (preview) can generate [Azure PowerShell](/powershell/azure/) scripts that you can use to create or manage resources.
+Microsoft Copilot for Azure (preview) can generate [PowerShell](/powershell/azure/) scripts that you can use to create or manage resources.
 
-When you tell Microsoft Copilot for Azure about a task you want to perform by using Azure PowerShell, it provides a script with the necessary cmdlets. You'll see which placeholder values that you need to update with the actual values based on your environment.
+When you tell Microsoft Copilot for Azure about a task you want to perform by using PowerShell, it provides a script with the necessary cmdlets. You'll see which placeholder values that you need to update with the actual values based on your environment.
 
 [!INCLUDE [scenario-note](includes/scenario-note.md)]
 
 [!INCLUDE [preview-note](includes/preview-note.md)]
 
 ## Sample prompts
 
-Here are a few examples of the kinds of prompts you can use to generate Azure PowerShell scripts. Some prompts return a single cmdlet, while others provide multiple steps walking through the full scenario. Modify these prompts based on your real-life scenarios, or try additional prompts to create different kinds of queries.
+Here are a few examples of the kinds of prompts you can use to generate PowerShell scripts. Some prompts return a single cmdlet, while others provide multiple steps walking through the full scenario. Modify these prompts based on your real-life scenarios, or try additional prompts to create different kinds of queries.
 
 - "How do I list the VMs I have running in Azure using PowerShell?"
 - "Create a storage account using PowerShell."
 - "How do I get all quota limits for a subscription using Azure PowerShell?"
-- "Can you show me how to stop all virtual machines in a specific resource group using Azure PowerShell?"
+- "Can you show me how to stop all virtual machines in a specific resource group using PowerShell?"
 
 ## Examples
 

articles/copilot/media/query-attack-surface/query-assets-inventory.png

@@ -16,6 +16,11 @@ author: JnHs
 
 [Microsoft Defender External Attack Surface Management (Defender EASM)](/azure/external-attack-surface-management/overview) scans inventory assets and collects robust contextual metadata that powers Attack Surface Insights. These insights help an organization understand what their attack surface looks like, where the risk resides, and what assets they need to focus on.
 
+> [!IMPORTANT]
+> Use of Copilot for Azure to query Defender EASM is included with Copilot for Security and requires [security compute units (SCUs)](/copilot/security/get-started-security-copilot#security-compute-units).  You can provision SCUs and increase or decrease them at any time. For more information on SCUs, see [Get started with Microsoft Copilot](/copilot/security/get-started-security-copilot) and [Manage usage of security compute units](/copilot/security/manage-usage).
+>
+> To use Copilot for Azure to query Defender EASM, you or your admin team must be a member of the appropriate role in Copilot for Security and must have access to a Defender EASM resource. For information on supported roles, see [Understand authentication in Microsoft Copilot for Security](/copilot/security/authentication).
+
 With Microsoft Copilot for Azure (preview), you can use natural language to ask questions and better understand your organization's attack surface. Through Defender EASM's extensive querying capabilities, you can extract asset metadata and key asset information, even if you don't have an advanced Defender EASM querying skillset.
 
 When you ask Microsoft Copilot for Azure about your attack surface, it automatically pulls context when possible, based on the current conversation or on the page you're viewing in the Azure portal. If the context isn't clear, you'll be prompted to specify which Defender EASM resource to use.
@@ -30,9 +35,19 @@ Here are a few examples of the kinds of prompts you can use to query attack surf
 
 - "Tell me about Defender EASM high priority attack surface insights."
 - "What are my externally facing assets?"
-- "Find all the page and host assets in my inventory with the IP address `<address>`"
+- "Find all the page and host assets in my inventory with the IP address (address)"
 - "Show me all assets that require investigation."
 - "Do I have any domains that are expiring within 30 days?"
+- "What assets are using jQuery version 3.1.0?"
+- "Get the hosts with port X open in my attack surface?"
+- "Which of my assets have a registrant email of `[email protected]`?"
+- "Which of my assets have services containing 'Azure' and vulnerabilities on them?"
+
+## Example
+
+You can use a natural language query to better understand your attack surface. In this example, the query is "**find all the page and host assets in my inventory with an ip address that is (list of IP addresses)**". Copilot for Azure queries your Defender EASM inventory and provides details about the assets matching your criteria. You can then follow up with additional questions as needed.
+
+:::image type="content" source="media/query-attack-surface/query-assets-inventory.png" alt-text="Screenshot showing Copilot in Azure providing results for a natural language attack surface query." lightbox="media/query-attack-surface/query-assets-inventory.png":::
 
 ## Next steps
 

articles/copilot/media/use-guided-deployments/aks-cluster-deployment.png

@@ -26,17 +26,35 @@ When you ask Microsoft Copilot for Azure for troubleshooting help, it automatica
 
 ## Sample prompts
 
-Here are a few examples of the kinds of prompts you can use to get help with App Service troubleshooting. Modify these prompts based on your real-life scenarios, or try additional prompts to get help with different types of issues.
+Here are a few examples of the kinds of prompts you can use to access troubleshooting tools and understand diagnostic information. Modify these prompts based on your real-life scenarios, or try additional prompts to get help with different types of issues.
+
+Troubleshooting:
 
 - "My web app is down"
-- "My web app is slow"
+- "Why is my web app slow?"
 - "Enable auto heal"
-- "Take a memory dump"
 - "High CPU issue"
 - "Troubleshoot performance issues with my app"
 - "Analyze app latency?"
+- "Take a memory dump"
+
+Understanding available tools:
+
+- "Can I track uptime and downtime of my web app over a specific time period?"
+- "Is there a tool that can help me view event logs for my web app?"
+
+Proactive practices:
+
+- "Risk alerts for my app"
+- "Are there any best practices for availability for this app?"
+- "How can I make my app future-proof"
+
+Summarization and explanation:
+
 - "Give me a summary of these diagnostics."
+- "Summarize this page."
 - "What does this error mean?"
+- "Can you tell me more about the 3rd diagnostic on this page?"
 - "What are the next steps to resolve this error?"
 
 ## Examples