Set-AzureRmResource

Başvuru

Modül:: AzureRM.Resources

Kaynağı değiştirir.

Uyarı

AzureRM PowerShell modülü 29 Şubat 2024 itibarıyla resmi olarak kullanım dışı bırakılmıştır. Kullanıcıların destek ve güncelleştirmelerin devam etmesini sağlamak için AzureRM'den Az PowerShell modülüne geçmeleri tavsiye edilir.

AzureRM modülü çalışmaya devam edebilir, ancak artık bakım yapılmaz veya desteklenmez ve kullanıcının takdirine ve riskine bağlı olarak sürekli kullanım sağlanır. Az modülüne geçiş konusunda yönergeler için lütfen geçiş kaynaklarımıza bakın.

Syntax

Set-AzureRmResource
   [-Kind <String>]
   [-Properties <PSObject>]
   [-Plan <Hashtable>]
   [-Sku <Hashtable>]
   [-Tag <Hashtable>]
   [-UsePatchSemantics]
   [-AsJob]
   -ResourceId <String>
   [-ODataQuery <String>]
   [-Force]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-AzureRmResource
   -InputObject <PSResource>
   [-Kind <String>]
   [-Properties <PSObject>]
   [-Plan <Hashtable>]
   [-Sku <Hashtable>]
   [-Tag <Hashtable>]
   [-UsePatchSemantics]
   [-AsJob]
   [-ODataQuery <String>]
   [-Force]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-AzureRmResource
   [-Kind <String>]
   [-Properties <PSObject>]
   [-Plan <Hashtable>]
   [-Sku <Hashtable>]
   [-Tag <Hashtable>]
   [-UsePatchSemantics]
   [-AsJob]
   -ResourceName <String>
   -ResourceType <String>
   [-ExtensionResourceName <String>]
   [-ExtensionResourceType <String>]
   [-ODataQuery <String>]
   [-ResourceGroupName <String>]
   [-Force]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-AzureRmResource
   [-Kind <String>]
   [-Properties <PSObject>]
   [-Plan <Hashtable>]
   [-Sku <Hashtable>]
   [-Tag <Hashtable>]
   [-UsePatchSemantics]
   [-AsJob]
   -ResourceName <String>
   -ResourceType <String>
   [-ExtensionResourceName <String>]
   [-ExtensionResourceType <String>]
   [-ODataQuery <String>]
   [-TenantLevel]
   [-Force]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Set-AzureRmResource cmdlet'i var olan bir Azure kaynağını değiştirir. Ada ve türe veya kimliğe göre değiştireceğiniz bir kaynak belirtin.

Örnekler

Örnek 1: Kaynağı değiştirme

PS C:\> $Resource = Get-AzureRmResource -ResourceType Microsoft.Web/sites -ResourceGroupName ResourceGroup11 -ResourceName ContosoSite
PS C:\> $Resource.Properties.Enabled = "False"
PS C:\> $Resource | Set-AzureRmResource -Force

İlk komut, Get-AzureRmResource cmdlet'ini kullanarak ContosoSite adlı kaynağı alır ve $Resource değişkeninde depolar. İkinci komut $Resource özelliğini değiştirir. Son komut, kaynağı $Resource eşleşecek şekilde güncelleştirir.

Örnek 2: Belirli bir kaynak grubundaki tüm kaynakları değiştirme

PS C:\> $Resource = Get-AzureRmResource -ResourceGroupName testrg
PS C:\> $Resource | ForEach-Object { $_.Tags.Add("testkey", "testval") }
PS C:\> $Resource | Set-AzureRmResource -Force

Name              : kv-test
ResourceId        : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/testrg/providers/Microsoft.KeyVault/vaults/kv-test
ResourceName      : kv-test
ResourceType      : Microsoft.KeyVault/vaults
ResourceGroupName : testrg
Location          : westus
SubscriptionId    : xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Tags              : {testrgkey, key}
Properties        : @{}

Name              : testresource
ResourceId        : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/testrg/providers/Providers.Test/statefulResources/testresource
ResourceName      : testresource
ResourceType      : Providers.Test/statefulResources
ResourceGroupName : testrg
Location          : West US 2
SubscriptionId    : xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Tags              : {testrgkey, anothertesttag}
Properties        : @{key=value}
Sku               : @{name=A0}

İlk komut testrg kaynak grubundaki kaynakları alır ve ardından bunları $Resource değişkeninde depolar.

İkinci komut kaynak grubundaki bu kaynaklardan her biri üzerinde yinelenir ve bu kaynaklara yeni bir etiket ekler.

Son komut bu kaynakların her birini güncelleştirir.

