Tagga virtuella datorer på Azure Stack Edge via Azure PowerShell

Den här artikeln beskriver hur du taggar virtuella datorer som körs på dina GPU Azure Stack Edge Pro enheter med hjälp av Azure PowerShell.

Om taggar

Taggar är användardefinierade nyckel/värde-par som kan tilldelas till en resurs eller en resursgrupp. Du kan använda taggar för virtuella datorer som körs på din enhet för att organisera dem logiskt i en taxonomi. Du kan placera taggar på en resurs när den skapas eller lägga till den i en befintlig resurs. Du kan till exempel tillämpa namnet Organization och värdet på alla virtuella datorer som används av Engineering teknikavdelningen i din organisation.

Mer information om taggar finns i Hantera taggar via AzureRM PowerShell.

Förutsättningar

Innan du kan distribuera en virtuell dator på enheten via PowerShell kontrollerar du att:

Verifiera anslutningen till den lokala Azure Resource Manager

Kontrollera att följande steg kan användas för att komma åt enheten från klienten.

Kontrollera att klienten kan ansluta till den lokala Azure Resource Manager.

  1. Anropa API:er för lokala enheter för att autentisera:

    login-AzAccount -EnvironmentName <Environment Name> -TenantId c0257de7-538f-415c-993a-1b87a031879d  
    
  2. Ange användarnamnet EdgeArmUser och lösenordet för att ansluta via Azure Resource Manager. Om du inte återkallar lösenordet återställer du lösenordet för Azure Resource Manager använder det här lösenordet för att logga in.

Lägga till en tagg till en virtuell dator

  1. Ange några parametrar.

    $VMName = <VM Name>
    $VMRG = <VM Resource Group>
    $TagName = <Tag Name>
    $TagValue = <Tag Value>   
    

    Här är ett exempel på utdata:

    PS C:\WINDOWS\system32> $VMName = "myazvm"
    PS C:\WINDOWS\system32> $VMRG = "myaseazrg"
    PS C:\WINDOWS\system32> $TagName = "Organization"
    PS C:\WINDOWS\system32> $TagValue = "Sales"
    
  2. Hämta VM-objektet och dess taggar.

    $VirtualMachine = Get-AzVM -ResourceGroupName $VMRG -Name $VMName
    $tags = $VirtualMachine.Tags
    
  3. Lägg till taggen och uppdatera den virtuella datorn. Det kan ta några minuter att uppdatera den virtuella datorn.

    Du kan använda den valfria flaggan -Force för att köra kommandot utan användarbekräftelse.

    $tags.Add($TagName, $TagValue)
    Set-AzResource -ResourceId $VirtualMachine.Id -Tag $tags -Force
    

    Här är ett exempel på utdata:

    PS C:\WINDOWS\system32> $VirtualMachine = Get-AzVM -ResourceGroupName $VMRG -Name $VMName
    PS C:\WINDOWS\system32> $tags = $VirtualMachine.Tags
    PS C:\WINDOWS\system32> $tags.Add($TagName, $TagValue)
    PS C:\WINDOWS\system32> Set-AzResource -ResourceID $VirtualMachine.ID -Tag $tags -Force   
    
    Name              : myazvm
    ResourceId        : /subscriptions/d64617ad-6266-4b19-45af-81112d213322/resourceGroups/myas
                        eazrg/providers/Microsoft.Compute/virtualMachines/myazvm
    ResourceName      : myazvm
    ResourceType      : Microsoft.Compute/virtualMachines
    ResourceGroupName : myaseazrg
    Location          : dbelocal
    SubscriptionId    : d64617ad-6266-4b19-45af-81112d213322
    Tags              : {Organization}
    Properties        : @{vmId=568a264f-c5d3-477f-a16c-4c5549eafa8c; hardwareProfile=;
                        storageProfile=; osProfile=; networkProfile=; diagnosticsProfile=;
                        provisioningState=Succeeded}
    

Visa taggar för en virtuell dator

Du kan visa taggarna som tillämpas på en specifik virtuell dator som körs på din enhet.

  1. Definiera de parametrar som är associerade med den virtuella dator vars taggar du vill visa.

    $VMName = <VM Name>
    $VMRG = <VM Resource Group>
    

    Här är ett exempel på utdata:

    PS C:\WINDOWS\system32> $VMName = "myazvm"
    PS C:\WINDOWS\system32> $VMRG = "myaseazrg"
    
  2. Hämta VM-objektet och visa dess taggar.

    $VirtualMachine = Get-AzVM -ResourceGroupName $VMRG -Name $VMName
    $VirtualMachine.Tags
    

    Här är ett exempel på utdata:

    PS C:\WINDOWS\system32>  $VirtualMachine = Get-AzVM -ResourceGroupName $VMRG -Name $VMName     
    PS C:\WINDOWS\system32> $VirtualMachine.Tags
    
    Key          Value
    ---          -----
    Organization Sales    
    
    PS C:\WINDOWS\system32>
    

