Ci sono altri AWS SDK esempi disponibili nel repository AWS Doc SDK Examples
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
-
Per API i dettagli, vedere ModifyClientPropertiesin AWS Tools for PowerShell Cmdlet Reference.
-
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
-
Per API i dettagli, vedere ModifySelfservicePermissionsin AWS Tools for PowerShell Cmdlet Reference.
-
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
-
Per API i dettagli, vedere ModifyWorkspaceAccessPropertiesin AWS Tools for PowerShell Cmdlet Reference.
-
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
-
Per API i dettagli, vedere ModifyWorkspaceCreationPropertiesin AWS Tools for PowerShell Cmdlet Reference.
-
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
-
Per API i dettagli, vedere ModifyWorkspacePropertiesin AWS Tools for PowerShell Cmdlet Reference.
-
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
-
Per API i dettagli, vedere ModifyWorkspaceStatein AWS Tools for PowerShell Cmdlet Reference.
-
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
-
Per API i dettagli, vedere DescribeClientPropertiesin AWS Tools for PowerShell Cmdlet Reference.
-
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
diWorkSpaceProperties
per un'area di lavoro nellaus-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
-
Per API i dettagli, vedere DescribeWorkspaceBundlesin AWS Tools for PowerShell Cmdlet Reference.
-
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
-
Per API i dettagli, vedere DescribeWorkspaceDirectoriesin AWS Tools for PowerShell Cmdlet Reference.
-
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
-
Per API i dettagli, vedere DescribeWorkspaceImagesin AWS Tools for PowerShell Cmdlet Reference.
-
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}
-
Per i API dettagli, vedere DescribeWorkspaceSnapshotsin Cmdlet Reference.AWS Tools for PowerShell
-
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
-
Per API i dettagli, vedere DescribeWorkspacesConnectionStatusin AWS Tools for PowerShell Cmdlet Reference.
-
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 denominata
ws-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 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 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
-
Per API i dettagli, vedere RegisterWorkspaceDirectoryin AWS Tools for PowerShell Cmdlet Reference.
-
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
-
Per i API dettagli, vedere in Cmdlet Reference. TerminateWorkspacesAWS Tools for PowerShell
-
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
-
Per API i dettagli, vedere DisassociateIpGroupsin AWS Tools for PowerShell Cmdlet Reference.
-