Set-AzApiManagementPolicy
API Management için belirtilen kapsam ilkesini ayarlar.
Sözdizimi
Set-AzApiManagementPolicy
-Context <PsApiManagementContext>
[-Format <String>]
[-Policy <String>]
[-PolicyFilePath <String>]
[-PolicyUrl <String>]
[-PassThru]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Set-AzApiManagementPolicy
-Context <PsApiManagementContext>
[-Format <String>]
-ProductId <String>
[-Policy <String>]
[-PolicyFilePath <String>]
[-PolicyUrl <String>]
[-PassThru]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Set-AzApiManagementPolicy
-Context <PsApiManagementContext>
[-Format <String>]
-ApiId <String>
[-ApiRevision <String>]
[-Policy <String>]
[-PolicyFilePath <String>]
[-PolicyUrl <String>]
[-PassThru]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Set-AzApiManagementPolicy
-Context <PsApiManagementContext>
[-Format <String>]
-ApiId <String>
[-ApiRevision <String>]
-OperationId <String>
[-Policy <String>]
[-PolicyFilePath <String>]
[-PolicyUrl <String>]
[-PassThru]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
Set-AzApiManagementPolicy cmdlet'i API Management için belirtilen kapsam ilkesini ayarlar.
Örnekler
Örnek 1: Kiracı düzeyi ilkesini ayarlama
$apimContext = New-AzApiManagementContext -ResourceGroupName "Api-Default-WestUS" -ServiceName "contoso"
Set-AzApiManagementPolicy -Context $apimContext -PolicyFilePath "C:\contoso\policies\tenantpolicy.xml"
Bu komut, tenantpolicy.xml adlı bir dosyadan kiracı düzeyi ilkesini ayarlar.
Örnek 2: Ürün kapsamı ilkesi ayarlama
$apimContext = New-AzApiManagementContext -ResourceGroupName "Api-Default-WestUS" -ServiceName "contoso"
Set-AzApiManagementPolicy -Context $apimContext -ProductId "0123456789" -Policy $PolicyString
Bu komut API Management için ürün kapsamı ilkesini ayarlar.
Örnek 3: API kapsamı ilkesini ayarlama
$apimContext = New-AzApiManagementContext -ResourceGroupName "Api-Default-WestUS" -ServiceName "contoso"
Set-AzApiManagementPolicy -Context $apimContext -ApiId "9876543210" -Policy $PolicyString
Bu komut API Management için API kapsamı ilkesini ayarlar.
Örnek 4: İşlem kapsamı ilkesini ayarlama
$apimContext = New-AzApiManagementContext -ResourceGroupName "Api-Default-WestUS" -ServiceName "contoso"
Set-AzApiManagementPolicy -Context $apimContext -ApiId "9876543210" -OperationId "777" -Policy $PolicyString
Bu komut API Management için işlem kapsamı ilkesini ayarlar.
Parametreler
-ApiId
Mevcut API'nin tanımlayıcısını belirtir. Bu parametreyi belirtirseniz, cmdlet API kapsamı ilkesini ayarlar.
Tür: | String |
Position: | Named |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | False |
-ApiRevision
API Düzeltme tanımlayıcısı. Bu parametre isteğe bağlıdır. Belirtilmezse, ilke şu anda etkin olan API düzeltmesinde güncelleştirilir.
Tür: | String |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | False |
-Context
PsApiManagementContext örneğini belirtir.
Tür: | PsApiManagementContext |
Position: | Named |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | False |
-DefaultProfile
Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik.
Tür: | IAzureContextContainer |
Diğer adlar: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-Format
İlkenin biçimini belirtir. kullanılırken application/vnd.ms-azure-apim.policy+xml
, ilkenin içinde yer alan ifadelerin XML kaçışı olmalıdır. application/vnd.ms-azure-apim.policy.raw+xml
Kullanırken, ilkenin XML kaçışı olması gerekli değildir.
Varsayılan değer şudur: application/vnd.ms-azure-apim.policy+xml
.
Bu parametre isteğe bağlıdır.
Tür: | String |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | False |
-OperationId
Var olan işlemin tanımlayıcısını belirtir. ApiId ile belirtilirse işlem kapsamı ilkesi ayarlanır. Bu parametreler gereklidir.
Tür: | String |
Position: | Named |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | False |
-PassThru
geçiş
Tür: | SwitchParameter |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | False |
-Policy
İlke belgesini dize olarak belirtir. -PolicyFilePath belirtilmezse bu parametre gereklidir.
Tür: | String |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | False |
-PolicyFilePath
İlke belgesi dosya yolunu belirtir. İlke parametresi belirtilmezse bu parametre gereklidir.
Tür: | String |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | False |
-PolicyUrl
İlke belgesinin barındırıldığı Url. -Policy veya -PolicyFilePath belirtilmezse bu parametre gereklidir.
Tür: | String |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | False |
-ProductId
Mevcut ürünün tanımlayıcısını belirtir. Bu parametre belirtilirse, cmdlet ürün kapsamı ilkesini ayarlar.
Tür: | String |
Position: | Named |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | False |