WorkSpaces esempi di utilizzo di Tools for PowerShell - Esempi di codice dell'AWS SDK

Ci sono altri AWS SDK esempi disponibili nel repository AWS Doc SDK Examples GitHub .

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

WorkSpaces esempi di utilizzo di Tools for PowerShell

I seguenti esempi di codice mostrano come eseguire azioni e implementare scenari comuni utilizzando AWS Tools for PowerShell with WorkSpaces.

Le operazioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le operazioni mostrino come richiamare le singole funzioni del servizio, è possibile visualizzarle contestualizzate negli scenari correlati.

Ogni esempio include un collegamento al codice sorgente completo, in cui è possibile trovare istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Azioni

Il seguente esempio di codice mostra come utilizzareApprove-WKSIpRule.

Strumenti per PowerShell

Esempio 1: questo esempio aggiunge regole a un gruppo IP esistente

$Rule = @( @{IPRule = "10.1.0.0/0"; RuleDesc = "First Rule Added"}, @{IPRule = "10.2.0.0/0"; RuleDesc = "Second Rule Added"} ) Approve-WKSIpRule -GroupId wsipg-abcnx2fcw -UserRule $Rule
  • Per API i dettagli, vedere AuthorizeIpRulesin AWS Tools for PowerShell Cmdlet Reference.

Il seguente esempio di codice mostra come utilizzare. Copy-WKSWorkspaceImage

Strumenti per PowerShell

Esempio 1: questo esempio copia l'immagine dell'area di lavoro con l'ID specificato da us-west-2 nella regione corrente con il nome "" CopiedImageTest

Copy-WKSWorkspaceImage -Name CopiedImageTest -SourceRegion us-west-2 -SourceImageId wsi-djfoedhw6

Output:

wsi-456abaqfe
  • Per API i dettagli, vedere CopyWorkspaceImagein AWS Tools for PowerShell Cmdlet Reference.

Il seguente esempio di codice mostra come utilizzare. Edit-WKSClientProperty

Strumenti per PowerShell

Esempio 1: questo esempio abilita la riconnessione per il client Workspaces

Edit-WKSClientProperty -Region us-west-2 -ClientProperties_ReconnectEnabled "ENABLED" -ResourceId d-123414a369

Il seguente esempio di codice mostra come utilizzare. Edit-WKSSelfServicePermission

Strumenti per PowerShell

Esempio 1: Questo esempio abilita le autorizzazioni self-service per modificare il tipo di elaborazione e aumentare le dimensioni del volume per la directory specificata

Edit-WKSSelfservicePermission -Region us-west-2 -ResourceId d-123454a369 -SelfservicePermissions_ChangeComputeType ENABLED -SelfservicePermissions_IncreaseVolumeSize ENABLED

Il seguente esempio di codice mostra come utilizzare. Edit-WKSWorkspaceAccessProperty

Strumenti per PowerShell

Esempio 1: questo esempio abilita l'accesso all'area di lavoro su Android e Chrome OS per la directory specificata

Edit-WKSWorkspaceAccessProperty -Region us-west-2 -ResourceId d-123454a369 -WorkspaceAccessProperties_DeviceTypeAndroid ALLOW -WorkspaceAccessProperties_DeviceTypeChromeOs ALLOW

Il seguente esempio di codice mostra come utilizzare. Edit-WKSWorkspaceCreationProperty

Strumenti per PowerShell

Esempio 1: questo esempio abilita l'accesso a Internet e la modalità di manutenzione su true come valori predefiniti durante la creazione di un'area di lavoro

Edit-WKSWorkspaceCreationProperty -Region us-west-2 -ResourceId d-123454a369 -WorkspaceCreationProperties_EnableInternetAccess $true -WorkspaceCreationProperties_EnableMaintenanceMode $true

Il seguente esempio di codice mostra come utilizzare. Edit-WKSWorkspaceProperty

Strumenti per PowerShell

Esempio 1: questo esempio modifica la proprietà Workspace Running Mode in Auto Stop per l'area di lavoro specificata

