Partager via

Select-AzureStorSimpleResource

  • Référence
Module:
Azure

Définit une ressource comme ressource actuelle.

Remarque

Les cmdlets mentionnées dans cette documentation servent à gérer les ressources Azure héritées qui utilisent les API Azure Service Manager (ASM). Ce module PowerShell hérité n’est pas recommandé lors de la création de ressources, car ASM est planifié pour la mise hors service. Pour plus d’informations, consultez la mise hors service d’Azure Service Manager.

Le module Az PowerShell est le module PowerShell recommandé pour la gestion des ressources Azure Resource Manager (ARM) avec PowerShell.

Syntaxe

Select-AzureStorSimpleResource
      -ResourceName <String>
      [-RegistrationKey <String>]
      [-Profile <AzureSMProfile>]
      [<CommonParameters>]

Description

L’applet de commande Select-AzureStorSimpleResource définit une ressource comme ressource actuelle. Après avoir sélectionné une ressource, d’autres applets de commande s’appliquent dans ce contexte de ressource.

Exemples

Exemple 1 : Sélectionner une ressource pour la première fois

PS C:\>Select-AzureStorSimpleResource -ResourceName "Contoso64-Tsqa" -RegistrationKey "<your registration key>"
ResourceId           ResourceName
----------           ------------
1909806764156522689  Contoso64-Tsqa

Cette commande sélectionne la ressource nommée Contoso64-Tsqa comme contexte actuel. Dans cet exemple, l’ordinateur n’a pas eu ce contexte initialisé précédemment et, par conséquent, vous devez spécifier une valeur pour le paramètre RegistrationKey .

Exemple 2 : Tentative de sélection d’une ressource

This command gets the current context for this computer by using the **Get-AzureStorSimpleResourceContext** cmdlet. The current selected resource is Contoso64-Tsqa. This is consistent with the previous example. 
PS C:\>Get-AzureStorSimpleResourceContext
ResourceId           ResourceName
----------           ------------
1909806764156522689  Contoso64-Tsqa 

This command attempts to reset the resource to be Contoso02-Resource. For this example, this resource has not been previously selected. The registration key is not saved or included in the command. The command cannot select the resource. 
PS C:\>Select-AzureStorSimpleResource -ResourceName "Contoso02-Resource"
Select-AzureStorSimpleResource : Could not find the persisted secret. Please use Select-AzureStorSimpleResource and
provide the Registration key once again.

Exemple 3 : Sélectionner une ressource précédemment sélectionnée

PS C:\>Select-AzureStorSimpleResource -ResourceName "Contoso64-Tsqa"
ResourceId           ResourceName
----------           ------------
1909806764156522689  Contoso64-Tsqa

Cette commande sélectionne la ressource nommée Contoso64-Tsqa comme contexte actuel. Dans cet exemple, ce contexte a été sélectionné précédemment et, par conséquent, vous n’avez pas besoin de spécifier de valeur pour le paramètre RegistrationKey .

Paramètres

-Profile

Spécifie un profil Azure.

Type:AzureSMProfile
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-RegistrationKey

Spécifie une clé d’inscription. Spécifiez une clé la première fois que vous sélectionnez une ressource. Une fois que cette applet de commande sélectionne la ressource actuelle, les applets de commande utilisent cette clé, selon les besoins. Pour plus d’informations, consultez Obtenir la clé d’inscription du service (https://msdn.microsoft.com/en-us/library/azure/dn772346.aspx) sur microsoft Developer Network.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ResourceName

Spécifie le nom de la ressource à sélectionner comme ressource actuelle.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

Entrées

None

Sorties

StorSimpleResourceContext

Cette applet de commande retourne un objet StorSimpleResourceContext qui contient des détails pour le contexte de ressource.