Membuat atau mengubah peering Langsung menggunakan PowerShell

  • Artikel

Artikel ini menjelaskan cara membuat Peering Langsung Microsoft dengan menggunakan cmdlet PowerShell dan model penyebaran Azure Resource Manager. Artikel ini juga memperlihatkan kepada Anda cara memeriksa status sumber daya, memperbaruinya, atau menghapus dan men-deprovisinya.

Jika mau, Anda dapat menyelesaikan prosedur ini menggunakan portal Microsoft Azure.

Sebelum Anda mulai

Bekerja dengan Azure PowerShell

Untuk menjalankan cmdlet, Anda dapat menggunakan shell interaktif gratis Azure Cloud Shell. Shell ini memiliki alat Azure umum yang telah dipasang sebelumnya dan dikonfigurasi untuk digunakan dengan akun Anda. Pilih Salin untuk menyalin kode, dan tempelkan ke Cloud Shell. Kemudian pilih Enter untuk menjalankannya. Ada beberapa cara untuk meluncurkan Cloud Shell:

Metode Peluncuran Cuplikan layar
Buka Cloud Shell di browser Anda. https://shell.azure.com/powershell
Pilih tombol Cloud Shell pada toolbar di kanan atas portal Azure. Cloud Shell in the portal

Jika tidak ingin menggunakan Azure Cloud Shell, Anda dapat menginstal PowerShell secara lokal. Jika Anda memilih untuk menginstal dan menggunakan PowerShell secara lokal, pastikan untuk menginstal versi terbaru cmdlet PowerShell Azure Resource Manager. Cmdlet PowerShell sering diperbarui. Anda biasanya perlu memperbarui cmdlet PowerShell Anda untuk mendapatkan fungsionalitas fitur terbaru. Jika tidak, Anda mungkin mengalami masalah.

Untuk menemukan versi PowerShell yang Anda jalankan secara lokal, gunakan cmdlet 'Get-Module -ListAvailable Az'. Untuk memperbarui, lihat Menginstal modul Azure PowerShell. Untuk informasi selengkapnya, lihat cara menginstal dan mengonfigurasi Azure PowerShell.

Jika Anda menggunakan PowerShell di macOS, ikuti langkah-langkah di Menginstal PowerShell di macOS.

Membuat dan menyediakan peering Langsung

Masuk ke akun Azure Anda dan pilih langganan Anda

Sebelum Anda memulai konfigurasi, instal dan impor modul yang diperlukan. Anda memerlukan hak Administrator untuk menginstal modul di PowerShell.

  1. Instal dan impor modul Az.

    Install-Module Az -AllowClobber
Import-Module Az

  2. Instal dan impor modul Az.Peering.

    Install-Module -Name Az.Peering -AllowClobber
Import-Module Az.Peering

  3. Pastikan bahwa modul diimpor dengan benar menggunakan perintah ini:

    Get-Module

  4. Masuk ke akun Azure Anda dengan menggunakan perintah ini:

    Connect-AzAccount

  5. Periksa langganan untuk akun tersebut, dan pilih langganan tempat Anda ingin membuat peering.

    Get-AzSubscription
Select-AzSubscription -SubscriptionId "subscription-id"

  6. Jika belum memiliki grup sumber daya, Anda harus membuatnya sebelum membuat peering. Anda bisa melakukannya dengan menjalankan kode berikut:

    New-AzResourceGroup -Name "PeeringResourceGroup" -Location "Central US"

Penting

Jika belum mengaitkan ASN dan langganan Anda, ikuti langkah-langkah di Mengaitkan ASN Peer. Tindakan ini diperlukan untuk meminta peering.

Catatan

Lokasi grup sumber daya tidak bergantung pada lokasi yang Anda pilih untuk menyiapkan peering.  

Dapatkan daftar lokasi peering yang didukung untuk Peering langsung

Cmdlet PowerShell Get-AzPeeringLocation mengembalikan daftar lokasi peering dengan parameter wajib Kind, yang akan Anda gunakan di langkah selanjutnya.