Edit-WKSWorkspaceProperty -WorkspaceId ws-w361s100v -Region us-west-2 -WorkspaceProperties_RunningMode AUTO_STOP

Il seguente esempio di codice mostra come utilizzare. Edit-WKSWorkspaceState

Strumenti per PowerShell

Esempio 1: questo esempio modifica lo stato dell'area di lavoro specificata in Disponibile

Edit-WKSWorkspaceState -WorkspaceId ws-w361s100v -Region us-west-2 -WorkspaceState AVAILABLE

Il seguente esempio di codice mostra come utilizzare. Get-WKSClientProperty

Strumenti per PowerShell

Esempio 1: Questo esempio ottiene le proprietà del client Workspace per la directory specificata

Get-WKSClientProperty -ResourceId d-223562a123

Il seguente esempio di codice mostra come utilizzare. Get-WKSIpGroup

Strumenti per PowerShell

Esempio 1: questo esempio ottiene i dettagli del gruppo IP specificato nella regione specificata

Get-WKSIpGroup -Region us-east-1 -GroupId wsipg-8m1234v45

Output:

GroupDesc GroupId GroupName UserRules --------- ------- --------- --------- wsipg-8m1234v45 TestGroup {Amazon.WorkSpaces.Model.IpRuleItem, Amazon.WorkSpaces.Model.IpRuleItem}
  • Per API i dettagli, vedere DescribeIpGroupsin AWS Tools for PowerShell Cmdlet Reference.

Il seguente esempio di codice mostra come utilizzare. Get-WKSTag

Strumenti per PowerShell

Esempio 1: questo esempio recupera il tag per l'area di lavoro specificata

Get-WKSTag -WorkspaceId ws-w361s234r -Region us-west-2

Output:

Key Value --- ----- auto-delete no purpose Workbench
  • Per API i dettagli, vedere DescribeTagsin AWS Tools for PowerShell Cmdlet Reference.

Il seguente esempio di codice mostra come utilizzare. Get-WKSWorkspace

Strumenti per PowerShell

Esempio 1: recupera i dettagli di tutti gli accessi WorkSpaces alla pipeline.

Get-WKSWorkspace

Output:

BundleId : wsb-1a2b3c4d ComputerName : DirectoryId : d-1a2b3c4d ErrorCode : ErrorMessage : IpAddress : RootVolumeEncryptionEnabled : False State : PENDING SubnetId : UserName : myuser UserVolumeEncryptionEnabled : False VolumeEncryptionKey : WorkspaceId : ws-1a2b3c4d WorkspaceProperties : Amazon.WorkSpaces.Model.WorkspaceProperties

Esempio 2: Questo comando mostra i valori delle proprietà secondarie di un'area WorkSpaceProperties di lavoro nella regione. us-west-2 Per ulteriori informazioni sulle proprietà secondarie diWorkSpaceProperties, vedete https://docs.aws.amazon.com/workspaces/ latest/api/API _ WorkspaceProperties .html.

(Get-WKSWorkspace -Region us-west-2 -WorkSpaceId ws-xdaf7hc9s).WorkspaceProperties

Output:

ComputeTypeName : STANDARD RootVolumeSizeGib : 80 RunningMode : AUTO_STOP RunningModeAutoStopTimeoutInMinutes : 60 UserVolumeSizeGib : 50

Esempio 3: questo comando mostra il valore della proprietà child RootVolumeSizeGib di WorkSpaceProperties per un'area di lavoro nella us-west-2 regione. La dimensione del volume root, in GiB, è 80.

(Get-WKSWorkspace -Region us-west-2 -WorkSpaceId ws-xdaf7hc9s).WorkspaceProperties.RootVolumeSizeGib

Output:

80
  • Per API i dettagli, vedere DescribeWorkspacesin AWS Tools for PowerShell Cmdlet Reference.

Il seguente esempio di codice mostra come utilizzare. Get-WKSWorkspaceBundle

Strumenti per PowerShell

Esempio 1: questo esempio recupera i dettagli di tutti i pacchetti Workspace nell'area corrente

