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.