Aracılığıyla paylaş

Set-AzVMCustomScriptExtension

  • Başvuru
Modül:
Az.Compute

Sanal makineye özel betik uzantısı ekler.

Syntax

Set-AzVMCustomScriptExtension
   [-ResourceGroupName] <String>
   [-VMName] <String>
   [-Name <String>]
   -ContainerName <String>
   -FileName <String[]>
   [-StorageAccountName <String>]
   [-StorageEndpointSuffix <String>]
   [-StorageAccountKey <String>]
   [-Run <String>]
   [-Argument <String>]
   [-SecureExecution]
   [-TypeHandlerVersion <String>]
   [-Location <String>]
   [-DisableAutoUpgradeMinorVersion]
   [-ForceRerun <String>]
   [-NoWait]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzVMCustomScriptExtension
   [-ResourceGroupName] <String>
   [-VMName] <String>
   [-Name <String>]
   [-FileUri <String[]>]
   [-Run <String>]
   [-Argument <String>]
   [-SecureExecution]
   [-TypeHandlerVersion <String>]
   [-Location <String>]
   [-DisableAutoUpgradeMinorVersion]
   [-ForceRerun <String>]
   [-NoWait]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzVMCustomScriptExtension
   -Name <String>
   -VMObject <PSVirtualMachine>
   -ContainerName <String>
   -FileName <String[]>
   [-StorageAccountName <String>]
   [-StorageEndpointSuffix <String>]
   [-StorageAccountKey <String>]
   [-Run <String>]
   [-Argument <String>]
   [-SecureExecution]
   [-TypeHandlerVersion <String>]
   [-Location <String>]
   [-DisableAutoUpgradeMinorVersion]
   [-ForceRerun <String>]
   [-NoWait]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzVMCustomScriptExtension
   -Name <String>
   -VMObject <PSVirtualMachine>
   [-FileUri <String[]>]
   [-Run <String>]
   [-Argument <String>]
   [-SecureExecution]
   [-TypeHandlerVersion <String>]
   [-Location <String>]
   [-DisableAutoUpgradeMinorVersion]
   [-ForceRerun <String>]
   [-NoWait]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzVMCustomScriptExtension
   -ResourceId <String>
   -ContainerName <String>
   -FileName <String[]>
   [-StorageAccountName <String>]
   [-StorageEndpointSuffix <String>]
   [-StorageAccountKey <String>]
   [-Run <String>]
   [-Argument <String>]
   [-SecureExecution]
   [-TypeHandlerVersion <String>]
   [-Location <String>]
   [-DisableAutoUpgradeMinorVersion]
   [-ForceRerun <String>]
   [-NoWait]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzVMCustomScriptExtension
   -ResourceId <String>
   [-FileUri <String[]>]
   [-Run <String>]
   [-Argument <String>]
   [-SecureExecution]
   [-TypeHandlerVersion <String>]
   [-Location <String>]
   [-DisableAutoUpgradeMinorVersion]
   [-ForceRerun <String>]
   [-NoWait]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzVMCustomScriptExtension
   -InputObject <VirtualMachineCustomScriptExtensionContext>
   -ContainerName <String>
   -FileName <String[]>
   [-StorageAccountName <String>]
   [-StorageEndpointSuffix <String>]
   [-StorageAccountKey <String>]
   [-Run <String>]
   [-Argument <String>]
   [-SecureExecution]
   [-TypeHandlerVersion <String>]
   [-Location <String>]
   [-DisableAutoUpgradeMinorVersion]
   [-ForceRerun <String>]
   [-NoWait]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzVMCustomScriptExtension
   -InputObject <VirtualMachineCustomScriptExtensionContext>
   [-FileUri <String[]>]
   [-Run <String>]
   [-Argument <String>]
   [-SecureExecution]
   [-TypeHandlerVersion <String>]
   [-Location <String>]
   [-DisableAutoUpgradeMinorVersion]
   [-ForceRerun <String>]
   [-NoWait]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Set-AzVMCustomScriptExtension cmdlet'i sanal makineye özel bir betik Sanal Makine Uzantısı ekler. Bu uzantı, sanal makinede kendi betiklerinizi çalıştırmanıza olanak tanır.

Örnekler

Örnek 1: Özel betik ekleme

Set-AzVMCustomScriptExtension -ResourceGroupName "ResourceGroup11" -Location "Central US" -VMName "VirtualMachine07" -Name "ContosoTest" -TypeHandlerVersion "1.1" -StorageAccountName "Contoso" -StorageAccountKey <StorageKey> -FileName "ContosoScript.exe" -ContainerName "Scripts"

Bu komut VirtualMachine07 adlı sanal makineye özel bir betik ekler. Betik dosyası contososcript.exe.

Örnek 2

Sanal makineye özel betik uzantısı ekler. (otomatik olarak oluşturulmuş)

Set-AzVMCustomScriptExtension -Argument <String> -ContainerName 'Scripts' -DefaultProfile <IAzureContextContainer> -FileName 'ContosoScript.exe' -Location 'Central US' -Name 'ContosoTest' -ResourceGroupName 'ResourceGroup11' -Run 'myScript.ps1' -SecureExecution -StorageAccountKey <String> -StorageAccountName 'Contoso' -TypeHandlerVersion '1.1' -VMName 'VirtualMachine07'

Parametreler

-Argument

Betik uzantısının betike geçirdiği bağımsız değişkenleri belirtir.

Tür:String
Position:Named
varsayılan değer:None
Gerekli:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

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

Tür:SwitchParameter
Aliases:cf
Position:Named
varsayılan değer:False
Gerekli:False
Accept pipeline input:False
Accept wildcard characters:False