Get-WKSWorkspaceBundle

Output:

BundleId : wsb-sfhdgv342 ComputeType : Amazon.WorkSpaces.Model.ComputeType Description : This bundle is custom ImageId : wsi-235aeqges LastUpdatedTime : 12/26/2019 06:44:07 Name : CustomBundleTest Owner : 233816212345 RootStorage : Amazon.WorkSpaces.Model.RootStorage UserStorage : Amazon.WorkSpaces.Model.UserStorage

Il seguente esempio di codice mostra come utilizzare. Get-WKSWorkspaceDirectory

Strumenti per PowerShell

Esempio 1: questo esempio elenca i dettagli delle directory registrate

Get-WKSWorkspaceDirectory

Output:

Alias : TestWorkspace CustomerUserName : Administrator DirectoryId : d-123414a369 DirectoryName : TestDirectory.com DirectoryType : MicrosoftAD DnsIpAddresses : {172.31.43.45, 172.31.2.97} IamRoleId : arn:aws:iam::761234567801:role/workspaces_RoleDefault IpGroupIds : {} RegistrationCode : WSpdx+4RRT43 SelfservicePermissions : Amazon.WorkSpaces.Model.SelfservicePermissions State : REGISTERED SubnetIds : {subnet-1m3m7b43, subnet-ard11aba} Tenancy : SHARED WorkspaceAccessProperties : Amazon.WorkSpaces.Model.WorkspaceAccessProperties WorkspaceCreationProperties : Amazon.WorkSpaces.Model.DefaultWorkspaceCreationProperties WorkspaceSecurityGroupId : sg-0ed2441234a123c43

Il seguente esempio di codice mostra come utilizzare. Get-WKSWorkspaceImage

Strumenti per PowerShell

Esempio 1: questo esempio recupera tutti i dettagli di tutte le immagini della regione

Get-WKSWorkspaceImage

Output:

Description :This image is copied from another image ErrorCode : ErrorMessage : ImageId : wsi-345ahdjgo Name : CopiedImageTest OperatingSystem : Amazon.WorkSpaces.Model.OperatingSystem RequiredTenancy : DEFAULT State : AVAILABLE

Il seguente esempio di codice mostra come utilizzare. Get-WKSWorkspaceSnapshot

Strumenti per PowerShell

Esempio 1: Questo esempio mostra il timestamp dell'istantanea più recente creata per l'area di lavoro specificata

Get-WKSWorkspaceSnapshot -WorkspaceId ws-w361s100v

Output:

RebuildSnapshots RestoreSnapshots ---------------- ---------------- {Amazon.WorkSpaces.Model.Snapshot} {Amazon.WorkSpaces.Model.Snapshot}

Il seguente esempio di codice mostra come utilizzare. Get-WKSWorkspacesConnectionStatus

Strumenti per PowerShell

Esempio 1: questo esempio recupera lo stato della connessione per l'area di lavoro specificata

Get-WKSWorkspacesConnectionStatus -WorkspaceId ws-w123s234r

Il seguente esempio di codice mostra come utilizzare. New-WKSIpGroup

Strumenti per PowerShell

Esempio 1: questo esempio crea un gruppo Ip vuoto denominato FreshEmptyIpGroup

New-WKSIpGroup -GroupName "FreshNewIPGroup"

Output:

wsipg-w45rty4ty
  • Per API i dettagli, vedere CreateIpGroupin AWS Tools for PowerShell Cmdlet Reference.

Il seguente esempio di codice mostra come utilizzare. New-WKSTag

Strumenti per PowerShell

Esempio 1: Questo esempio aggiunge un nuovo tag a un'area di lavoro denominataws-wsname. Il tag ha una chiave di «Nome» e un valore chiave diAWS_Workspace.

$tag = New-Object Amazon.WorkSpaces.Model.Tag $tag.Key = "Name" $tag.Value = "AWS_Workspace" New-WKSTag -Region us-west-2 -WorkspaceId ws-wsname -Tag $tag

