Freigeben über

Select-AzureStorSimpleResource

  • Referenz
Modul:
Azure

Legt eine Ressource als aktuelle Ressource fest.

Hinweis

Die Cmdlets, auf die in dieser Dokumentation verwiesen wird, dienen zum Verwalten von Azure-Legacyressourcen, die Azure Dienst-Manager (ASM) APIs verwenden. Dieses ältere PowerShell-Modul wird beim Erstellen neuer Ressourcen nicht empfohlen, da ASM für den Ruhestand geplant ist. Weitere Informationen finden Sie unter Einstellung des Azure Service Manager.

Das Az PowerShell-Modul ist das empfohlene PowerShell-Modul zum Verwalten von Azure Resource Manager (ARM)-Ressourcen mit PowerShell.

Syntax

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

Beschreibung

Das Cmdlet Select-AzureStorSimpleResource legt eine Ressource als aktuelle Ressource fest. Nachdem Sie eine Ressource ausgewählt haben, gelten andere Cmdlets innerhalb dieses Ressourcenkontexts.

Beispiele

Beispiel 1: Erstmaliges Auswählen einer Ressource

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

Mit diesem Befehl wird die Ressource "Contoso64-Tsqa" als aktueller Kontext ausgewählt. In diesem Beispiel hat der Computer diesen Kontext noch nicht initialisiert, und Daher müssen Sie einen Wert für den RegistrationKey-Parameter angeben.

Beispiel 2: Auswählen einer 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.

Beispiel 3: Auswählen einer zuvor ausgewählten Ressource

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

Mit diesem Befehl wird die Ressource "Contoso64-Tsqa" als aktueller Kontext ausgewählt. In diesem Beispiel wurde dieser Kontext zuvor ausgewählt, daher müssen Sie keinen Wert für den RegistrationKey-Parameter angeben.

Parameter

-Profile

Gibt ein Azure-Profil an.

Typ:AzureSMProfile
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RegistrationKey

Gibt einen Registrierungsschlüssel an. Geben Sie beim ersten Auswählen einer Ressource einen Schlüssel an. Nachdem dieses Cmdlet die aktuelle Ressource ausgewählt hat, verwenden Cmdlets diesen Schlüssel nach Bedarf. Weitere Informationen finden Sie unter Abrufen des Dienstregistrierungsschlüssels (https://msdn.microsoft.com/en-us/library/azure/dn772346.aspx) im Microsoft Developer Network.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ResourceName

Gibt den Namen der Ressource an, die als aktuelle Ressource ausgewählt werden soll.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Eingaben

None

Ausgaben

StorSimpleResourceContext

Dieses Cmdlet gibt ein StorSimpleResourceContext-Objekt zurück, das Details für den Ressourcenkontext enthält.