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

Set-AzSearchService

此 cmdlet 是 预览 模块的一部分。 不建议在生产环境中使用预览版本。 有关详细信息,请参阅 https://aka.ms/azps-refstatus

更新Azure 认知搜索服务。

语法

ResourceNameParameterSet (默认值)

Set-AzSearchService
    [-ResourceGroupName] <String>
    [-Name] <String>
    [-PartitionCount <Int32>]
    [-ReplicaCount <Int32>]
    [-PublicNetworkAccess <PSPublicNetworkAccess>]
    [-IdentityType <PSIdentityType>]
    [-IPRuleList <PSIpRule[]>]
    [-DisableLocalAuth <Boolean>]
    [-AuthOption <PSAuthOptionName>]
    [-AadAuthFailureMode <PSAadAuthFailureMode>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

InputObjectParameterSet

Set-AzSearchService
    [-InputObject] <PSSearchService>
    [-PartitionCount <Int32>]
    [-ReplicaCount <Int32>]
    [-PublicNetworkAccess <PSPublicNetworkAccess>]
    [-IdentityType <PSIdentityType>]
    [-IPRuleList <PSIpRule[]>]
    [-DisableLocalAuth <Boolean>]
    [-AuthOption <PSAuthOptionName>]
    [-AadAuthFailureMode <PSAadAuthFailureMode>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ResourceIdParameterSet

Set-AzSearchService
    [-ResourceId] <String>
    [-PartitionCount <Int32>]
    [-ReplicaCount <Int32>]
    [-PublicNetworkAccess <PSPublicNetworkAccess>]
    [-IdentityType <PSIdentityType>]
    [-IPRuleList <PSIpRule[]>]
    [-DisableLocalAuth <Boolean>]
    [-AuthOption <PSAuthOptionName>]
    [-AadAuthFailureMode <PSAadAuthFailureMode>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

Set-AzSearchService cmdlet 修改 Azure 认知搜索服务。

示例

示例 1

Set-AzSearchService -ResourceGroupName "TestAzureSearchPsGroup" -Name "pstestazuresearch01" -PartitionCount 2 -ReplicaCount 2
ResourceGroupName : TestAzureSearchPsGroup
Name              : pstestazuresearch01
Id                : /subscriptions/f9b96b36-1f5e-4021-8959-51527e26e6d3/resourceGroups/TestAzureSearchPsGroup/providers/Microsoft.Search/searchServices/pstestazuresearch01
Location          : West US
Sku               : Standard
ReplicaCount      : 2
PartitionCount    : 2
HostingMode       : Default
Tags              :

该示例将 Azure 认知搜索服务的分区计数和副本计数更改为 2。

参数

-AadAuthFailureMode

(可选)如果 Azure 认知搜索服务同时允许 API 密钥和 AAD 身份验证,则失败 AAD 身份验证时要返回的状态代码

参数属性

类型:

Nullable<T>[PSAadAuthFailureMode]

默认值:None
接受的值:Http403, Http401WithBearerChallenge
支持通配符:False
不显示:False

参数集

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

-AuthOption

(可选)是只允许 API 密钥身份验证,还是只允许 Azure 认知搜索服务的 API 密钥身份验证和 AAD 身份验证

参数属性

类型:

Nullable<T>[PSAuthOptionName]

默认值:None
接受的值:ApiKeyOnly, AadOrApiKey
支持通配符:False
不显示:False

参数集

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

-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

-DisableLocalAuth

(可选)为 Azure 认知搜索服务禁用 API 密钥身份验证(true/false/null)

参数属性

类型:

Nullable<T>[Boolean]

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

参数集

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

-IdentityType

(可选)Azure 认知搜索服务标识(无/SystemAssigned)

参数属性

类型:

Nullable<T>[PSIdentityType]

默认值:None
接受的值:None, SystemAssigned
支持通配符:False
不显示:False

参数集

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

-InputObject

搜索服务输入对象。

参数属性

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

参数集

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

-IPRuleList

(可选)Azure 认知搜索服务 IP 规则

参数属性

类型:

PSIpRule[]

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

参数集

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

-Name

搜索服务名称。

参数属性

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

参数集

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

-PartitionCount

搜索服务分区计数。

参数属性

类型:

Nullable<T>[Int32]

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

参数集

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

-PublicNetworkAccess

(可选)Azure 认知搜索服务公用网络访问(已启用/禁用)

参数属性

类型:

Nullable<T>[PSPublicNetworkAccess]

默认值:None
接受的值:Enabled, Disabled
支持通配符:False
不显示:False

参数集

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

-ReplicaCount

搜索服务副本计数。

参数属性

类型:

Nullable<T>[Int32]

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

参数集

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

-ResourceGroupName

资源组名称。

参数属性

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

参数集

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

-ResourceId

搜索服务资源 ID。

参数属性

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

参数集

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

-WhatIf

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

参数属性

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

参数集

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

CommonParameters

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

输入

PSSearchService

String

输出

PSSearchService