Partilhar via


Select-AzureStorSimpleResource

Define um recurso como o recurso atual.

Nota

Os cmdlets mencionados nesta documentação são para gerenciar recursos herdados do Azure que usam APIs do Azure Service Manager (ASM). Este módulo do PowerShell herdado não é recomendado ao criar novos recursos, uma vez que o ASM está agendado para desativação. Para obter mais informações, consulte Aposentadoria do Azure Service Manager.

O módulo Az PowerShell é o módulo PowerShell recomendado para gerenciar recursos do Azure Resource Manager (ARM) com o PowerShell.

Sintaxe

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 dentro desse contexto de recurso.

Exemplos

Exemplo 1: Selecione 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: Selecione 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.

Tipo:AzureSMProfile
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-RegistrationKey

Especifica uma chave de registro. Especifique uma chave na primeira vez que 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.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ResourceName

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

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

Entradas

None

Saídas

StorSimpleResourceContext

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