Get-AzPeeringLocation -Kind Direct

Lokasi peering langsung berisi bidang berikut:

  • PeeringLocation
  • Negara
  • PeeringDBFacilityId
  • PeeringDBFacilityLink
  • BandwidthOffers

Validasi bahwa Anda hadir di fasilitas peering yang diinginkan dengan merujuk pada PeeringDB.

Contoh ini menunjukkan cara menggunakan Seattle sebagai lokasi peering untuk membuat peering Direct.

$peeringLocations = Get-AzPeeringLocation -Kind Direct
$peeringLocation = $peeringLocations | where {$_.PeeringLocation -contains "Seattle"}
$peeringLocation

PeeringLocation       : Seattle
Address               : 2001 Sixth Avenue
Country               : US
PeeringDBFacilityId   : 71
PeeringDBFacilityLink : https://www.peeringdb.com/fac/71
BandwidthOffers       : {10Gbps, 100Gbps}

Membuat peering Langsung

Contoh berikut menunjukkan cara membuat peering Direct 10 Gbps di Seattle.

Gunakan cmdlet PowerShell New-AzPeeringDirectConnectionObject untuk membuat objek DirectConnection yang akan digunakan dalam permintaan peering baru.

Contoh ini memperlihatkan cara membuat objek DirectConnection.

$connection1 = New-AzPeeringDirectConnectionObject `
    -PeeringDBFacilityId $peeringLocation[0].PeeringDBFacilityId `
    -SessionPrefixV4 10.21.31.0/31 `
    -SessionPrefixV6 fe01::3e:0/127 `
    -MaxPrefixesAdvertisedIPv4 1000 `
    -MaxPrefixesAdvertisedIPv6 100 `
    -BandwidthInMbps 10000

Catatan

Nilai untuk $peeringLocation[] dalam contoh sebelumnya harus sesuai dengan lokasi peering pilihan Anda.

Buat koneksi lain jika Anda memerlukan redundansi di lokasi peering tertentu.

$connection2 = New-AzPeeringDirectConnectionObject `
    -PeeringDBFacilityId $peeringLocation[0].PeeringDBFacilityId `
    -SessionPrefixV4 10.21.33.0/31 `
    -SessionPrefixV6 fe01::3f:0/127 `
    -MaxPrefixesAdvertisedIPv4 1000 `
    -MaxPrefixesAdvertisedIPv6 100 `
    -BandwidthInMbps 10000

Gunakan cmdlet PowerShell New-AzPeering untuk membuat peering Direct baru. Perintah ini memerlukan ID sumber daya ASN, yang dapat diambil seperti yang ditunjukkan di sini.

