Note
Access to this page requires authorization. You can try signing in or .
Access to this page requires authorization. You can try .
New-AzSearchService
- Preview
- Module:
- Az.Search Module
This cmdlet is part of a Preview module. Preview versions aren't recommended for use in production environments. For more information, see https://aka.ms/azps-refstatus.
Creates an Azure AI Search service.
Syntax
Default (Default)
New-AzSearchService
[-ResourceGroupName] <String>
[-Name] <String>
[-Sku] <PSSkuName>
[-Location] <String>
[-PartitionCount <Int32>]
[-ReplicaCount <Int32>]
[-HostingMode <PSHostingMode>]
[-PublicNetworkAccess <PSPublicNetworkAccess>]
[-IdentityType <PSIdentityType>]
[-IPRuleList <PSIpRule[]>]
[-DisableLocalAuth <Boolean>]
[-AuthOption <PSAuthOptionName>]
[-AadAuthFailureMode <PSAadAuthFailureMode>]
[-SemanticSearchMode <PSSemanticSearchMode>]
[-ComputeType <PSComputeType>]
[-DataExfiltrationProtectionList <PSDataExfiltrationProtection[]>]
[-Bypass <PSSearchBypass>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
The New-AzSearchService cmdlet creates an Azure AI Search service with specified parameters.
Examples
Example 1
New-AzSearchService -ResourceGroupName "TestAzureSearchPsGroup" -Name "pstestazuresearch01" -Sku "Standard" -Location "West US" -PartitionCount 1 -ReplicaCount 1 -HostingMode Default
ResourceGroupName : TestAzureSearchPsGroup
Name : pstestazuresearch01
Id : /subscriptions/f9b96b36-1f5e-4021-8959-51527e26e6d3/resourceGroups/TestAzureSearchPsGroup/providers/Microsoft.Search/searchServices/pstestazuresearch01
Location : West US
Sku : Standard
ReplicaCount : 1
PartitionCount : 1
HostingMode : Default
Tags :
The command creates an Azure AI Search service.
Parameters
-AadAuthFailureMode
(Optional) What status code to return when failing AAD authentication, if both api key and AAD authentication are allowed for the Azure AI Search service
Parameter properties
| Type: | |
| Default value: | None |
| Accepted values: | Http403, Http401WithBearerChallenge |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-AuthOption
(Optional) Whether to only allow API key authentication or both API key authentication and AAD authentication for the Azure AI Search service
Parameter properties
| Type: | |
| Default value: | None |
| Accepted values: | ApiKeyOnly, AadOrApiKey |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-Bypass
(Optional) Possible origins of inbound traffic that can bypass the rules defined in the 'ipRules' section
Parameter properties
| Type: | |
| Default value: | None |
| Accepted values: | None, AzureServices |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-ComputeType
(Optional) Option to support the search service using either the Default Compute or Azure Confidential Compute
Parameter properties
| Type: | |
| Default value: | None |
| Accepted values: | Default, Confidential |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-Confirm
Prompts you for confirmation before running the cmdlet.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | cf |
Parameter sets
-DataExfiltrationProtectionList
(Optional) A list of data exfiltration scenarios that are explicitly disallowed for the search service
Parameter properties
| Type: | |
| Default value: | None |
| Accepted values: | BlockAll |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-DefaultProfile
The credentials, account, tenant, and subscription used for communication with Azure.
Parameter properties
| Type: | IAzureContextContainer |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
Parameter sets
-DisableLocalAuth
(Optional) Disable API key authentication for the Azure AI Search service (true/false/null)
Parameter properties
| Type: | |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-HostingMode
Azure AI Search Service hosting mode.
Parameter properties
| Type: | |
| Default value: | None |
| Accepted values: | Default, HighDensity |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-IdentityType
(Optional) Azure AI Search Service Identity (None/SystemAssigned)
Parameter properties
| Type: | |
| Default value: | None |
| Accepted values: | None, SystemAssigned, UserAssigned, SystemAssignedUserAssigned |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-IPRuleList
(Optional) Azure AI Search Service IP rules
Parameter properties
| Type: | PSIpRule[] |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-Location
Azure AI Search Service location.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-Name
Azure AI Search Service name.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-PartitionCount
Azure AI Search Service partition count.
Parameter properties
| Type: | |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-PublicNetworkAccess
(Optional) Azure AI Search Service public network access (Enabled/Disabled)
Parameter properties
| Type: | |
| Default value: | None |
| Accepted values: | Enabled, Disabled, SecuredByPerimeter |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-ReplicaCount
Azure AI Search Service replica count.
Parameter properties
| Type: | |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-ResourceGroupName
Resource Group name.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-SemanticSearchMode
(Optional) Option to control the availability of semantic search. This configuration is only possible for certain Azure AI Search SKUs in certain locations
Parameter properties
| Type: | |
| Default value: | None |
| Accepted values: | Disabled, Free, Standard |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-Sku
Azure AI Search Service Sku.
Parameter properties
| Type: | PSSkuName |
| Default value: | None |
| Accepted values: | Free, Basic, Standard, Standard2, Standard3, Storage_Optimized_L1, Storage_Optimized_L2 |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | wi |
Parameter sets
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.
Inputs
None
Outputs
PSSearchService
Related Links
Azure PowerShell
Feedback
Was this page helpful?