Select-AzureStorSimpleResource

Define um recurso como o recurso atual.

Observação

Os cmdlets mostrados nesta documentação são usados para gerenciar recursos herdados do Azure que usam APIs de Gerenciamento de Serviços. Confira o módulo Az PowerShell para usar cmdlets a fim de gerenciar recursos do Azure Resource Manager.

Syntax

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

Description

O cmdlet Select-AzureStorSimpleResource define um recurso como o recurso atual. Depois de selecionar um recurso, outros cmdlets se aplicam nesse contexto de recurso.

Exemplos

Exemplo 1: Selecionar um recurso pela primeira vez

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

Este comando seleciona o recurso chamado Contoso64-Tsqa como o contexto atual. Neste exemplo, o computador não teve esse contexto inicializado anteriormente e, portanto, você deve especificar um valor para o parâmetro RegistrationKey .

Exemplo 2: Tentar selecionar um recurso

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.

Exemplo 3: Selecionar um recurso selecionado anteriormente

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

Este comando seleciona o recurso chamado Contoso64-Tsqa como o contexto atual. Neste exemplo, esse contexto foi selecionado anteriormente e, portanto, você não precisa especificar um valor para o parâmetro RegistrationKey .

Parâmetros

-Profile

Especifica um perfil do Azure.

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

-RegistrationKey

Especifica uma chave de registro. Especifique uma chave na primeira vez que você selecionar um recurso. Depois que esse cmdlet seleciona o recurso atual, os cmdlets usam essa chave, conforme necessário. Para obter mais informações, consulte Obter a chave de registro de serviço (https://msdn.microsoft.com/en-us/library/azure/dn772346.aspx) no Microsoft Developer Network.

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

-ResourceName

Especifica o nome do recurso a ser selecionado como o recurso atual.

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

Entradas

None

Saídas

StorSimpleResourceContext

Esse cmdlet retorna um objeto StorSimpleResourceContext que contém detalhes para o contexto do recurso.