Bagikan melalui

Add-AzApiManagementRegion

  • Referensi
Modul:
Az.ApiManagement

Menambahkan wilayah penyebaran baru ke instans PsApiManagement.

Sintaks

Add-AzApiManagementRegion
   -ApiManagement <PsApiManagement>
   -Location <String>
   [-Sku <PsApiManagementSku>]
   [-Capacity <Int32>]
   [-VirtualNetwork <PsApiManagementVirtualNetwork>]
   [-Zone <String[]>]
   [-DisableGateway <Boolean>]
   [-PublicIpAddressId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Deskripsi

Cmdlet Add-AzApiManagementRegion menambahkan instans baru jenis PsApiManagementRegion ke koleksi AdditionalRegions dari instans yang disediakan dari jenis Microsoft.Azure.Commands.ApiManagement.Models.PsApiManagement. Cmdlet ini tidak menyebarkan apa pun dengan sendirinya tetapi memperbarui instans PsApiManagement dalam memori. Untuk memperbarui penyebaran API Management, lewati Instans PsApiManagement yang dimodifikasi ke Set-AzApiManagement.

Contoh

Contoh 1: Menambahkan wilayah penyebaran baru ke instans PsApiManagement

Add-AzApiManagementRegion -ApiManagement $ApiManagement -Location "East US" -Sku "Premium" -Capacity 2

Perintah ini menambahkan dua unit SKU premium dan wilayah bernama US Timur ke instans PsApiManagement .

Contoh 2: Tambahkan wilayah penyebaran baru ke instans PsApiManagement lalu perbarui penyebaran

$service = Get-AzApiManagement -ResourceGroupName "Contoso" -Name "ContosoApi"
$service = Add-AzApiManagementRegion -ApiManagement $service -Location $secondarylocation -VirtualNetwork $additionalRegionVirtualNetwork
$service = Set-AzApiManagement -InputObject $service -PassThru

Perintah ini mendapatkan objek PsApiManagement , menambahkan dua unit SKU premium untuk wilayah bernama US Timur, lalu memperbarui penyebaran.

Parameter

-ApiManagement

Menentukan instans PsApiManagement tempat cmdlet ini menambahkan wilayah penyebaran tambahan.

Jenis:PsApiManagement
Position:Named
nilai default:None
Diperlukan:True
Accept pipeline input:True
Accept wildcard characters:False

-Capacity

Menentukan kapasitas SKU wilayah penyebaran.

Jenis:Nullable<T>[Int32]
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan azure.

Jenis:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableGateway

Bendera hanya dimaksudkan untuk digunakan untuk penyebaran Premium SKU ApiManagement Service dan Non Internal VNET. Ini berguna jika kita ingin mengambil wilayah gateway dari rotasi. Ini juga dapat digunakan untuk berdiri di wilayah baru dalam mode Pasif, mengujinya dan kemudian membuatnya Langsung nanti. Perilaku default adalah membuat wilayah segera hidup.

Jenis:Nullable<T>[Boolean]
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-Location

Menentukan lokasi wilayah penyebaran baru di antara wilayah yang didukung untuk layanan Api Management. Untuk mendapatkan lokasi yang valid, gunakan cmdlet Get-AzResourceProvider -ProviderNamespace "Microsoft.ApiManagement" | di mana {$_. ResourceTypes[0]. ResourceTypeName -eq "service"} | Pilih Lokasi Objek

Jenis:String
Position:Named
nilai default:None
Diperlukan:True
Accept pipeline input:False
Accept wildcard characters:False

-PublicIpAddressId

ResoureId PublicIpAddress SKU Standar untuk integrasi ke dalam Penyebaran Jaringan Virtual stv2

Jenis:String
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-Sku

Menentukan tingkat wilayah penyebaran. Nilai yang valid adalah:

  • Pengembang
  • Standar
  • Premium
Jenis:Nullable<T>[PsApiManagementSku]
nilai yang diterima:Developer, Standard, Premium, Basic, Consumption, Isolated
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-VirtualNetwork

Menentukan konfigurasi jaringan virtual.

Jenis:PsApiManagementVirtualNetwork
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-Zone

Daftar zona ketersediaan yang menunjukkan tempat layanan manajemen api disebarkan.

Jenis:String[]
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:True
Accept wildcard characters:False

Input

PsApiManagement

Output

PsApiManagement

Catatan

  • Cmdlet menulis instans PsApiManagement yang diperbarui ke alur.