Resources beheren met Azure PowerShell en Resource ManagerManage resources with Azure PowerShell and Resource Manager

In dit artikel leert u hoe u uw oplossingen met Azure PowerShell en Azure Resource Manager beheert.In this article, you learn how to manage your solutions with Azure PowerShell and Azure Resource Manager. Als u niet bekend met Resource Manager, Zie overzicht van Resource Manager.If you are not familiar with Resource Manager, see Resource Manager Overview. Dit artikel is gericht op beheertaken.This article focuses on management tasks. U gaat het volgende doen:You will:

  1. Een resourcegroep makenCreate a resource group
  2. Een resource toevoegen aan de resourcegroepAdd a resource to the resource group
  3. Een label toevoegen aan de bronAdd a tag to the resource
  4. Een query uitvoeren op basis van namen of labelwaarden resourcesQuery resources based on names or tag values
  5. Toepassen en verwijderen van een vergrendeling op de bronApply and remove a lock on the resource
  6. Verwijderen van een resourcegroepDelete a resource group

In dit artikel wordt niet weergegeven voor het implementeren van een Resource Manager-sjabloon aan uw abonnement.This article does not show how to deploy a Resource Manager template to your subscription. Zie voor die informatie implementeren van resources met Resource Manager-sjablonen en Azure PowerShell.For that information, see Deploy resources with Resource Manager templates and Azure PowerShell.

Aan de slag met Azure PowerShellGet started with Azure PowerShell

Als u Azure PowerShell nog niet hebt geïnstalleerd, raadpleegt u installeren en configureren van Azure PowerShell.If you have not installed Azure PowerShell, see How to install and configure Azure PowerShell.

Als u Azure PowerShell in het verleden hebt geïnstalleerd, maar hebben niet het onlangs bijgewerkt, kunt u de nieuwste versie installeert.If you have installed Azure PowerShell in the past but have not updated it recently, consider installing the latest version. U kunt de versie bijwerken met de dezelfde methode die u hebt gebruikt om deze te installeren.You can update the version through the same method you used to install it. Als u het Webplatforminstallatieprogramma gebruikt, bijvoorbeeld opnieuw te starten en zoekt u een update.For example, if you used the Web Platform Installer, launch it again and look for an update.

Gebruik de volgende cmdlet te controleren van uw versie van de module voor Azure-Resources:To check your version of the Azure Resources module, use the following cmdlet:

Get-Module -ListAvailable -Name AzureRm.Resources | Select Version

In dit artikel is bijgewerkt voor versie 3.3.0.This article was updated for version 3.3.0. Als u een eerdere versie hebt, uw ervaring mogelijk niet overeen met de stappen in dit artikel.If you have an earlier version, your experience might not match the steps shown in this article. Zie voor documentatie over de cmdlets in deze versie AzureRM.Resources Module.For documentation about the cmdlets in this version, see AzureRM.Resources Module.

Aanmelden bij uw Azure-accountLog in to your Azure account

Voordat u aan uw oplossing werkt, moet u zich aanmelden bij uw account.Before working on your solution, you must log in to your account.

Voor het aanmelden bij uw Azure-account, gebruiken de Login-AzureRmAccount cmdlet.To log in to your Azure account, use the Login-AzureRmAccount cmdlet.

Login-AzureRmAccount

De cmdlet vraagt u om de aanmeldingsreferenties voor uw Azure-account.The cmdlet prompts you for the login credentials for your Azure account. Na het aanmelden, worden de instellingen van uw account gedownload zodat ze beschikbaar zijn voor Azure PowerShell.After logging in, it downloads your account settings so they are available to Azure PowerShell.

De cmdlet retourneert informatie over uw account en het abonnement moet worden gebruikt voor de taken.The cmdlet returns information about your account and the subscription to use for the tasks.

Environment           : AzureCloud
Account               : example@contoso.com
TenantId              : {guid}
SubscriptionId        : {guid}
SubscriptionName      : Example Subscription One
CurrentStorageAccount :

Als u meer dan één abonnement hebt, kunt u overschakelen naar een ander abonnement.If you have more than one subscription, you can switch to a different subscription. Eerst gaan we kijken alle abonnementen voor uw account.First, let's see all the subscriptions for your account.

Get-AzureRmSubscription