Esempio 2: Questo esempio aggiunge più tag a un'area di lavoro denominataws-wsname. Un tag ha una chiave «Name» e un valore chiave diAWS_Workspace; l'altro tag ha una chiave di tag «Stage» e un valore chiave «Test».

$tag = New-Object Amazon.WorkSpaces.Model.Tag $tag.Key = "Name" $tag.Value = "AWS_Workspace" $tag2 = New-Object Amazon.WorkSpaces.Model.Tag $tag2.Key = "Stage" $tag2.Value = "Test" New-WKSTag -Region us-west-2 -WorkspaceId ws-wsname -Tag $tag,$tag2
  • Per API i dettagli, vedere CreateTagsin AWS Tools for PowerShell Cmdlet Reference.

Il seguente esempio di codice mostra come utilizzare. New-WKSWorkspace

Strumenti per PowerShell

Esempio 1: crea un file WorkSpace per il pacchetto, la directory e l'utente forniti.

New-WKSWorkspace -Workspace @{"BundleID" = "wsb-1a2b3c4d"; "DirectoryId" = "d-1a2b3c4d"; "UserName" = "USERNAME"}

Esempio 2: Questo esempio crea più WorkSpaces

New-WKSWorkspace -Workspace @{"BundleID" = "wsb-1a2b3c4d"; "DirectoryId" = "d-1a2b3c4d"; "UserName" = "USERNAME_1"},@{"BundleID" = "wsb-1a2b3c4d"; "DirectoryId" = "d-1a2b3c4d"; "UserName" = "USERNAME_2"}
  • Per API i dettagli, vedere CreateWorkspacesin AWS Tools for PowerShell Cmdlet Reference.

Il seguente esempio di codice mostra come utilizzare. Register-WKSIpGroup

Strumenti per PowerShell

Esempio 1: questo esempio registra il gruppo IP specificato nella directory specificata

Register-WKSIpGroup -GroupId wsipg-23ahsdres -DirectoryId d-123412e123
  • Per API i dettagli, vedere AssociateIpGroupsin AWS Tools for PowerShell Cmdlet Reference.

Il seguente esempio di codice mostra come utilizzare. Register-WKSWorkspaceDirectory

Strumenti per PowerShell

Esempio 1: questo esempio registra la directory specificata per il servizio Workspaces

Register-WKSWorkspaceDirectory -DirectoryId d-123412a123 -EnableWorkDoc $false

Il seguente esempio di codice mostra come utilizzare. Remove-WKSIpGroup

Strumenti per PowerShell

Esempio 1: questo esempio elimina il gruppo IP specificato

Remove-WKSIpGroup -GroupId wsipg-32fhgtred

Output:

Confirm Are you sure you want to perform this action? Performing the operation "Remove-WKSIpGroup (DeleteIpGroup)" on target "wsipg-32fhgtred". [Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): Y
  • Per API i dettagli, vedere DeleteIpGroupin AWS Tools for PowerShell Cmdlet Reference.

Il seguente esempio di codice mostra come utilizzare. Remove-WKSTag

Strumenti per PowerShell

Esempio 1: questo esempio rimuove il tag associato all'area di lavoro

Remove-WKSTag -ResourceId ws-w10b3abcd -TagKey "Type"

Output:

Confirm Are you sure you want to perform this action? Performing the operation "Remove-WKSTag (DeleteTags)" on target "ws-w10b3abcd". [Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): Y
  • Per API i dettagli, vedere DeleteTagsin AWS Tools for PowerShell Cmdlet Reference.

Il seguente esempio di codice mostra come utilizzare. Remove-WKSWorkspace

Strumenti per PowerShell

Esempio 1: termina più elementi WorkSpaces. L'uso dell'opzione -Force impedisce al cmdlet di richiedere la conferma.

Remove-WKSWorkspace -WorkspaceId "ws-1a2b3c4d5","ws-6a7b8c9d0" -Force

