A versão 5 (V5) do Ferramentas da AWS para PowerShell foi lançada\$1 Para obter informações sobre mudanças significativas e migrar seus aplicativos, consulte o [tópico de migração](https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html). [https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html](https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html) As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # Exemplos do Amazon EFS usando ferramentas para PowerShell V5 Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o Ferramentas da AWS para PowerShell V5 com o Amazon EFS. *Ações* são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados. Cada exemplo inclui um link para o código-fonte completo, em que você pode encontrar instruções sobre como configurar e executar o código. **Topics** + [Ações](#actions) ## Ações ### `Edit-EFSMountTargetSecurityGroup` O código de exemplo a seguir mostra como usar `Edit-EFSMountTargetSecurityGroup`. **Ferramentas para PowerShell V5** **Exemplo 1: atualiza os grupos de segurança em vigor para o destino de montagem especificado. Até cinco podem ser especificados, no formato “sg-xxxxxxxx”.** ``` Edit-EFSMountTargetSecurityGroup -MountTargetId fsmt-1a2b3c4d -SecurityGroup sg-group1,sg-group3 ``` + Para obter detalhes da API, consulte [ModifyMountTargetSecurityGroups](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. ### `Get-EFSFileSystem` O código de exemplo a seguir mostra como usar `Get-EFSFileSystem`. **Ferramentas para PowerShell V5** **Exemplo 1: retorna a coleção de todos os sistemas de arquivos de propriedade da conta do chamador na região.** ``` Get-EFSFileSystem ``` **Saída**: ``` CreationTime : 5/26/2015 4:02:38 PM CreationToken : 1a2bff54-85e0-4747-bd95-7bc172c4f555 FileSystemId : fs-1a2b3c4d LifeCycleState : available Name : NumberOfMountTargets : 0 OwnerId : 123456789012 SizeInBytes : Amazon.ElasticFileSystem.Model.FileSystemSize CreationTime : 5/26/2015 4:06:23 PM CreationToken : 2b4daa14-85e0-4747-bd95-7bc172c4f555 FileSystemId : fs-4d3c2b1a ... ``` **Exemplo 2: retorna os detalhes do sistema de arquivos especificado.** ``` Get-EFSFileSystem -FileSystemId fs-1a2b3c4d ``` **Exemplo 3: retorna os detalhes de um sistema de arquivos usando o token de criação de idempotência que foi especificado no momento em que o sistema de arquivos foi criado.** ``` Get-EFSFileSystem -CreationToken 1a2bff54-85e0-4747-bd95-7bc172c4f555 ``` + Para obter detalhes da API, consulte [DescribeFileSystems](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. ### `Get-EFSMountTarget` O código de exemplo a seguir mostra como usar `Get-EFSMountTarget`. **Ferramentas para PowerShell V5** **Exemplo 1: retorna a coleção de destinos de montagem associados ao sistema de arquivos especificado.** ``` Get-EFSMountTarget -FileSystemId fs-1a2b3c4d ``` **Saída**: ``` FileSystemId : fs-1a2b3c4d IpAddress : 10.0.0.131 LifeCycleState : available MountTargetId : fsmt-1a2b3c4d NetworkInterfaceId : eni-1a2b3c4d OwnerId : 123456789012 SubnetId : subnet-1a2b3c4d ``` + Para obter detalhes da API, consulte [DescribeMountTargets](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. ### `Get-EFSMountTargetSecurityGroup` O código de exemplo a seguir mostra como usar `Get-EFSMountTargetSecurityGroup`. **Ferramentas para PowerShell V5** **Exemplo 1: retorna os IDs dos grupos de segurança atualmente atribuídos à interface de rede associada ao destino de montagem.** ``` Get-EFSMountTargetSecurityGroup -MountTargetId fsmt-1a2b3c4d ``` **Saída**: ``` sg-1a2b3c4d ``` + Para obter detalhes da API, consulte [DescribeMountTargetSecurityGroups](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. ### `Get-EFSTag` O código de exemplo a seguir mostra como usar `Get-EFSTag`. **Ferramentas para PowerShell V5** **Exemplo 1: retorna a coleção de tags atualmente associadas ao sistema de arquivos especificado.** ``` Get-EFSTag -FileSystemId fs-1a2b3c4d ``` **Saída**: ``` Key Value --- ----- Name My File System tagkey1 tagvalue1 tagkey2 tagvalue2 ``` + Para obter detalhes da API, consulte [DescribeTags](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. ### `New-EFSFileSystem` O código de exemplo a seguir mostra como usar `New-EFSFileSystem`. **Ferramentas para PowerShell V5** **Exemplo 1: cria um sistema de arquivos vazio. O token usado para garantir a criação idempotente será gerado automaticamente e poderá ser acessado pelo membro `CreationToken` do objeto retornado.** ``` New-EFSFileSystem ``` **Saída**: ``` CreationTime : 5/26/2015 4:02:38 PM CreationToken : 1a2bff54-85e0-4747-bd95-7bc172c4f555 FileSystemId : fs-1a2b3c4d LifeCycleState : creating Name : NumberOfMountTargets : 0 OwnerId : 123456789012 SizeInBytes : Amazon.ElasticFileSystem.Model.FileSystemSize ``` **Exemplo 2: cria um sistema de arquivos vazio usando um token personalizado para garantir uma criação idempotente.** ``` New-EFSFileSystem -CreationToken "MyUniqueToken" ``` + Para obter detalhes da API, consulte [CreateFileSystem](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. ### `New-EFSMountTarget` O código de exemplo a seguir mostra como usar `New-EFSMountTarget`. **Ferramentas para PowerShell V5** **Exemplo 1: cria um destino de montagem para um sistema de arquivos. A sub-rede especificada será usada para determinar a nuvem privada virtual (VPC) na qual o destino de montagem será criado e o endereço IP que será atribuído automaticamente (do intervalo de endereços da sub-rede). O endereço IP atribuído pode ser usado para montar esse sistema de arquivos em uma EC2 instância da Amazon. Como nenhum grupo de segurança foi especificado, a interface de rede criada para o destino está associada ao grupo de segurança padrão para a VPC da sub-rede.** ``` New-EFSMountTarget -FileSystemId fs-1a2b3c4d -SubnetId subnet-1a2b3c4d ``` **Saída**: ``` FileSystemId : fs-1a2b3c4d IpAddress : 10.0.0.131 LifeCycleState : creating MountTargetId : fsmt-1a2b3c4d NetworkInterfaceId : eni-1a2b3c4d OwnerId : 123456789012 SubnetId : subnet-1a2b3c4d ``` **Exemplo 2: cria um destino de montagem para o sistema de arquivos especificado com endereço IP atribuído automaticamente. A interface de rede criada para o destino de montagem está associada aos grupos de segurança especificados (até cinco, no formato “sg-xxxxxxxx”, podem ser especificados).** ``` New-EFSMountTarget -FileSystemId fs-1a2b3c4d -SubnetId subnet-1a2b3c4d -SecurityGroup sg-group1,sg-group2,sg-group3 ``` **Exemplo 3: cria um destino de montagem para o sistema de arquivos especificado com o endereço IP especificado.** ``` New-EFSMountTarget -FileSystemId fs-1a2b3c4d -SubnetId subnet-1a2b3c4d -IpAddress 10.0.0.131 ``` + Para obter detalhes da API, consulte [CreateMountTarget](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. ### `New-EFSTag` O código de exemplo a seguir mostra como usar `New-EFSTag`. **Ferramentas para PowerShell V5** **Exemplo 1: aplica a coleção de tags ao sistema de arquivos especificado. Se uma tag com a chave especificada já existir no sistema de arquivos, o valor da tag será atualizado.** ``` New-EFSTag -FileSystemId fs-1a2b3c4d -Tag @{Key="tagkey1";Value="tagvalue1"},@{Key="tagkey2";Value="tagvalue2"} ``` **Exemplo 2: define a tag de nome para o sistema de arquivos especificado. Esse valor é retornado junto com outros detalhes do sistema de arquivos quando o Get-EFSFileSystem cmdlet é usado.** ``` New-EFSTag -FileSystemId fs-1a2b3c4d -Tag @{Key="Name";Value="My File System"} ``` + Para obter detalhes da API, consulte [CreateTags](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. ### `Remove-EFSFileSystem` O código de exemplo a seguir mostra como usar `Remove-EFSFileSystem`. **Ferramentas para PowerShell V5** **Exemplo 1: exclui o sistema de arquivos especificado que não está mais em uso (se o sistema de arquivos tiver destinos de montagem, eles deverão ser removidos primeiro). É solicitada uma confirmação antes que o cmdlet continue. Para ignorar a confirmação, use a opção `-Force`.** ``` Remove-EFSFileSystem -FileSystemId fs-1a2b3c4d ``` + Para obter detalhes da API, consulte [DeleteFileSystem](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. ### `Remove-EFSMountTarget` O código de exemplo a seguir mostra como usar `Remove-EFSMountTarget`. **Ferramentas para PowerShell V5** **Exemplo 1: exclui o destino de montagem especificado. A confirmação será solicitada antes que a operação continue. Para suprimir o prompt, use a opção `-Force`. Observe que essa operação interrompe à força qualquer montagem do sistema de arquivos por meio do destino. Convém considerar a desmontagem do sistema de arquivos antes de executar esse comando, se possível.** ``` Remove-EFSMountTarget -MountTargetId fsmt-1a2b3c4d ``` + Para obter detalhes da API, consulte [DeleteMountTarget](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. ### `Remove-EFSTag` O código de exemplo a seguir mostra como usar `Remove-EFSTag`. **Ferramentas para PowerShell V5** **Exemplo 1: exclui a coleção de uma ou mais tags de um sistema de arquivos. É solicitada uma confirmação antes que o cmdlet continue. Para ignorar a confirmação, use a opção `-Force`.** ``` Remove-EFSTag -FileSystemId fs-1a2b3c4d -TagKey "tagkey1","tagkey2" ``` + Para obter detalhes da API, consulte [DeleteTags](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.