È stata rilasciata la versione 5 (V5) di! AWS Strumenti per PowerShell
Per iniziare a utilizzare la nuova versione degli strumenti, consulta la Guida per l'AWS Strumenti per PowerShell utente (V5), in particolare l'argomento per la migrazione alla V5.
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 V4 PowerShell
I seguenti esempi di codice mostrano come eseguire azioni e implementare scenari comuni utilizzando AWS Strumenti per PowerShell V4 con. 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
Operazioni
Il seguente esempio di codice mostra come utilizzareApprove-WKSIpRule.
- Strumenti per PowerShell V4
-
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 i dettagli sull'API, vedere AuthorizeIpRulesin AWS Strumenti per PowerShell Cmdlet Reference (V4).
-
Il seguente esempio di codice mostra come utilizzare. Copy-WKSWorkspaceImage
- Strumenti per PowerShell V4
-
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-djfoedhw6Output:
wsi-456abaqfe-
Per i dettagli sull'API, vedere CopyWorkspaceImagein AWS Strumenti per PowerShell Cmdlet Reference (V4).
-
Il seguente esempio di codice mostra come utilizzare. Edit-WKSClientProperty
- Strumenti per PowerShell V4
-
Esempio 1: questo esempio abilita la riconnessione per il client Workspaces
Edit-WKSClientProperty -Region us-west-2 -ClientProperties_ReconnectEnabled "ENABLED" -ResourceId d-123414a369-
Per i dettagli sull'API, vedere ModifyClientPropertiesin AWS Strumenti per PowerShell Cmdlet Reference (V4).
-
Il seguente esempio di codice mostra come utilizzare. Edit-WKSSelfServicePermission
- Strumenti per PowerShell V4
-
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-
Per i dettagli sull'API, vedere ModifySelfservicePermissionsin AWS Strumenti per PowerShell Cmdlet Reference (V4).
-
Il seguente esempio di codice mostra come utilizzare. Edit-WKSWorkspaceAccessProperty
- Strumenti per PowerShell V4
-
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-
Per i dettagli sull'API, vedere ModifyWorkspaceAccessPropertiesin AWS Strumenti per PowerShell Cmdlet Reference (V4).
-
Il seguente esempio di codice mostra come utilizzare. Edit-WKSWorkspaceCreationProperty
- Strumenti per PowerShell V4
-
Esempio 1: questo esempio attiva 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-
Per i dettagli sull'API, vedere ModifyWorkspaceCreationPropertiesin AWS Strumenti per PowerShell Cmdlet Reference (V4).
-
Il seguente esempio di codice mostra come utilizzare. Edit-WKSWorkspaceProperty
- Strumenti per PowerShell V4
-
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-
Per i dettagli sull'API, vedere ModifyWorkspacePropertiesin AWS Strumenti per PowerShell Cmdlet Reference (V4).
-
Il seguente esempio di codice mostra come utilizzare. Edit-WKSWorkspaceState
- Strumenti per PowerShell V4
-
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-
Per i dettagli sull'API, vedere ModifyWorkspaceStatein AWS Strumenti per PowerShell Cmdlet Reference (V4).
-
Il seguente esempio di codice mostra come utilizzare. Get-WKSClientProperty
- Strumenti per PowerShell V4
-
Esempio 1: Questo esempio ottiene le proprietà del client Workspace per la directory specificata
Get-WKSClientProperty -ResourceId d-223562a123-
Per i dettagli sull'API, vedere DescribeClientPropertiesin AWS Strumenti per PowerShell Cmdlet Reference (V4).
-
Il seguente esempio di codice mostra come utilizzare. Get-WKSIpGroup
- Strumenti per PowerShell V4
-
Esempio 1: Questo esempio ottiene i dettagli del gruppo IP specificato nella regione specificata
Get-WKSIpGroup -Region us-east-1 -GroupId wsipg-8m1234v45Output:
GroupDesc GroupId GroupName UserRules --------- ------- --------- --------- wsipg-8m1234v45 TestGroup {Amazon.WorkSpaces.Model.IpRuleItem, Amazon.WorkSpaces.Model.IpRuleItem}-
Per i dettagli sull'API, vedere DescribeIpGroupsin AWS Strumenti per PowerShell Cmdlet Reference (V4).
-
Il seguente esempio di codice mostra come utilizzare. Get-WKSTag
- Strumenti per PowerShell V4
-
Esempio 1: questo esempio recupera il tag per l'area di lavoro specificata
Get-WKSTag -WorkspaceId ws-w361s234r -Region us-west-2Output:
Key Value --- ----- auto-delete no purpose Workbench-
Per i dettagli sull'API, vedere DescribeTagsin AWS Strumenti per PowerShell Cmdlet Reference (V4).
-
Il seguente esempio di codice mostra come utilizzare. Get-WKSWorkspace
- Strumenti per PowerShell V4
-
Esempio 1: recupera i dettagli di tutti gli accessi WorkSpaces alla pipeline.
Get-WKSWorkspaceOutput:
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.WorkspacePropertiesEsempio 2: Questo comando mostra i valori delle proprietà secondarie di un'area
WorkSpacePropertiesdi lavoro nella regione.us-west-2Per 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).WorkspacePropertiesOutput:
ComputeTypeName : STANDARD RootVolumeSizeGib : 80 RunningMode : AUTO_STOP RunningModeAutoStopTimeoutInMinutes : 60 UserVolumeSizeGib : 50Esempio 3: questo comando mostra il valore della proprietà child
RootVolumeSizeGibdiWorkSpacePropertiesper un'area di lavoro nellaus-west-2regione. La dimensione del volume root, in GiB, è 80.(Get-WKSWorkspace -Region us-west-2 -WorkSpaceId ws-xdaf7hc9s).WorkspaceProperties.RootVolumeSizeGibOutput:
80-
Per i dettagli sull'API, vedere DescribeWorkspacesin AWS Strumenti per PowerShell Cmdlet Reference (V4).
-
Il seguente esempio di codice mostra come utilizzare. Get-WKSWorkspaceBundle
- Strumenti per PowerShell V4
-
Esempio 1: questo esempio recupera i dettagli di tutti i pacchetti Workspace nella regione corrente
Get-WKSWorkspaceBundleOutput:
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-
Per i dettagli sull'API, vedere DescribeWorkspaceBundlesin AWS Strumenti per PowerShell Cmdlet Reference (V4).
-
Il seguente esempio di codice mostra come utilizzare. Get-WKSWorkspaceDirectory
- Strumenti per PowerShell V4
-
Esempio 1: questo esempio elenca i dettagli delle directory per le directory registrate
Get-WKSWorkspaceDirectoryOutput:
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-
Per i dettagli sull'API, vedere DescribeWorkspaceDirectoriesin AWS Strumenti per PowerShell Cmdlet Reference (V4).
-
Il seguente esempio di codice mostra come utilizzare. Get-WKSWorkspaceImage
- Strumenti per PowerShell V4
-
Esempio 1: questo esempio recupera tutti i dettagli di tutte le immagini della regione
Get-WKSWorkspaceImageOutput:
Description :This image is copied from another image ErrorCode : ErrorMessage : ImageId : wsi-345ahdjgo Name : CopiedImageTest OperatingSystem : Amazon.WorkSpaces.Model.OperatingSystem RequiredTenancy : DEFAULT State : AVAILABLE-
Per i dettagli sull'API, vedere DescribeWorkspaceImagesin AWS Strumenti per PowerShell Cmdlet Reference (V4).
-
Il seguente esempio di codice mostra come utilizzare. Get-WKSWorkspaceSnapshot
- Strumenti per PowerShell V4
-
Esempio 1: Questo esempio mostra il timestamp dell'istantanea più recente creata per l'area di lavoro specificata
Get-WKSWorkspaceSnapshot -WorkspaceId ws-w361s100vOutput:
RebuildSnapshots RestoreSnapshots ---------------- ---------------- {Amazon.WorkSpaces.Model.Snapshot} {Amazon.WorkSpaces.Model.Snapshot}-
Per i dettagli sull'API, vedere DescribeWorkspaceSnapshotsin AWS Strumenti per PowerShell Cmdlet Reference (V4).
-
Il seguente esempio di codice mostra come utilizzare. Get-WKSWorkspacesConnectionStatus
- Strumenti per PowerShell V4
-
Esempio 1: questo esempio recupera lo stato della connessione per l'area di lavoro specificata
Get-WKSWorkspacesConnectionStatus -WorkspaceId ws-w123s234r-
Per i dettagli sull'API, vedere DescribeWorkspacesConnectionStatusin AWS Strumenti per PowerShell Cmdlet Reference (V4).
-
Il seguente esempio di codice mostra come utilizzare. New-WKSIpGroup
- Strumenti per PowerShell V4
-
Esempio 1: Questo esempio crea un gruppo Ip vuoto denominato FreshEmptyIpGroup
New-WKSIpGroup -GroupName "FreshNewIPGroup"Output:
wsipg-w45rty4ty-
Per i dettagli sull'API, vedere CreateIpGroupin AWS Strumenti per PowerShell Cmdlet Reference (V4).
-
Il seguente esempio di codice mostra come utilizzare. New-WKSTag
- Strumenti per PowerShell V4
-
Esempio 1: Questo esempio aggiunge un nuovo tag a un'area di lavoro denominata.
ws-wsnameIl 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 $tagEsempio 2: Questo esempio aggiunge più tag a un'area di lavoro denominata
ws-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 i dettagli sull'API, vedere CreateTagsin AWS Strumenti per PowerShell Cmdlet Reference (V4).
-
Il seguente esempio di codice mostra come utilizzare. New-WKSWorkspace
- Strumenti per PowerShell V4
-
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 i dettagli sull'API, vedere CreateWorkspacesin AWS Strumenti per PowerShell Cmdlet Reference (V4).
-
Il seguente esempio di codice mostra come utilizzare. Register-WKSIpGroup
- Strumenti per PowerShell V4
-
Esempio 1: questo esempio registra il gruppo IP specificato nella directory specificata
Register-WKSIpGroup -GroupId wsipg-23ahsdres -DirectoryId d-123412e123-
Per i dettagli sull'API, vedere AssociateIpGroupsin AWS Strumenti per PowerShell Cmdlet Reference (V4).
-
Il seguente esempio di codice mostra come utilizzare. Register-WKSWorkspaceDirectory
- Strumenti per PowerShell V4
-
Esempio 1: questo esempio registra la directory specificata per Workspaces Service
Register-WKSWorkspaceDirectory -DirectoryId d-123412a123 -EnableWorkDoc $false-
Per i dettagli sull'API, vedere RegisterWorkspaceDirectoryin AWS Strumenti per PowerShell Cmdlet Reference (V4).
-
Il seguente esempio di codice mostra come utilizzare. Remove-WKSIpGroup
- Strumenti per PowerShell V4
-
Esempio 1: questo esempio elimina il gruppo IP specificato
Remove-WKSIpGroup -GroupId wsipg-32fhgtredOutput:
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 i dettagli sull'API, vedere DeleteIpGroupin AWS Strumenti per PowerShell Cmdlet Reference (V4).
-
Il seguente esempio di codice mostra come utilizzare. Remove-WKSTag
- Strumenti per PowerShell V4
-
Esempio 1: questo esempio rimuove il tag associato al Workspace
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 i dettagli sull'API, vedere DeleteTagsin AWS Strumenti per PowerShell Cmdlet Reference (V4).
-
Il seguente esempio di codice mostra come utilizzare. Remove-WKSWorkspace
- Strumenti per PowerShell V4
-
Esempio 1: termina più elementi WorkSpaces. L'uso dello switch -Force impedisce al cmdlet di richiedere la conferma.
Remove-WKSWorkspace -WorkspaceId "ws-1a2b3c4d5","ws-6a7b8c9d0" -ForceEsempio 2: recupera la raccolta di tutti i tuoi 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-WKSWorkspaceEsempio 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-
Per i dettagli sull'API, vedere TerminateWorkspacesin AWS Strumenti per PowerShell Cmdlet Reference (V4).
-
Il seguente esempio di codice mostra come utilizzare. Reset-WKSWorkspace
- Strumenti per PowerShell V4
-
Esempio 1: ricostruisce quanto 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 i dettagli sull'API, vedere RebuildWorkspacesin AWS Strumenti per PowerShell Cmdlet Reference (V4).
-
Il seguente esempio di codice mostra come utilizzare. Restart-WKSWorkspace
- Strumenti per PowerShell V4
-
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 i dettagli sull'API, vedere RebootWorkspacesin AWS Strumenti per PowerShell Cmdlet Reference (V4).
-
Il seguente esempio di codice mostra come utilizzare. Stop-WKSWorkspace
- Strumenti per PowerShell V4
-
Esempio 1: arresta 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-WKSWorkspaceEsempio 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 i dettagli sull'API, vedere StopWorkspacesin AWS Strumenti per PowerShell Cmdlet Reference (V4).
-
Il seguente esempio di codice mostra come utilizzare. Unregister-WKSIpGroup
- Strumenti per PowerShell V4
-
Esempio 1: Questo esempio annulla la registrazione del gruppo IP specificato dalla directory specificata
Unregister-WKSIpGroup -GroupId wsipg-12abcdphq -DirectoryId d-123454b123-
Per i dettagli sull'API, vedere DisassociateIpGroupsin AWS Strumenti per PowerShell Cmdlet Reference (V4).
-