Esempio 2: recupera la raccolta di tutti i file WorkSpaces e reindirizza il WorkSpaceId parametro - IDs di Remove-WKSWorkspace, terminando tutti i file. WorkSpaces Il cmdlet verrà visualizzato prima che ciascuna di esse venga terminata. WorkSpace Per sopprimere la richiesta di conferma, aggiungere l'opzione -Force.

Get-WKSWorkspaces | Remove-WKSWorkspace

Esempio 3: Questo esempio mostra come passare TerminateRequest oggetti che definiscono l'oggetto WorkSpaces da terminare. Il cmdlet richiederà una conferma prima di procedere, a meno che non venga specificato anche il parametro -Force switch.

$arrRequest = @() $request1 = New-Object Amazon.WorkSpaces.Model.TerminateRequest $request1.WorkspaceId = 'ws-12345678' $arrRequest += $request1 $request2 = New-Object Amazon.WorkSpaces.Model.TerminateRequest $request2.WorkspaceId = 'ws-abcdefgh' $arrRequest += $request2 Remove-WKSWorkspace -Request $arrRequest

Il seguente esempio di codice mostra come utilizzare. Reset-WKSWorkspace

Strumenti per PowerShell

Esempio 1: ricostruisce ciò che è specificato. WorkSpace

Reset-WKSWorkspace -WorkspaceId "ws-1a2b3c4d"

Esempio 2: recupera la raccolta di tutti i dati WorkSpaces e invia il WorkSpaceId parametro - di Reset- IDs al parametro -WKSWorkspace, provocandone la ricostruzione WorkSpaces .

Get-WKSWorkspaces | Reset-WKSWorkspace
  • Per API i dettagli, vedere RebuildWorkspacesin AWS Tools for PowerShell Cmdlet Reference.

Il seguente esempio di codice mostra come utilizzare. Restart-WKSWorkspace

Strumenti per PowerShell

Esempio 1: riavvia il file specificato WorkSpace.

Restart-WKSWorkspace -WorkspaceId "ws-1a2b3c4d"

Esempio 2: riavvia più volte. WorkSpaces

Restart-WKSWorkspace -WorkspaceId "ws-1a2b3c4d","ws-5a6b7c8d"

Esempio 3: recupera la raccolta di tutti i WorkSpaces file e invia il IDs WorkSpaceId parametro - di Restart-WKSWorkspace, provocandone il WorkSpaces riavvio.

Get-WKSWorkspaces | Restart-WKSWorkspace
  • Per API i dettagli, vedere RebootWorkspacesin AWS Tools for PowerShell Cmdlet Reference.

Il seguente esempio di codice mostra come utilizzare. Stop-WKSWorkspace

Strumenti per PowerShell

Esempio 1: si ferma più volte WorkSpaces.

Stop-WKSWorkspace -WorkspaceId "ws-1a2b3c4d5","ws-6a7b8c9d0"

Esempio 2: recupera l'insieme di tutti i file WorkSpaces e invia il IDs WorkSpaceId parametro - di Stop- WorkSpaces al parametro - WKSWorkspace che causa l'interruzione.

Get-WKSWorkspaces | Stop-WKSWorkspace

Esempio 3: Questo esempio mostra come passare StopRequest oggetti che definiscono il punto WorkSpaces da fermare.

$arrRequest = @() $request1 = New-Object Amazon.WorkSpaces.Model.StopRequest $request1.WorkspaceId = 'ws-12345678' $arrRequest += $request1 $request2 = New-Object Amazon.WorkSpaces.Model.StopRequest $request2.WorkspaceId = 'ws-abcdefgh' $arrRequest += $request2 Stop-WKSWorkspace -Request $arrRequest
  • Per API i dettagli, vedere StopWorkspacesin AWS Tools for PowerShell Cmdlet Reference.

Il seguente esempio di codice mostra come utilizzare. Unregister-WKSIpGroup

Strumenti per PowerShell

Esempio 1: questo esempio annulla la registrazione del gruppo IP specificato dalla directory specificata

Unregister-WKSIpGroup -GroupId wsipg-12abcdphq -DirectoryId d-123454b123