Partilhar via


Set-AzApiManagementPolicy

Define a política de escopo especificada para o Gerenciamento de API.

Sintaxe

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

O cmdlet Set-AzApiManagementPolicy define a política de escopo especificada para o Gerenciamento de API.

Exemplos

Exemplo 1: Definir a política de nível de locatário

$apimContext = New-AzApiManagementContext -ResourceGroupName "Api-Default-WestUS" -ServiceName "contoso"
Set-AzApiManagementPolicy -Context $apimContext -PolicyFilePath "C:\contoso\policies\tenantpolicy.xml"

Este comando define a política de nível de locatário a partir de um arquivo chamado tenantpolicy.xml.

Exemplo 2: Definir uma política de escopo do produto

$apimContext = New-AzApiManagementContext -ResourceGroupName "Api-Default-WestUS" -ServiceName "contoso"
Set-AzApiManagementPolicy -Context $apimContext -ProductId "0123456789" -Policy $PolicyString

Este comando define a política de escopo do produto para o Gerenciamento de API.

Exemplo 3: Definir política de escopo da API

$apimContext = New-AzApiManagementContext -ResourceGroupName "Api-Default-WestUS" -ServiceName "contoso"
Set-AzApiManagementPolicy -Context $apimContext -ApiId "9876543210" -Policy $PolicyString

Este comando define a política de escopo da API para o Gerenciamento de API.

Exemplo 4: Definir política de escopo de operação

$apimContext = New-AzApiManagementContext -ResourceGroupName "Api-Default-WestUS" -ServiceName "contoso"
Set-AzApiManagementPolicy -Context $apimContext -ApiId "9876543210" -OperationId "777" -Policy $PolicyString

Este comando define a política de escopo de operação para o Gerenciamento de API.

Parâmetros

-ApiId

Especifica o identificador da API existente. Se você especificar esse parâmetro, o cmdlet definirá a política de escopo da API.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ApiRevision

Identificador da revisão da API. Este parâmetro é opcional. Se não for especificado, a política será atualizada na revisão da api atualmente ativa.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Context

Especifica a instância de PsApiManagementContext.

Tipo:PsApiManagementContext
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure.

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Format

Especifica o formato da política. Ao usar application/vnd.ms-azure-apim.policy+xml, as expressões contidas na política devem ter escape de XML. Ao usá-loapplication/vnd.ms-azure-apim.policy.raw+xml, não é necessário que a política tenha escape de XML. O valor predefinido é application/vnd.ms-azure-apim.policy+xml. Este parâmetro é opcional.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-OperationId

Especifica o identificador da operação existente. Se especificado com ApiId irá definir a política de escopo de operação. Este parâmetro é obrigatório.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-PassThru

Passthru

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Policy

Especifica o documento de política como uma cadeia de caracteres. Este parâmetro é necessário se o -PolicyFilePath não for especificado.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-PolicyFilePath

Especifica o caminho do arquivo do documento de política. Este parâmetro é necessário se o parâmetro Policy não for especificado.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-PolicyUrl

A URL onde o documento de política está hospedado. Este parâmetro será necessário se -Policy ou -PolicyFilePath não for especificado.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ProductId

Especifica o identificador do produto existente. Se esse parâmetro for especificado, o cmdlet definirá a política de escopo do produto.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

Entradas

PsApiManagementContext

String

SwitchParameter

Saídas

Boolean