New-AzPublicIpAddress
Genel bir IP adresi oluşturur.
Syntax
Default (Varsayılan)
New-AzPublicIpAddress
[-Name <String>]
-ResourceGroupName <String>
-Location <String>
[-EdgeZone <String>]
[-Sku <String>]
[-Tier <String>]
-AllocationMethod <String>
[-IpAddressVersion <String>]
[-DomainNameLabel <String>]
[-DomainNameLabelScope <PSDomainNameLabelScopeType>]
[-IpTag <PSPublicIpTag[]>]
[-PublicIpPrefix <PSPublicIpPrefix>]
[-DdosProtectionMode <String>]
[-DdosProtectionPlanId <String>]
[-ReverseFqdn <String>]
[-IdleTimeoutInMinutes <Int32>]
[-Zone <String[]>]
[-IpAddress <String>]
[-Tag <Hashtable>]
[-Force]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
New-AzPublicIpAddress cmdlet'i bir genel IP adresi oluşturur.
Örnekler
Örnek 1: Yeni bir genel IP adresi oluşturma
$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -Location $location
Bu komut yeni bir genel IP adresi kaynağı oluşturur. $dnsPrefix.$location.cloudapp.azure.com için bu kaynağın genel IP adresine işaret eden bir DNS kaydı oluşturulur. -AllocationMethod 'Statik' olarak belirtildiğinden, bu kaynağa hemen bir genel IP adresi ayrılır. 'Dinamik' olarak belirtilirse, genel IP adresi yalnızca ilişkili kaynağı (VM veya yük dengeleyici gibi) başlattığınızda (veya oluşturduğunuzda) ayrılır.
Örnek 2: Ters FQDN ile genel IP adresi oluşturma
$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -Location $location -ReverseFqdn $customFqdn
Bu komut yeni bir genel IP adresi kaynağı oluşturur. -ReverseFqdn parametresiyle Azure, bu kaynağa ayrılan genel IP adresi için bir DNS PTR kaydı (ters arama) oluşturur ve komutta belirtilen $customFqdn işaret ediyor. Önkoşul olarak, $customFqdn (örneğin webapp.contoso.com) $dnsPrefix.$location.cloudapp.azure.com işaret eden bir DNS CNAME kaydı (ileri arama) olmalıdır.
Örnek 3: IpTag ile yeni bir genel IP adresi oluşturma
$ipTag = New-AzPublicIpTag -IpTagType "FirstPartyUsage" -Tag "/Sql"
$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -Location $location -IpTag $ipTag
Bu komut yeni bir genel IP adresi kaynağı oluşturur. $dnsPrefix.$location.cloudapp.azure.com için bu kaynağın genel IP adresine işaret eden bir DNS kaydı oluşturulur. -AllocationMethod 'Statik' olarak belirtildiğinden, bu kaynağa hemen bir genel IP adresi ayrılır. 'Dinamik' olarak belirtilirse, genel IP adresi yalnızca ilişkili kaynağı (VM veya yük dengeleyici gibi) başlattığınızda (veya oluşturduğunuzda) ayrılır. Iptag, kaynakla ilişkili Etiketleri tanımlamak için kullanılır. Iptag, New-AzPublicIpTag kullanılarak belirtilebilir ve -IpTags aracılığıyla giriş olarak geçirilebilir.
Örnek 4: Ön Ekten yeni bir genel IP adresi oluşturma
$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -Location $location -PublicIpPrefix $publicIpPrefix -Sku Standard
Bu komut yeni bir genel IP adresi kaynağı oluşturur. $dnsPrefix.$location.cloudapp.azure.com için bu kaynağın genel IP adresine işaret eden bir DNS kaydı oluşturulur. Belirtilen publicIpPrefix'ten bu kaynağa hemen bir genel IP adresi ayrılır.
Bu seçenek yalnızca 'Standard' Sku ve 'Static' AllocationMethod için desteklenir.
Örnek 5: BYOIP Ön Ekinden belirli bir genel IP adresi oluşturma
$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -Location $location -IpAddress 0.0.0.0 -PublicIpPrefix $publicIpPrefix -Sku Standard
Bu komut, belirli BIR IP ile yeni bir genel IP adresi kaynağı oluşturur. NRP, verilen IP'nin PublicIpPrefix içinde olup olmadığını ve verilen PublicIpPrefix'in BYOIP PublicIpPrefix olup olmadığını denetler.
belirtilen genel IP adresi, belirtilen publicIpPrefix'ten bu kaynağa hemen ayrılır. Bu seçenek yalnızca 'Standard' Sku ve 'Static' AllocationMethod ve BYOIP PublicIpPrefix için desteklenir.
Örnek 6: Yeni bir genel genel IP adresi oluşturma
$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $domainNameLabel -Location $location -Sku Standard -Tier Global
Bu komut yeni bir genel genel IP adresi kaynağı oluşturur. $dnsPrefix.$location.cloudapp.azure.com için bu kaynağın genel IP adresine işaret eden bir DNS kaydı oluşturulur. Bu kaynağa hemen genel bir genel IP adresi ayrılır.
Bu seçenek yalnızca 'Standard' Sku ve 'Static' AllocationMethod için desteklenir.
Örnek 7: DomainNameLabelScope ile genel IP adresi oluşturma
$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -DomainNameLabelScope $hasedReusePolicy -Location $location
Bu komut yeni bir genel IP adresi kaynağı oluşturur. -DomainNameLabelScope parametresiyle Azure, $hasedReusePolicy tarafından önerilen ilkeyle bu kaynağa ayrılan genel IP adresi için FQDN'de karma değere sahip bir DNS kaydı oluşturur.
Parametreler
-AllocationMethod
Genel IP adresinin atandığı yöntemi belirtir.
Bu parametre için kabul edilebilir değerler şunlardır: Statik veya Dinamik.
Parametre özellikleri
Tür: String
Default value: None
Kabul edilen değerler: Dynamic, Static
Joker karakterleri destekler: False
DontShow: False
Parametre kümeleri
(All)
Position: Named
Zorunlu: True
İşlem hattından gelen değer: False
Özellik adına göre işlem hattından gelen değer: True
Kalan bağımsız değişkenlerden elde edilen değer: False
-AsJob
Cmdlet'i arka planda çalıştırma
Parametre özellikleri
Tür: SwitchParameter
Default value: None
Joker karakterleri destekler: False
DontShow: False
Parametre kümeleri
(All)
Position: Named
Zorunlu: False
İşlem hattından gelen değer: False
Özellik adına göre işlem hattından gelen değer: False
Kalan bağımsız değişkenlerden elde edilen değer: False
-Confirm
Cmdlet'i çalıştırmadan önce sizden onay ister.
Parametre özellikleri
Tür: SwitchParameter
Default value: False
Joker karakterleri destekler: False
DontShow: False
Diğer adlar: Cf
Parametre kümeleri
(All)
Position: Named
Zorunlu: False
İşlem hattından gelen değer: False
Özellik adına göre işlem hattından gelen değer: False
Kalan bağımsız değişkenlerden elde edilen değer: False
-DdosProtectionMode
Genel IP adresi için kullanılacak DdosProtectionMode
Parametre özellikleri
Tür: String
Default value: None
Kabul edilen değerler: VirtualNetworkInherited, Enabled, Disabled
Joker karakterleri destekler: False
DontShow: False
Parametre kümeleri
(All)
Position: Named
Zorunlu: False
İşlem hattından gelen değer: False
Özellik adına göre işlem hattından gelen değer: True
Kalan bağımsız değişkenlerden elde edilen değer: False
-DdosProtectionPlanId
Genel IP adresine eklenecek DdosProtectionPlan kimliği
Parametre özellikleri
Tür: String
Default value: None
Joker karakterleri destekler: False
DontShow: False
Parametre kümeleri
(All)
Position: Named
Zorunlu: False
İşlem hattından gelen değer: False
Özellik adına göre işlem hattından gelen değer: True
Kalan bağımsız değişkenlerden elde edilen değer: False
-DefaultProfile
Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik.
Parametre özellikleri
Tür: IAzureContextContainer
Default value: None
Joker karakterleri destekler: False
DontShow: False
Diğer adlar: AzContext, AzureRmContext, AzureCredential
Parametre kümeleri
(All)
Position: Named
Zorunlu: False
İşlem hattından gelen değer: False
Özellik adına göre işlem hattından gelen değer: False
Kalan bağımsız değişkenlerden elde edilen değer: False
-DomainNameLabel
Genel IP adresi için göreli DNS adını belirtir.
Parametre özellikleri
Tür: String
Default value: None
Joker karakterleri destekler: False
DontShow: False
Parametre kümeleri
(All)
Position: Named
Zorunlu: False
İşlem hattından gelen değer: False
Özellik adına göre işlem hattından gelen değer: True
Kalan bağımsız değişkenlerden elde edilen değer: False
-DomainNameLabelScope
Genel IP adresi için DNS adı için HashedReusePolicy değerini belirtir.
Parametre özellikleri
Tür: Nullable<T> [ PSDomainNameLabelScopeType ]
Default value: None
Kabul edilen değerler: TenantReuse, SubscriptionReuse, ResourceGroupReuse, NoReuse
Joker karakterleri destekler: False
DontShow: False
Parametre kümeleri
(All)
Position: Named
Zorunlu: False
İşlem hattından gelen değer: False
Özellik adına göre işlem hattından gelen değer: True
Kalan bağımsız değişkenlerden elde edilen değer: False
-EdgeZone
Genişletilmiş konumun adı.
Parametre özellikleri
Tür: String
Default value: None
Joker karakterleri destekler: False
DontShow: False
Parametre kümeleri
(All)
Position: Named
Zorunlu: False
İşlem hattından gelen değer: False
Özellik adına göre işlem hattından gelen değer: True
Kalan bağımsız değişkenlerden elde edilen değer: False
-Force
Komutu, kullanıcı onayı istemeden çalışmaya zorlar.
Parametre özellikleri
Tür: SwitchParameter
Default value: None
Joker karakterleri destekler: False
DontShow: False
Parametre kümeleri
(All)
Position: Named
Zorunlu: False
İşlem hattından gelen değer: False
Özellik adına göre işlem hattından gelen değer: False
Kalan bağımsız değişkenlerden elde edilen değer: False
-IdleTimeoutInMinutes
Boşta kalma zaman aşımını dakika cinsinden belirtir.
Parametre özellikleri
Tür: Int32
Default value: None
Joker karakterleri destekler: False
DontShow: False
Parametre kümeleri
(All)
Position: Named
Zorunlu: False
İşlem hattından gelen değer: False
Özellik adına göre işlem hattından gelen değer: True
Kalan bağımsız değişkenlerden elde edilen değer: False
-IpAddress
BYOIP publicIpAddress oluştururken IP adresini belirtir.
Parametre özellikleri
Tür: String
Default value: None
Joker karakterleri destekler: False
DontShow: False
Parametre kümeleri
(All)
Position: Named
Zorunlu: False
İşlem hattından gelen değer: False
Özellik adına göre işlem hattından gelen değer: True
Kalan bağımsız değişkenlerden elde edilen değer: False
-IpAddressVersion
IP adresinin sürümünü belirtir.
Parametre özellikleri
Tür: String
Default value: None
Kabul edilen değerler: IPv4, IPv6
Joker karakterleri destekler: False
DontShow: False
Parametre kümeleri
(All)
Position: Named
Zorunlu: False
İşlem hattından gelen değer: False
Özellik adına göre işlem hattından gelen değer: True
Kalan bağımsız değişkenlerden elde edilen değer: False
-IpTag
IpTag Listesi.
Parametre özellikleri
Tür: PSPublicIpTag [ ]
Default value: None
Joker karakterleri destekler: False
DontShow: False
Parametre kümeleri
(All)
Position: Named
Zorunlu: False
İşlem hattından gelen değer: False
Özellik adına göre işlem hattından gelen değer: True
Kalan bağımsız değişkenlerden elde edilen değer: False
-Location
Genel IP adresinin oluşturulacağı bölgeyi belirtir.
Parametre özellikleri
Tür: String
Default value: None
Joker karakterleri destekler: False
DontShow: False
Parametre kümeleri
(All)
Position: Named
Zorunlu: True
İşlem hattından gelen değer: False
Özellik adına göre işlem hattından gelen değer: True
Kalan bağımsız değişkenlerden elde edilen değer: False
-Name
Bu cmdlet'in oluşturduğu genel IP adresinin adını belirtir.
Parametre özellikleri
Tür: String
Default value: None
Joker karakterleri destekler: False
DontShow: False
Diğer adlar: KaynakAdı
Parametre kümeleri
(All)
Position: Named
Zorunlu: False
İşlem hattından gelen değer: False
Özellik adına göre işlem hattından gelen değer: True
Kalan bağımsız değişkenlerden elde edilen değer: False
-PublicIpPrefix
Genel IP adresinin ayrıldığı PSPublicIpPrefix değerini belirtir.
Parametre özellikleri
Tür: PSPublicIpPrefix
Default value: None
Joker karakterleri destekler: False
DontShow: False
Parametre kümeleri
(All)
Position: Named
Zorunlu: False
İşlem hattından gelen değer: False
Özellik adına göre işlem hattından gelen değer: True
Kalan bağımsız değişkenlerden elde edilen değer: False
-ResourceGroupName
Genel IP adresinin oluşturulacağı kaynak grubunun adını belirtir.
Parametre özellikleri
Tür: String
Default value: None
Joker karakterleri destekler: False
DontShow: False
Parametre kümeleri
(All)
Position: Named
Zorunlu: True
İşlem hattından gelen değer: False
Özellik adına göre işlem hattından gelen değer: True
Kalan bağımsız değişkenlerden elde edilen değer: False
-ReverseFqdn
Ters tam etki alanı adı (FQDN) belirtir.
Parametre özellikleri
Tür: String
Default value: None
Joker karakterleri destekler: False
DontShow: False
Parametre kümeleri
(All)
Position: Named
Zorunlu: False
İşlem hattından gelen değer: False
Özellik adına göre işlem hattından gelen değer: True
Kalan bağımsız değişkenlerden elde edilen değer: False
-Sku
Genel IP Sku adı.
Parametre özellikleri
Tür: String
Default value: None
Kabul edilen değerler: Basic, Standard, StandardV2
Joker karakterleri destekler: False
DontShow: False
Parametre kümeleri
(All)
Position: Named
Zorunlu: False
İşlem hattından gelen değer: False
Özellik adına göre işlem hattından gelen değer: True
Kalan bağımsız değişkenlerden elde edilen değer: False
-Tag
Karma tablo biçiminde anahtar-değer çiftleri. Örneğin: @{key0="value0"; key1=$null; key2="value2"}
Parametre özellikleri
Tür: Hashtable
Default value: None
Joker karakterleri destekler: False
DontShow: False
Parametre kümeleri
(All)
Position: Named
Zorunlu: False
İşlem hattından gelen değer: False
Özellik adına göre işlem hattından gelen değer: True
Kalan bağımsız değişkenlerden elde edilen değer: False
-Tier
Genel IP Sku Katmanı.
Parametre özellikleri
Tür: String
Default value: None
Kabul edilen değerler: Regional, Global
Joker karakterleri destekler: False
DontShow: False
Parametre kümeleri
(All)
Position: Named
Zorunlu: False
İşlem hattından gelen değer: False
Özellik adına göre işlem hattından gelen değer: True
Kalan bağımsız değişkenlerden elde edilen değer: False
-WhatIf
Cmdlet çalıştırılırsa ne olacağını gösterir.
Cmdlet çalıştırılmaz.
Parametre özellikleri
Tür: SwitchParameter
Default value: False
Joker karakterleri destekler: False
DontShow: False
Diğer adlar: Wi
Parametre kümeleri
(All)
Position: Named
Zorunlu: False
İşlem hattından gelen değer: False
Özellik adına göre işlem hattından gelen değer: False
Kalan bağımsız değişkenlerden elde edilen değer: False
-Zone
Kaynak için ayrılan IP'nin kaynaktan gelmesi gerektiğini belirten kullanılabilirlik alanlarının listesi.
Parametre özellikleri
Tür: String [ ]
Default value: None
Joker karakterleri destekler: False
DontShow: False
Parametre kümeleri
(All)
Position: Named
Zorunlu: False
İşlem hattından gelen değer: False
Özellik adına göre işlem hattından gelen değer: True
Kalan bağımsız değişkenlerden elde edilen değer: False
CommonParameters
Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.
Çıkışlar