-ContainerName

Bu cmdlet'in betiği depoladığı Azure depolama kapsayıcısının adını belirtir.

Tür:String
Position:Named
varsayılan değer:None
Gerekli:True
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

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

Tür:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
varsayılan değer:None
Gerekli:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableAutoUpgradeMinorVersion

Tür:SwitchParameter
Position:Named
varsayılan değer:None
Gerekli:False
Accept pipeline input:True
Accept wildcard characters:False

-FileName

Betik dosyasının adını belirtir. Dosya Azure Blob depolamada depolanıyorsa, dosya adı değeri büyük/küçük harfe duyarlıdır. Azure Dosya depolama alanında depolanan dosyaların dosya adları büyük/küçük harfe duyarlı değildir.

Tür:String[]
Position:Named
varsayılan değer:None
Gerekli:True
Accept pipeline input:True
Accept wildcard characters:False

-FileUri

Betik dosyasının URI'sini belirtir.

Tür:String[]
Position:Named
varsayılan değer:None
Gerekli:False
Accept pipeline input:True
Accept wildcard characters:False

-ForceRerun

Bu cmdlet'in, uzantıyı kaldırıp yeniden yüklemeden sanal makinede aynı uzantı yapılandırmasının yeniden çalıştırılmasını zorladığını gösterir. Değer, geçerli değerden farklı herhangi bir dize olabilir. forceUpdateTag değiştirilmezse, ortak veya korumalı ayarlara yapılan güncelleştirmeler işleyici tarafından uygulanmaya devam eder.

Tür:String
Position:Named
varsayılan değer:None
Gerekli:False
Accept pipeline input:True
Accept wildcard characters:False

-InputObject

VM uzantısı nesnesi.

Tür:VirtualMachineCustomScriptExtensionContext
Position:Named
varsayılan değer:None
Gerekli:True
Accept pipeline input:True
Accept wildcard characters:False

-Location

Sanal makinenin konumunu belirtir.

Tür:String
Position:Named
varsayılan değer:None
Gerekli:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

Özel betik uzantısının adını belirtir.

Tür:String
Aliases:ExtensionName
Position:Named
varsayılan değer:None
Gerekli:True
Accept pipeline input:True
Accept wildcard characters:False

-NoWait

İşlemi başlatır ve işlem tamamlanmadan hemen önce döndürür. İşlemin başarıyla tamamlandığını belirlemek için başka bir mekanizma kullanın.

Tür:SwitchParameter
Position:Named
varsayılan değer:None
Gerekli:False
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

Sanal makinenin kaynak grubunun adını belirtir.

Tür:String
Position:0
varsayılan değer:None
Gerekli:True
Accept pipeline input:True
Accept wildcard characters:False

-ResourceId

VM uzantısı ResourceID.

Tür:String
Position:Named
varsayılan değer:None
Gerekli:True
Accept pipeline input:True
Accept wildcard characters:False

-Run

Betiğinizi çalıştıran komutu belirtir.

Tür:String
Aliases:RunFile, Command
Position:Named
varsayılan değer:None
Gerekli:False
Accept pipeline input:True
Accept wildcard characters:False

-SecureExecution

Bu cmdlet'in Çalıştır parametresinin değerinin sunucuda günlüğe kaydedilmediğinden veya GET uzantısı API'sini kullanarak kullanıcıya döndürülmediğinden emin olduğunu gösterir. Run değeri, betik dosyasına güvenli bir şekilde geçirilecek gizli diziler veya parolalar içerebilir.

Tür:SwitchParameter
Position:Named
varsayılan değer:None
Gerekli:False
Accept pipeline input:True
Accept wildcard characters:False

-StorageAccountKey

Azure depolama kapsayıcısının anahtarını belirtir.

Tür:String
Position:Named
varsayılan değer:None
Gerekli:False
Accept pipeline input:True
Accept wildcard characters:False

-StorageAccountName

Bu cmdlet'in betiği depoladığı Azure depolama hesabının adını belirtir.

Tür:String
Position:Named
varsayılan değer:None
Gerekli:False
Accept pipeline input:True
Accept wildcard characters:False

-StorageEndpointSuffix

Depolama uç noktası sonekini belirtir.

Tür:String
Position:Named
varsayılan değer:None
Gerekli:False
Accept pipeline input:True
Accept wildcard characters:False

-TypeHandlerVersion

Bu sanal makine için kullanılacak uzantının sürümünü belirtir. Sürümü edinmek için PublisherName parametresi için Microsoft.Compute ve Type parametresi için CustomScriptExtension değeriyle Get-AzVMExtensionImage cmdlet'ini çalıştırın.

Tür:String
Aliases:HandlerVersion, Version
Position:Named
varsayılan değer:None
Gerekli:False
Accept pipeline input:True
Accept wildcard characters:False

-VMName

Sanal makinenin adını belirtir. Bu cmdlet, bu parametrenin belirttiği sanal makine için özel betik uzantısını ekler.

Tür:String
Aliases:ResourceName
Position:1
varsayılan değer:None
Gerekli:True
Accept pipeline input:True
Accept wildcard characters:False

-VMObject

VM nesnesi.

Tür:PSVirtualMachine
Position:Named
varsayılan değer:None
Gerekli:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Tür:SwitchParameter
Aliases:wi
Position:Named
varsayılan değer:False
Gerekli:False
Accept pipeline input:False
Accept wildcard characters:False

Girişler

String

String[]

SwitchParameter

Çıkışlar

PSAzureOperationResponse