Parametreler

-ApiVersion

Kullanılacak kaynak sağlayıcısı API'sinin sürümünü belirtir. Bir sürüm belirtmezseniz, bu cmdlet kullanılabilir en son sürümü kullanır.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AsJob

Cmdlet'i arka planda çalıştırma

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik

Type:	IAzureContextContainer
Aliases:	AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ExtensionResourceName

Kaynak için uzantı kaynağının adını belirtir. Örneğin, bir veritabanı belirtmek için şu biçimi kullanın: sunucu adı/veritabanı adı

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ExtensionResourceType

Uzantı kaynağının kaynak türünü belirtir. Örneğin, uzantı kaynağı bir veritabanıysa aşağıdakileri belirtin: Microsoft.Sql/Servers/Databases

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Force

Komutu, kullanıcı onayı istemeden çalışmaya zorlar.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

Güncelleştirilecek kaynağın nesne gösterimi.

Type:	PSResource
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Kind

Kaynağın kaynak türünü belirtir.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ODataQuery

Açık Veri Protokolü (OData) stil filtresini belirtir. Bu cmdlet, diğer filtrelere ek olarak bu değeri isteğe ekler.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Plan

Kaynak için karma tablo olarak kaynak planı özelliklerini belirtir.

Type:	Hashtable
Aliases:	PlanObject
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Pre

Bu cmdlet'in hangi sürümün kullanılacağını otomatik olarak belirlediğinde yayın öncesi API sürümlerini göz önünde bulundurduğunu gösterir.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Properties

Kaynağın kaynak özelliklerini belirtir.

Type:	PSObject
Aliases:	PropertyObject
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ResourceGroupName

Bu cmdlet'in kaynağı değiştirdiği kaynak grubunun adını belirtir.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ResourceId

Aşağıdaki örnekte olduğu gibi abonelik de dahil olmak üzere tam kaynak kimliğini belirtir: /subscriptions/abonelik kimliği/providers/Microsoft.Sql/servers/ContosoServer/databases/ContosoDatabase

Type:	String
Aliases:	Id
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ResourceName

Kaynağın adını belirtir. Örneğin, bir veritabanı belirtmek için aşağıdaki biçimi kullanın: ContosoServer/ContosoDatabase

Type:	String
Aliases:	Name
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ResourceType

Kaynağın türünü belirtir. Örneğin, bir veritabanı için kaynak türü aşağıdaki gibidir: Microsoft.Sql/Servers/Databases

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Sku

Kaynağın SKU nesnesini karma tablo olarak belirtir.

Type:	Hashtable
Aliases:	SkuObject
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Tag

Karma tablo biçiminde anahtar-değer çiftleri. Örneğin: @{key0="value0"; key1=$null; key2="value2"}

Type:	Hashtable
Aliases:	Tags
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-TenantLevel

Bu cmdlet'in kiracı düzeyinde çalıştığını gösterir.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-UsePatchSemantics

Bu cmdlet'in nesneyi güncelleştirmek için HTTP PUT yerine HTTP PATCH kullandığını gösterir.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Girişler

None

Çıkışlar

Microsoft.Azure.Commands.ResourceManager.Models.PSResource

Aracılığıyla paylaş

Set-AzureRmResource

Syntax

Description

Örnekler

Örnek 1: Kaynağı değiştirme

Örnek 2: Belirli bir kaynak grubundaki tüm kaynakları değiştirme

Parametreler

-ApiVersion

-AsJob

-Confirm

-DefaultProfile

-ExtensionResourceName

-ExtensionResourceType

-Force

-InputObject

-Kind

-ODataQuery

-Plan

-Pre

-Properties

-ResourceGroupName

-ResourceId

-ResourceName

-ResourceType

-Sku

-Tag

-TenantLevel

-UsePatchSemantics

-WhatIf

Girişler

Çıkışlar

Ek kaynaklar

Aracılığıyla paylaş

Set-AzureRmResource

Syntax

Description

Örnekler

Örnek 1: Kaynağı değiştirme

Örnek 2: Belirli bir kaynak grubundaki tüm kaynakları değiştirme

Parametreler

-ApiVersion

-AsJob

-Confirm

-DefaultProfile

-ExtensionResourceName

-ExtensionResourceType

-Force

-InputObject

-Kind

-ODataQuery

-Plan

-Pre

-Properties

-ResourceGroupName

-ResourceId

-ResourceName

-ResourceType

-Sku

-Tag

-TenantLevel

-UsePatchSemantics

-WhatIf

Girişler

Çıkışlar

İlişkili Bağlantılar

Ek kaynaklar