Select-AzureStorSimpleResource

  • Referência
Módulo:
Azure

Define um recurso como o recurso atual.

Observação

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 herdado do PowerShell não é recomendado ao criar novos recursos, já que o ASM está programado para desativação. Para obter mais informações, consulte Aposentadoria do Azure Service Manager.

O módulo Az PowerShell é o módulo do 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 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.

Tipo:AzureSMProfile
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ResourceName

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Entradas

None

Saídas

StorSimpleResourceContext

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