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 Dienstverwaltungs-APIs verwenden. Cmdlets zum Verwalten von Azure Ressource Manager-Ressourcen finden Sie im Az PowerShell-Modul.

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.

Type:	AzureSMProfile
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ResourceName

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

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

Eingaben

None

Ausgaben

StorSimpleResourceContext

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