你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Set-AzIotSecuritySolution

创建或更新 IoT 安全解决方案

语法

ResourceGroupLevelResource (默认值)

Set-AzIotSecuritySolution
    -Name <String>
    -ResourceGroupName <String>
    -Location <String>
    -Workspace <String>
    -DisplayName <String>
    -IotHub <String[]>
    [-Tag <Hashtable>]
    [-Enabled <Boolean>]
    [-Export <String[]>]
    [-DisabledDataSource <String[]>]
    [-UserDefinedResource <PSUserDefinedResources>]
    [-RecommendationsConfiguration <PSRecommendationConfiguration[]>]
    [-UnmaskedIpLoggingStatus <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

InputObject

Set-AzIotSecuritySolution
    -InputObject <PSIotSecuritySolution>
    -Location <String>
    -Workspace <String>
    -DisplayName <String>
    -IotHub <String[]>
    [-Tag <Hashtable>]
    [-Enabled <Boolean>]
    [-Export <String[]>]
    [-DisabledDataSource <String[]>]
    [-UserDefinedResource <PSUserDefinedResources>]
    [-RecommendationsConfiguration <PSRecommendationConfiguration[]>]
    [-UnmaskedIpLoggingStatus <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ResourceId

Set-AzIotSecuritySolution
    -ResourceId <String>
    -Location <String>
    -Workspace <String>
    -DisplayName <String>
    -IotHub <String[]>
    [-Tag <Hashtable>]
    [-Enabled <Boolean>]
    [-Export <String[]>]
    [-DisabledDataSource <String[]>]
    [-UserDefinedResource <PSUserDefinedResources>]
    [-RecommendationsConfiguration <PSRecommendationConfiguration[]>]
    [-UnmaskedIpLoggingStatus <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

Set-AzIotSecuritySolution cmdlet 创建或更新特定的 iot 安全解决方案。 IoT 安全解决方案从 iot 设备和 iot 中心收集安全数据和事件,以帮助预防和检测威胁。 iot 安全解决方案的名称应与 iot 中心的名称相同。

示例

示例 1

$Workspace = "/subscriptions/XXXXXXXX-XXXX-XXXXX-XXXX-XXXXXXXXXXXX/resourceGroups/MichalResourceGroup/providers/Microsoft.OperationalInsights/workspaces/IoTHubWorkspace"
$IotHubs = @("/subscriptions/XXXXXXXX-XXXX-XXXXX-XXXX-XXXXXXXXXXXX/resourceGroups/MichalResourceGroup/providers/Microsoft.Devices/IotHubs/MySample")
Set-AzIotSecuritySolution -Name "MySample" -ResourceGroupName "MyResourceGroup" -Location "West US" `
-Workspace $Workspace -DisplayName "MySample" -Enabled $true -IotHub $IotHubs
Id: "/subscriptions/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX/resourceGroups/MyResourceGroup/providers/Microsoft.Security/IoTSecuritySolutions/MySample"
Name: "MySample"
Type: "Microsoft.Security/IoTSecuritySolutions"
Location: "westus"
DisplayName: "MySample"
status: "Enabled"
Export: ["RawEvents"]
DisabledDataSources: ["TwinData"]
Workspace: "/subscriptions/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX/resourcegroups/MyResourceGroup/providers/microsoft.operationalinsights/workspaces/MyLA"
AdditionalWorkspaces: null
IotHubs: ["/subscriptions/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX/resourcegroups/MyResourceGroup/providers/microsoft.devices/iothubs/MySample"]
UserDefinedResources: {
	Query: ""
	QuerySubscriptions: []
}
RecommendationsConfiguration: [
{
	RecommendationType: "IoT_ACRAuthentication"
	Name: "Service prinicpal not used with ACR repository"
	Status: "Enabled"
}
{
	RecommendationType: "IoT_AgentSendsUnutilizedMessages"
	Name: "Agent sending underutilized messages"
	Status: "Enabled"
	}]
AutoDiscoveredResources: ["/subscriptions/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX/resourcegroups/MyResourceGroup/providers/microsoft.devices/iothubs/MySample"]
UnmaskedIpLoggingStatus: "Enabled"
Tags: {}

使用资源 ID“/subscriptions/XXXXXXXX-XXXX-XXXXX-XXXX-XXXXXXXXX-XXXX-XXXXXXXXXXXXXXX/resourceGroups/MichalResourceGroup/providers/Microsoft.Devices/IotHubs/MySample”为 IoT 中心创建新的 iot 安全解决方案“MySample”(解决方案的名称应与 IoT 中心的名称相同)

参数

-Confirm

在运行 cmdlet 之前,提示你进行确认。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:cf

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

参数属性

类型:IAzureContextContainer
默认值:None
支持通配符:False
不显示:False
别名:AzContext, AzureRmContext, AzureCredential

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DisabledDataSource

禁用的数据源。

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False

参数集

ResourceGroupLevelResource
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
ResourceId
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DisplayName

显示名称。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

ResourceGroupLevelResource
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
ResourceId
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Enabled

地位。

参数属性

类型:Boolean
默认值:None
支持通配符:False
不显示:False

参数集

ResourceGroupLevelResource
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
ResourceId
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Export

导出数据。

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False

参数集

ResourceGroupLevelResource
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
ResourceId
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-InputObject

输入对象。

参数属性

类型:PSIotSecuritySolution
默认值:None
支持通配符:False
不显示:False

参数集

InputObject
Position:Named
必需:True
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False

-IotHub

IoT 中心。

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False

参数集

ResourceGroupLevelResource
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
ResourceId
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Location

Location.

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

ResourceGroupLevelResource
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
ResourceId
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Name

资源名称。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

ResourceGroupLevelResource
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-RecommendationsConfiguration

建议配置。

参数属性

类型:

PSRecommendationConfiguration[]

默认值:None
支持通配符:False
不显示:False

参数集

ResourceGroupLevelResource
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
ResourceId
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ResourceGroupName

资源组名称。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

ResourceGroupLevelResource
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ResourceId

要调用其上的命令的安全资源的 ID。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

ResourceId
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-Tag

标签。

参数属性

类型:Hashtable
默认值:None
支持通配符:False
不显示:False

参数集

ResourceGroupLevelResource
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
ResourceId
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-UnmaskedIpLoggingStatus

未屏蔽的 IP 日志记录状态。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

ResourceGroupLevelResource
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
ResourceId
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-UserDefinedResource

用户定义的资源。

参数属性

类型:PSUserDefinedResources
默认值:None
支持通配符:False
不显示:False

参数集

ResourceGroupLevelResource
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
ResourceId
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 命令脚本未运行。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:无线

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Workspace

工作区 ID。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

ResourceGroupLevelResource
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
ResourceId
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters

输入

PSIotSecuritySolution

String

Hashtable

String

PSUserDefinedResources

PSRecommendationConfiguration

输出

PSIotSecuritySolution