diff --git a/src/Security/Security/help/Az.Security.md b/src/Security/Security/help/Az.Security.md index f9ce8f601f7e..bd5b67396c3f 100644 --- a/src/Security/Security/help/Az.Security.md +++ b/src/Security/Security/help/Az.Security.md @@ -72,7 +72,7 @@ Gets security contacts that were configured on this subscription Gets the location where Azure Security Center will automatically save data for the specific subscription ### [Get-AzSecurityPricing](Get-AzSecurityPricing.md) -Gets the pricing tier data for Azure Security Center for a scope. +Gets the pricing data for the Azure Defender plans enabled in Azure Security Center for a subscription. ### [Get-AzSecurityTask](Get-AzSecurityTask.md) Gets the security tasks that Azure Security Center recommends you to do in order to strengthen your security posture. @@ -135,7 +135,7 @@ Updates automatic provisioning setting Updates a security contact for a subscription. ### [Set-AzSecurityPricing](Set-AzSecurityPricing.md) -Sets the pricing of Azure Security Center tier for a scope. +Sets the pricing data for the Azure Defender plans enabled in Azure Security Center for a subscription. ### [Set-AzSecurityWorkspaceSetting](Set-AzSecurityWorkspaceSetting.md) Updates the workspace settings for the subscription. diff --git a/src/Security/Security/help/Get-AzSecurityPricing.md b/src/Security/Security/help/Get-AzSecurityPricing.md index 8f3663b720eb..be5e9bd260ca 100644 --- a/src/Security/Security/help/Get-AzSecurityPricing.md +++ b/src/Security/Security/help/Get-AzSecurityPricing.md @@ -8,65 +8,78 @@ schema: 2.0.0 # Get-AzSecurityPricing ## SYNOPSIS -Gets the pricing tier data for Azure Security Center for a scope. + +Gets the Azure Defender plans for a subscription in Azure Security Center. ## SYNTAX ### SubscriptionScope (Default) -``` + +```powershell Get-AzSecurityPricing [-DefaultProfile ] [] ``` ### SubscriptionLevelResource -``` + +```powershell Get-AzSecurityPricing -Name [-DefaultProfile ] [] ``` ### ResourceId -``` + +```powershell Get-AzSecurityPricing -ResourceId [-DefaultProfile ] [] ``` ## DESCRIPTION -Azure Security Center pricing tier is decided per scope, with this cmdlet you can get the configured pricing tiers. -Subscription pricing tier include all the resource groups under it. -Resource Group pricing tier will override the subscription pricing tier. + +You can view each Azure Defender plan, per subscription, using this cmdlet. + +For details about Azure Defender and the available plans, see [Introduction to Azure Defender](https://docs.microsoft.com/azure/security-center/azure-defender). ## EXAMPLES ### Example 1 + ```powershell PS C:\> Get-AzSecurityPricing -Id Name PricingTier --- ---- ----------- -Id--/subscriptions/fbaa2b23-e9dd-4bed-93c1-9e2a44f64bc0/providers/Microsoft.Security/pricings/VirtualMachines --- ---- ----------- -/subscriptions/fbaa2b23-e9dd-4bed-93c1-9e2a44f64bc0/providers/Microsoft.Security/pricings/SqlServers -/subscriptions/487bb485-b5b0-471e-9c0d-10717612f869/providers/Microsoft.Security/pricings/default default Standard -/subscriptions/fbaa2b23-e9dd-4bed-93c1-9e2a44f64bc0/providers/Microsoft.Security/pricings/AppServices -/subscriptions/487bb485-b5b0-471e-9c0d-10717612f869/resourceGroups/myService1/providers/Microsoft.Security/pricings/myService1 myService1 Standard -/subscriptions/fbaa2b23-e9dd-4bed-93c1-9e2a44f64bc0/providers/Microsoft.Security/pricings/StorageAccounts -/subscriptions/fbaa2b23-e9dd-4bed-93c1-9e2a44f64bc0/providers/Microsoft.Security/pricings/SqlServerVirtualMachin… -/subscriptions/fbaa2b23-e9dd-4bed-93c1-9e2a44f64bc0/providers/Microsoft.Security/pricings/KubernetesService -/subscriptions/fbaa2b23-e9dd-4bed-93c1-9e2a44f64bc0/providers/Microsoft.Security/pricings/ContainerRegistry -/subscriptions/fbaa2b23-e9dd-4bed-93c1-9e2a44f64bc0/providers/Microsoft.Security/pricings/KeyVaults +Id Name PricingTier FreeTrialRemainingTime +-- ---- ----------- ---------------------- +/subscriptions/fbaa2b23-e9dd-4bed-93c1-9e2a44f64bc0/providers/Microsoft.Security/pricings/VirtualMachines VirtualMachines Free 00:00:00 +/subscriptions/fbaa2b23-e9dd-4bed-93c1-9e2a44f64bc0/providers/Microsoft.Security/pricings/Sqlservers SqlServers Standard 00:00:00 +/subscriptions/fbaa2b23-e9dd-4bed-93c1-9e2a44f64bc0/providers/Microsoft.Security/pricings/AppServices AppServices Free 00:00:00 +/subscriptions/fbaa2b23-e9dd-4bed-93c1-9e2a44f64bc0/providers/Microsoft.Security/pricings/StorageAccounts StorageAccounts Free 00:00:00 +/subscriptions/fbaa2b23-e9dd-4bed-93c1-9e2a44f64bc0/providers/Microsoft.Security/pricings/SqlserverVirtualMachines SqlservervirtualMachines Free 00:00:00 +/subscriptions/fbaa2b23-e9dd-4bed-93c1-9e2a44f64bc0/providers/Microsoft.Security/pricings/KubernetesService KubernetesService Free 00:00:00 +/subscriptions/fbaa2b23-e9dd-4bed-93c1-9e2a44f64bc0/providers/Microsoft.Security/pricings/ContainerRegistry ContainerRegistry Free 00:00:00 +/subscriptions/fbaa2b23-e9dd-4bed-93c1-9e2a44f64bc0/providers/Microsoft.Security/pricings/KeyVaults KeyVaults Free 00:00:00 ``` -Gets all the configured pricing tiers for the subscription and the resource groups under it. +Gets the status of each Azure Defender plan for the subscription. + + ### Example 2 + ```powershell -PS C:\> Get-AzSecurityPricing -ResourceGroupName "myService1" -Id Name PricingTier --- ---- ----------- -/subscriptions/487bb485-b5b0-471e-9c0d-10717612f869/resourceGroups/myService1/providers/Microsoft.Security/pricings/myService1 myService1 Standard +PS C:\> Get-AzSecurityPricing -ResourceId ``` -Gets the configured pricing tier for the "myService1" resource group. +Gets pricing details of the specific resource ID. Where ResourceId is one of the IDs returned by `Get-AzSecurityPricing`. + +### Example 3 + +```powershell +PS C:\> Get-AzSecurityPricing -Name +``` + +Gets pricing details of the named Azure Defender plan. Where `name` is one of the names returned by `Get-AzSecurityPricing`. + ## PARAMETERS ### -DefaultProfile + The credentials, account, tenant, and subscription used for communication with Azure. ```yaml @@ -82,6 +95,7 @@ Accept wildcard characters: False ``` ### -Name + Resource name. ```yaml @@ -97,6 +111,7 @@ Accept wildcard characters: False ``` ### -ResourceId + Resource ID. ```yaml @@ -112,7 +127,8 @@ 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](http://go.microsoft.com/fwlink/?LinkID=113216). + +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216). ## INPUTS diff --git a/src/Security/Security/help/Set-AzSecurityPricing.md b/src/Security/Security/help/Set-AzSecurityPricing.md index 42a2fd217fbc..3d9c69dcf1ad 100644 --- a/src/Security/Security/help/Set-AzSecurityPricing.md +++ b/src/Security/Security/help/Set-AzSecurityPricing.md @@ -8,38 +8,48 @@ schema: 2.0.0 # Set-AzSecurityPricing ## SYNOPSIS -Sets the pricing of Azure Security Center tier for a scope. + +Enables or disables Azure Defender plans for a subscription in Azure Security Center. ## SYNTAX ### SubscriptionLevelResource (Default) -``` + +```powershell Set-AzSecurityPricing -Name -PricingTier [-DefaultProfile ] [-WhatIf] [-Confirm] [] ``` ### InputObject -``` + +```powershell Set-AzSecurityPricing -InputObject [-DefaultProfile ] [-WhatIf] [-Confirm] [] ``` ## DESCRIPTION -Sets the pricing of Azure Security Center tier for a scope. + +Enable or disable any of the Azure Defender plans for a subscription. + +For details about Azure Defender and the available plans, see [Introduction to Azure Defender](https://docs.microsoft.com/azure/security-center/azure-defender). ## EXAMPLES ### Example 1 + ```powershell PS C:\> Set-AzSecurityPricing -Name "virtualmachines" -PricingTier "Standard" ``` -Sets the subscription Azure Security Center pricing tier to "Standard" +Enables **Azure Defender for servers** for the subscription. + +"Standard" refers to the "On" state for an Azure Defender plan as shown in Azure Security Center's pricing and settings area of the Azure portal. ## PARAMETERS ### -DefaultProfile + The credentials, account, tenant, and subscription used for communication with Azure. ```yaml @@ -55,6 +65,7 @@ Accept wildcard characters: False ``` ### -InputObject + Input Object. ```yaml @@ -70,6 +81,7 @@ Accept wildcard characters: False ``` ### -Name + Resource name. ```yaml @@ -85,6 +97,7 @@ Accept wildcard characters: False ``` ### -PricingTier + Pricing Tier. ```yaml @@ -100,6 +113,7 @@ Accept wildcard characters: False ``` ### -Confirm + Prompts you for confirmation before running the cmdlet. ```yaml @@ -115,6 +129,7 @@ Accept wildcard characters: False ``` ### -WhatIf + Shows what would happen if the cmdlet runs. The cmdlet is not run. ```yaml @@ -130,6 +145,7 @@ 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](http://go.microsoft.com/fwlink/?LinkID=113216). ## INPUTS