Het resultaat van ingeschakelde en uitgeschakelde abonnementen.It returns enabled and disabled subscriptions.

SubscriptionName : Example Subscription One
SubscriptionId   : {guid}
TenantId         : {guid}
State            : Enabled

SubscriptionName : Example Subscription Two
SubscriptionId   : {guid}
TenantId         : {guid}
State            : Enabled

SubscriptionName : Example Subscription Three
SubscriptionId   : {guid}
TenantId         : {guid}
State            : Disabled

Als u wilt overschakelen naar een ander abonnement, geef de naam van het abonnement met de Set-AzureRmContext cmdlet.To switch to a different subscription, provide the subscription name with the Set-AzureRmContext cmdlet.

Set-AzureRmContext -SubscriptionName "Example Subscription Two"

Een resourcegroep makenCreate a resource group

Voordat u implementeert geen bronnen aan uw abonnement, moet u een resourcegroep met de bronnen.Before deploying any resources to your subscription, you must create a resource group that will contain the resources.

Voor het maken van een resourcegroep gebruikt de New-AzureRmResourceGroup cmdlet.To create a resource group, use the New-AzureRmResourceGroup cmdlet. Gebruikt de opdracht de naam parameter om een naam voor de resourcegroep en de locatie parameter om de locatie.The command uses the Name parameter to specify a name for the resource group and the Location parameter to specify its location.

New-AzureRmResourceGroup -Name TestRG1 -Location "South Central US"

De uitvoer is in de volgende indeling:The output is in the following format:

ResourceGroupName : TestRG1
Location          : southcentralus
ProvisioningState : Succeeded
Tags              :
ResourceId        : /subscriptions/{guid}/resourceGroups/TestRG1

Als u de resourcegroep later nodig, gebruikt u de volgende cmdlet:If you need to retrieve the resource group later, use the following cmdlet:

Get-AzureRmResourceGroup -ResourceGroupName TestRG1

Geef een naam niet voor alle resourcegroepen in uw abonnement:To get all the resource groups in your subscription, do not specify a name:

Get-AzureRmResourceGroup

Resources toevoegen aan een resourcegroepAdd resources to a resource group

Als u wilt een resource toevoegen aan de resourcegroep, kunt u de nieuw AzureRmResource cmdlet of een cmdlet die specifiek is voor het type resource dat u maakt (zoals nieuw AzureRmStorageAccount).To add a resource to the resource group, you can use the New-AzureRmResource cmdlet or a cmdlet that is specific to the type of resource you are creating (like New-AzureRmStorageAccount). Wellicht eenvoudiger te gebruiken van een cmdlet die specifiek is voor een resourcetype omdat deze parameters voor de eigenschappen die nodig zijn voor de nieuwe resource bevat.You might find it easier to use a cmdlet that is specific to a resource type because it includes parameters for the properties that are needed for the new resource. Gebruik nieuw AzureRmResource, moet u de eigenschappen in te stellen zonder te worden gevraagd voor hen kennen.To use New-AzureRmResource, you must know all the properties to set without being prompted for them.

Echter, toevoegen van een resource via cmdlets kan veroorzaken toekomstige verwarring omdat de nieuwe resource niet in een Resource Manager-sjabloon bestaat.However, adding a resource through cmdlets might cause future confusion because the new resource does not exist in a Resource Manager template. Microsoft raadt u aan het definiëren van de infrastructuur voor uw Azure-oplossing in Resource Manager-sjabloon.Microsoft recommends defining the infrastructure for your Azure solution in a Resource Manager template. Sjablonen kunnen u op betrouwbare wijze en herhaaldelijk implementeren van uw oplossing.Templates enable you to reliably and repeatedly deploy your solution. Voor dit artikel hebt u een opslagaccount maken met een PowerShell-cmdlet, maar later het genereren van een sjabloon uit de resourcegroep.For this article, you create a storage account with a PowerShell cmdlet, but later you generate a template from your resource group.

De volgende cmdlet maakt een opslagaccount.The following cmdlet creates a storage account. In plaats van de naam die wordt weergegeven in het voorbeeld, Geef een unieke naam voor het opslagaccount.Instead of using the name shown in the example, provide a unique name for the storage account. De naam moet tussen 3 en 24 tekens lang zijn en alleen cijfers en kleine letters gebruiken.The name must be between 3 and 24 characters in length, and use only numbers and lower-case letters. Als u de naam die wordt weergegeven in het voorbeeld gebruikt, ontvangt u een fout opgetreden omdat deze naam al gebruikt wordt.If you use the name shown in the example, you receive an error because that name is already in use.