Visa taggar för alla resurser

Om du vill visa den aktuella listan över taggar för alla resurser i den lokala Azure Resource Manager-prenumerationen (skiljer sig från din Azure-prenumeration) för din enhet använder du Get-AzTag kommandot .

Här är ett exempel på utdata när flera virtuella datorer körs på enheten och du vill visa alla taggar på alla virtuella datorer.

PS C:\WINDOWS\system32> Get-AzTag

Name         Count
----         -----
Organization 2

PS C:\WINDOWS\system32>

Föregående utdata visar att det finns två Organization taggar på de virtuella datorer som körs på enheten.

Om du vill visa mer information använder du -Detailed parametern .

PS C:\WINDOWS\system32> Get-AzTag -Detailed |fl

Name        : Organization
ValuesTable :
              Name         Count
              ===========  =====
              Sales        1
              Engineering  1
Count       : 2
Values      : {Sales, Engineering}

PS C:\WINDOWS\system32>

Föregående utdata visar att av de två taggarna märks 1 virtuell dator som och den andra Engineering taggas som tillhörande Sales .

Ta bort en tagg från en virtuell dator

  1. Ange några parametrar.

    $VMName = <VM Name>
    $VMRG = <VM Resource Group>
    $TagName = <Tag Name>
    

    Här är ett exempel på utdata:

    PS C:\WINDOWS\system32> $VMName = "myaselinuxvm1"
    PS C:\WINDOWS\system32> $VMRG = "myaserg1"
    PS C:\WINDOWS\system32> $TagName = "Organization" 
    
  2. Hämta VM-objektet.

    $VirtualMachine = Get-AzVM -ResourceGroupName $VMRG -Name $VMName
    $VirtualMachine   
    

    Här är ett exempel på utdata:

    PS C:\WINDOWS\system32> $VirtualMachine = Get-AzVM -ResourceGroupName $VMRG -Name $VMName
    PS C:\WINDOWS\system32> $VirtualMachine
    
    ResourceGroupName  : myaseazrg
    Id                 : /subscriptions/d64617ad-6266-4b19-45af-81112d213322/resourceGroups/mya
    seazrg/providers/Microsoft.Compute/virtualMachines/myazvm
    VmId               : 568a264f-c5d3-477f-a16c-4c5549eafa8c
    Name               : myazvm
    Type               : Microsoft.Compute/virtualMachines
    Location           : dbelocal
    Tags               : {"Organization":"Sales"}
    DiagnosticsProfile : {BootDiagnostics}
    HardwareProfile    : {VmSize}
    NetworkProfile     : {NetworkInterfaces}
    OSProfile          : {ComputerName, AdminUsername, LinuxConfiguration, Secrets,
    AllowExtensionOperations, RequireGuestProvisionSignal}
    ProvisioningState  : Succeeded
    StorageProfile     : {ImageReference, OsDisk, DataDisks}
    
    PS C:\WINDOWS\system32>
    
  3. Ta bort taggen och uppdatera den virtuella datorn. Använd den -Force valfria flaggan för att köra kommandot utan användarbekräftelse.

    $tags = $VirtualMachine.Tags
    $tags.Remove($TagName)
    Set-AzResource -ResourceId $VirtualMachine.Id -Tag $tags -Force
    

    Här är ett exempel på utdata:

    PS C:\WINDOWS\system32> $tags = $VirtualMachine.Tags
    PS C:\WINDOWS\system32> $tags.Remove($TagName)
    True
    PS C:\WINDOWS\system32> Set-AzResource -ResourceId $VirtualMachine.Id -Tag $tags -Force
    
    Name              : myazvm
    ResourceId        : /subscriptions/d64617ad-6266-4b19-45af-81112d213322/resourceGroups/myas
                        eazrg/providers/Microsoft.Compute/virtualMachines/myazvm
    ResourceName      : myazvm
    ResourceType      : Microsoft.Compute/virtualMachines
    ResourceGroupName : myaseazrg
    Location          : dbelocal
    SubscriptionId    : d64617ad-6266-4b19-45af-81112d213322
    Tags              : {}
    Properties        : @{vmId=568a264f-c5d3-477f-a16c-4c5549eafa8c; hardwareProfile=;
                        storageProfile=; osProfile=; networkProfile=; diagnosticsProfile=;
                        provisioningState=Succeeded}
    
    PS C:\WINDOWS\system32>
    

Nästa steg