$asn = Get-AzPeerAsn
New-AzPeering `
    -Name "SeattleDirectPeering" `
    -ResourceGroupName "PeeringResourceGroup" `
    -PeeringLocation  $peeringLocation[0].PeeringLocation `
    -PeerAsnResourceId $asn.Id `
    -DirectConnection $connection1 [, $connection2]

 

Contoh ini menunjukkan respons saat permintaan berhasil diproses.


    Name                 : SeattleDirectPeering
    Sku.Name             : Basic_Direct_Free
    Kind                 : Direct
    Connections          : 71
    PeerAsn.Id           : /subscriptions/{subscriptionId}/providers/Microsoft.Peering/peerAsns/SeattleDirectPeering
    UseForPeeringService : False
    PeeringLocation      : Seattle
    ProvisioningState    : Succeeded
    Location             : centralus
    Id                   : /subscriptions/{subscriptionId}/resourceGroups/PeeringResourceGroup/providers/Microsoft.Peering/peerings/SeattleDirectPeering
    Type                 : Microsoft.Peering/peerings
    Tags                 : {}

Perhatikan bahwa sebagai menggantikan {subscriptionId} dalam output ini, ID langganan aktual akan ditampilkan.

Memverifikasi peering Langsung

Untuk mendapatkan daftar peering, jalankan perintah Get-AzPeering.

$directPeering = Get-AzPeering -ResourceGroupName "PeeringResourceGroup" -Name "SeattleDirectPeering"

Contoh berikut menunjukkan respons saat provisi ujung ke ujung berhasil diselesaikan.

    Name                 : SeattleDirectPeering
    Sku.Name             : Basic_Direct_Free
    Kind                 : Direct
    Connections          : {71}
    PeerAsn.Id           : /subscriptions/{subscriptionId}/providers/Microsoft.Peering/peerAsns/SeattleDirectPeering
    UseForPeeringService : False
    PeeringLocation      : Seattle
    ProvisioningState    : Succeeded
    Location             : centralus
    Id                   : /subscriptions/{subscriptionId}/resourceGroups/PeeringResourceGroup/providers/Microsoft.Peering/peerings/SeattleDirectPeering
    Type                 : Microsoft.Peering/peerings
    Tags                 : {}

Mengubah peering Langsung

Bagian ini menjelaskan cara melakukan operasi modifikasi berikut untuk Peering langsung:

  • Menambahkan koneksi Peering langsung.
  • Menghapus koneksi Peering langsung.
  • Memutakhirkan atau menurunkan bandwidth pada Koneksi aktif.
  • Menambahkan sesi IPv4 atau IPv6 pada Koneksi aktif.
  • Menghapus sesi IPv4 atau IPv6 pada Koneksi aktif.

Menambahkan koneksi Peering langsung

Contoh ini menjelaskan cara menambahkan koneksi ke Peering langsung yang sudah ada.


$directPeering = Get-AzPeering -Name "SeattleDirectPeering" -ResourceGroupName "PeeringResourceGroup"

$connection = New-AzPeeringDirectConnection `
    -PeeringDBFacilityId $peeringLocation.PeeringDBFacilityId `
    -SessionPrefixV4 "10.22.31.0/31" `
    -SessionPrefixV6 "fe02::3e:0/127" `
    -MaxPrefixesAdvertisedIPv4 1000 `
    -MaxPrefixesAdvertisedIPv6 100 `
    -BandwidthInMbps 10000

$directPeering.Connections.Add($connection)

$directPeering | Update-AzPeering

Menghapus koneksi Peering langsung

Penghapusan koneksi saat ini tidak didukung di PowerShell. Untuk informasi selengkapnya, hubungi Microsoft peering.

Memutakhirkan atau menurunkan bandwidth pada koneksi Aktif

Contoh ini menjelaskan cara menambahkan 10 Gbps ke Koneksi langsung yang sudah ada.


$directPeering = Get-AzPeering -Name "SeattleDirectPeering" -ResourceGroupName "PeeringResourceGroup"
$directPeering.Connections[0].BandwidthInMbps  = 20000
$directPeering | Update-AzPeering

Menambahkan sesi IPv4 atau IPv6 pada Koneksi aktif

Contoh ini menjelaskan cara menambahkan sesi IPv6 pada Koneksi langsung yang sudah ada dengan sesi IPv4 saja.


$directPeering = Get-AzPeering -Name "SeattleDirectPeering" -ResourceGroupName "PeeringResourceGroup"
$directPeering.Connections[0].BGPSession.SessionPrefixv6 = "fe01::3e:0/127"
$directPeering | Update-AzPeering

Menghapus sesi IPv4 atau IPv6 pada Koneksi aktif

Penghapusan sesi IPv4 atau IPv6 dari koneksi yang ada saat ini tidak didukung di PowerShell. Untuk informasi selengkapnya, hubungi Microsoft peering.

Men-deprovisi peering Langsung

Saat ini, pembatalan provisi tidak didukung dengan menggunakan portal Azure atau PowerShell. Untuk membatalkan provisi, hubungi peering Microsoft.

Sumber Daya Tambahan:

Anda bisa mendapatkan deskripsi teperinci dari semua parameter dengan menjalankan perintah berikut:

Get-Help Get-AzPeering -detailed

Langkah berikutnya