New-AzureRmStorageAccount -ResourceGroupName TestRG1 -AccountName mystoragename -Type "Standard_LRS" -Location "South Central US"

Als u deze bron later nodig, gebruikt u de volgende cmdlet:If you need to retrieve this resource later, use the following cmdlet:

Get-AzureRmResource -ResourceName mystoragename -ResourceGroupName TestRG1

Een label toevoegenAdd a tag

Labels kunnen u om uw resources op basis van andere eigenschappen te organiseren.Tags enable you to organize your resources according to different properties. Bijvoorbeeld wellicht verschillende resources in verschillende resourcegroepen die deel uitmaken van dezelfde afdeling.For example, you may have several resources in different resource groups that belong to the same department. U kunt een label voor afdeling en de waarde toepassen op deze resources om deze te markeren als onderdeel van dezelfde categorie.You can apply a department tag and value to those resources to mark them as belonging to the same category. Of u kunt markeren of een resource wordt gebruikt in een productie- of testomgeving.Or, you can mark whether a resource is used in a production or test environment. In dit artikel leert u tags toepassen op slechts één resource, maar in uw omgeving is het waarschijnlijk wel zinvol tags toepassen op al uw resources.In this article, you apply tags to only one resource, but in your environment it most likely makes sense to apply tags to all your resources.

De volgende cmdlet geldt twee tags voor uw opslagaccount:The following cmdlet applies two tags to your storage account:

Set-AzureRmResource -Tag @{ Dept="IT"; Environment="Test" } -ResourceName mystoragename -ResourceGroupName TestRG1 -ResourceType Microsoft.Storage/storageAccounts

Labels zijn als een enkel object bijgewerkt.Tags are updated as a single object. Als u wilt een code toevoegt aan een resource die al tags bevat, moet u eerst de bestaande labels ophalen.To add a tag to a resource that already includes tags, first retrieve the existing tags. Nieuw label toevoegen aan het object dat de bestaande labels bevat en alle tags toepassen op de resource.Add the new tag to the object that contains the existing tags, and reapply all the tags to the resource.

$tags = (Get-AzureRmResource -ResourceName mystoragename -ResourceGroupName TestRG1).Tags
$tags += @{Status="Approved"}
Set-AzureRmResource -Tag $tags -ResourceName mystoragename -ResourceGroupName TestRG1 -ResourceType Microsoft.Storage/storageAccounts

Zoeken naar resourcesSearch for resources

Gebruik de zoeken AzureRmResource cmdlet voor het ophalen van bronnen voor verschillende zoekcriteria.Use the Find-AzureRmResource cmdlet to retrieve resources for different search conditions.

  • Als u een resource met de naam, bieden de ResourceNameContains parameter:To get a resource by name, provide the ResourceNameContains parameter:

    Find-AzureRmResource -ResourceNameContains mystoragename
    
  • Als u alle resources in een resourcegroep, bieden de ResourceGroupNameContains parameter:To get all the resources in a resource group, provide the ResourceGroupNameContains parameter:

    Find-AzureRmResource -ResourceGroupNameContains TestRG1
    
  • Als u de resources met een naam en waarde, bieden de TagName en TagValue parameters:To get all the resources with a tag name and value, provide the TagName and TagValue parameters:

    Find-AzureRmResource -TagName Dept -TagValue IT
    
  • Alle resources met een bepaald resourcetype, geeft u de ResourceType parameter:To all the resources with a particular resource type, provide the ResourceType parameter:

    Find-AzureRmResource -ResourceType Microsoft.Storage/storageAccounts
    

Resource-ID ophalenGet resource ID

Veel opdrachten nemen een resource-ID als een parameter.Many commands take a resource ID as a parameter. Als u de ID voor een resource die en opslaan in een variabele, gebruikt u:To get the ID for a resource and store in a variable, use:

$webappID = (Get-AzureRmResource -ResourceGroupName exampleGroup -ResourceName exampleSite).ResourceId

Vergrendelen van een resourceLock a resource

Als u controleren of een essentiële resource niet per ongeluk is verwijderd of gewijzigd wilt, moet u een vergrendeling toegepast op de resource.When you need to make sure a critical resource is not accidentally deleted or modified, apply a lock to the resource. U kunt opgeven dat ofwel een CanNotDelete of ReadOnly.You can specify either a CanNotDelete or ReadOnly.

Als u wilt maken of verwijderen van management vergrendelingen, u moet toegang hebben tot Microsoft.Authorization/* of Microsoft.Authorization/locks/* acties.To create or delete management locks, you must have access to Microsoft.Authorization/* or Microsoft.Authorization/locks/* actions. Van de ingebouwde rollen worden alleen de eigenaar en de beheerder voor gebruikerstoegang die acties verleend.Of the built-in roles, only Owner and User Access Administrator are granted those actions.

Als u wilt toepassen op een vergrendeling, gebruikt u de volgende cmdlet:To apply a lock, use the following cmdlet:

New-AzureRmResourceLock -LockLevel CanNotDelete -LockName LockStorage -ResourceName mystoragename -ResourceType Microsoft.Storage/storageAccounts -ResourceGroupName TestRG1

De vergrendelde resource in het vorige voorbeeld kan niet worden verwijderd, totdat de vergrendeling wordt verwijderd.The locked resource in the preceding example cannot be deleted until the lock is removed. Gebruik voor het verwijderen van een vergrendeling:To remove a lock, use:

Remove-AzureRmResourceLock -LockName LockStorage -ResourceName mystoragename -ResourceType Microsoft.Storage/storageAccounts -ResourceGroupName TestRG1

Zie voor meer informatie over de instelling vergrendelingen resources met Azure Resource Manager vergrendelen.For more information about setting locks, see Lock resources with Azure Resource Manager.

Verwijder resources of resourcegroepRemove resources or resource group

U kunt een resource of resourcegroep verwijderen.You can remove a resource or resource group. Wanneer u een resourcegroep verwijdert, verwijdert u ook alle resources in die resourcegroep.When you remove a resource group, you also remove all the resources within that resource group.

  • Als u wilt een bron verwijdert uit de resourcegroep, gebruiken de verwijderen AzureRmResource cmdlet.To delete a resource from the resource group, use the Remove-AzureRmResource cmdlet. Deze cmdlet de resource wordt verwijderd, maar de resourcegroep niet verwijdert.This cmdlet deletes the resource, but does not delete the resource group.

    Remove-AzureRmResource -ResourceName mystoragename -ResourceType Microsoft.Storage/storageAccounts -ResourceGroupName TestRG1
    
  • U een resourcegroep en de bijhorende resources verwijderen met de Remove-AzureRmResourceGroup cmdlet.To delete a resource group and all its resources, use the Remove-AzureRmResourceGroup cmdlet.

    Remove-AzureRmResourceGroup -Name TestRG1
    

Voor beide cmdlets, wordt u gevraagd te bevestigen dat u wilt verwijderen van de resource of resourcegroep.For both cmdlets, you are asked to confirm that you wish to remove the resource or resource group. Als de bewerking is Hiermee verwijdert u de resource of resourcegroep, retourneert True.If the operation successfully deletes the resource or resource group, it returns True.

Resource Manager-scripts uitvoeren met Azure AutomationRun Resource Manager scripts with Azure Automation

In dit artikel laat zien hoe basisbewerkingen op uw resources met Azure PowerShell uit te voeren.This article shows you how to perform basic operations on your resources with Azure PowerShell. Voor meer geavanceerde scenario's voor beheer wilt u waarschijnlijk een script maken en hergebruiken script naar behoefte of volgens een schema.For more advanced management scenarios, you typically want to create a script, and reuse that script as needed or on a schedule. Azure Automation biedt een manier om u te vaak automatiseren gebruikt scripts waarmee uw Azure-oplossingen kunt beheren.Azure Automation provides a way for you to automate frequently used scripts that manage your Azure solutions.

De volgende onderwerpen beschreven hoe u met Azure Automation, Resource Manager en PowerShell effectief beheertaken uitvoeren:The following topics show you how to use Azure Automation, Resource Manager, and PowerShell to effectively perform management tasks:

Volgende stappenNext steps